docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]

This commit is contained in:
2026-11-16 17:52:11 +08:00
parent 30829eeb86
commit 1090591503
123 changed files with 1279 additions and 3 deletions
+5
View File
@@ -1,8 +1,10 @@
# 分支推送和 PR 检查:格式/编译、隔离数据库回归、固定版本 headless 客户端以及 HTTP smoke。
name: Foundry Go checks
on: [push, pull_request]
jobs:
check:
# 所有构建在此远程 runner 执行;脚本中的 Docker 挂载路径也基于它的工作区。
runs-on: ces-control
# Cold toolchain installation can exceed ten minutes on the existing runner.
timeout-minutes: 30
@@ -18,6 +20,7 @@ jobs:
test -z "$(gofmt -l cmd internal)"
go test -mod=readonly ./...
go build -mod=readonly -o bin/foundry ./cmd/foundry
# 仅 push 可使用已配置秘密做占位码探测,不能替代真实用户 OAuth 登录。
- name: Check Slack OAuth configuration and endpoint
if: gitea.event_name == 'push'
env:
@@ -69,6 +72,7 @@ jobs:
print("Negative control result:", control if control in known else "unclassified")
sys.exit("Slack client preflight could not verify the configured credentials")
PYSLACK
# 固定客户端提交避免服务端回归随外部默认分支漂移,下载不使用用户本机凭据。
- name: Fetch pinned headless HTTP integration client
env:
HEADLESS_CLIENT_REVISION: dcbbdad25de7c3b1d6bee317df6074da2c0642eb
@@ -82,6 +86,7 @@ jobs:
printf 'Pinned Endoleap client: %s\n' "$HEADLESS_CLIENT_REVISION"
- name: Verify schema migration and real headless HTTP client in an isolated database
run: HEADLESS_CLIENT_SOURCE="$PWD/.headless-client" bash deploy/check-schema.sh
# smoke 不依赖可连接数据库:healthz 只检查进程,缺 bearer 的 me 必须先返回 401。
- name: Smoke test HTTP routes
env:
PUBLIC_ORIGIN: https://api.example.com
+4
View File
@@ -1,3 +1,4 @@
# 仅 main 的相关路径变更触发发布;工作分支验证不应运行此生产切换。
name: Deploy Foundry Core
on:
push:
@@ -11,6 +12,7 @@ on:
- 'db/**'
- '.gitea/workflows/deploy.yml'
# 发布串行排队且不取消正在进行的路由/数据库操作。
concurrency:
group: foundry-core-main-deploy
cancel-in-progress: false
@@ -26,12 +28,14 @@ jobs:
with:
go-version-file: go.mod
cache: false
# 在远程 runner 生成无 CGO 二进制,供只读 slim 容器执行。
- name: Verify and build
run: |
set -eu
test -z "$(gofmt -l cmd internal)"
go test -mod=readonly ./...
CGO_ENABLED=0 go build -mod=readonly -o bin/foundry ./cmd/foundry
# secrets 仅注入进程环境,项目/引导 JSON 来自 Actions Variables,release 再检查内容。
- name: Deploy and verify backend readiness
env:
GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}