kumoripublic/examples-hello-world-frontend

Kumori PaaS 'hello-world'示例前端镜像

1. 镜像概述

本镜像为Kumori PaaS平台的官方示例前端镜像，基于经典的'hello-world'场景构建，旨在演示基础前端应用在Kumori PaaS上的部署流程和运行机制。通过该镜像，用户可快速了解Kumori PaaS对前端应用的托管能力，包括环境适配、资源调度及基础运行时支持，适合作为接触Kumori PaaS的入门示例。

2. 核心功能与特性

• 轻量级设计：基于精简前端基础镜像构建，镜像体积小，部署速度快，资源占用低
• 即开即用：无需复杂配置，通过简单命令即可完成部署，降低入门门槛
• 演示性强：完整展示基础前端应用（HTML/CSS/JS）的结构与PaaS平台集成方式
• 标准化集成：严格遵循Kumori PaaS的应用部署规范，兼容平台标准生命周期管理
• 透明化流程：镜像构建流程和运行逻辑清晰，便于用户理解前端应用在PaaS上的部署细节

3. 适用场景

• Kumori PaaS初学者：快速上手并实践前端应用在PaaS平台的部署流程
• 平台功能验证：测试Kumori PaaS基础前端托管能力，验证环境可用性
• 教学演示：作为培训材料，演示简单前端应用从构建到部署的完整链路
• 基础架构测试：用于验证前端应用与Kumori PaaS网络、存储等基础组件的兼容性

4. 使用方法

4.1 前提条件

• 已安装Docker引擎（推荐20.10+版本）
• 已配置Kumori PaaS环境（含CLI工具及访问权限，如适用）

4.2 获取镜像

通过Docker命令拉取镜像（假设镜像仓库为Kumori官方仓库）：

bash
docker pull kumori/hello-world-frontend:latest

4.3 本地运行（非PaaS环境测试）

可通过Docker本地运行镜像，验证应用功能：

bash
docker run -d -p 8080:80 --name hello-world-frontend kumori/hello-world-frontend:latest

运行后，访问http://localhost:8080即可看到hello-world前端页面。

4.4 Kumori PaaS部署（推荐方式）

通过Kumori CLI部署至PaaS平台：

1. 登录Kumori PaaS：

   bash
   kumori login
   

2. 部署应用：

   bash
   kumori deploy --image kumori/hello-world-frontend:latest --app-name hello-world-frontend
   

3. 获取访问地址：

   bash
   kumori get app hello-world-frontend --output json | jq -r '.status.url'
   

   通过返回的URL即可访问部署在Kumori PaaS上的前端应用。

5. 配置说明

5.1 环境变量

• PORT：前端应用监听端口，默认值为80，可通过环境变量修改

  bash
  docker run -d -p 8081:8081 -e PORT=8081 kumori/hello-world-frontend:latest
  

5.2 端口映射

镜像默认暴露80端口（或通过PORT变量指定的端口），部署时需确保PaaS平台或Docker环境正确映射该端口。

6. 注意事项

• 本镜像为示例性质，仅用于学习和演示Kumori PaaS前端部署流程，不建议用于生产环境
• 如需构建自定义前端应用，请参考Kumori PaaS官方文档的前端应用开发规范
• 镜像版本更新可能导致功能变化，建议使用指定版本标签（如:v1.0）而非:latest以确保稳定性