simple-service-app

name	simple-service-app
description	在 containers 仓库创建无后端轻量前端应用，并串起 home-ops GitOps 部署流程。Use when 用户要求创建简单应用、轻量前端服务、小工具、展示页、SPA、simple-service，或提到“复制模板到 apps 并部署”。

Simple Service App

触发场景

用户要求创建无后端、单一目的的前端应用时使用：简单应用、小工具、展示页、SPA、simple-service。

如果需求包含后端 API、数据库、PVC、复杂认证或长期状态存储，先指出它不属于 simple-service，再确认是否仍按轻量前端服务处理。

总流程

1. 在 containers 仓库复制模板到 apps/simple-<service-name>/；simple-service 应用统一使用 simple- 前缀。
2. 清理模板占位内容，只保留当前服务需要的代码、文案和配置。
3. 本地验证：npm build、Docker build、Docker 预览/health check。
4. 启动本地 Docker 预览后停下，让用户审阅页面；用户确认后再继续 home-ops。
5. 提交并推送 containers，等待 CI 产出镜像。
6. 在 home-ops 添加 GitOps 部署资源，注册到 k8s/apps/common/simple-service/ks.yaml。
7. 运行 kustomize 渲染验证，并告诉用户线上链接：https://simple-<service-name>.${MAIN_DOMAIN}。

containers 创建步骤

cp -r templates/simple-service apps/simple-<service-name>

随后必须更新：

• apps/simple-<service-name>/docker-bake.hcl：APP 改为 simple-<service-name>。
• apps/simple-<service-name>/package.json：name 改为 simple-<service-name>。
• apps/simple-<service-name>/index.html：更新 <title> 和 meta description。
• apps/simple-<service-name>/src/App.tsx：删除 starter UI，替换为当前服务界面。
• apps/simple-<service-name>/AGENTS.md：删除模板创建流程等临时内容，只保留该服务长期规则。

containers 本地验证

在 apps/simple-<service-name>/：

npm ci
npm run build
npm run docker:build
npm run docker:smoke

启动给用户审阅的本地预览：

docker rm -f simple-<service-name>-preview >/dev/null 2>&1 || true
npm run docker:build
docker run --rm -d --name simple-<service-name>-preview -p 18080:8080 simple-<service-name>:local
curl -fsS http://127.0.0.1:18080/healthz

预览地址：http://127.0.0.1:18080

home-ops 部署步骤

新增：

k8s/apps/common/simple-service/simple-<service-name>/
├── kustomization.yaml
└── helmrelease.yaml

部署约定：

• 使用现有 app-template HelmRelease 模式。
• 镜像使用 docker-bake.hcl 里的 semver；CI 出 digest 后再固定为 semver@digest，不使用 rolling 部署。
• 容器端口使用模板 Nginx 的 8080。
• route hostname 使用独立子域名。
• 不需要后端、密钥、PVC 时，不创建无关资源。
• Pod securityContext 沿用 common 普通 app 约定：runAsNonRoot: true、runAsUser/runAsGroup/fsGroup: 1000、fsGroupChangePolicy: OnRootMismatch。

验证：

kustomize build k8s/apps/common/simple-service/simple-<service-name>
kustomize build k8s/apps/common
kustomize build k8s/apps/staging