deploy-trigger

部署触发链路

reconcile Step 7 / Step 8 用。

链路总览

git push -> GitHub Actions deploy.yml -> docker build -> push GHCR (rolling tag + sha tag)
                                              ↓
                              PATCH /applications/$APP_UUID/envs IMAGE_REF=ghcr.io/<org>/<repo>:sha-<commit>
                                              ↓
                                     curl POST $BASE/api/v1/deploy?uuid=<application-uuid>
                                              ↓
                              Coolify (Application + dockercompose) 读取 IMAGE_REF -> pull immutable sha tag -> up

Coolify Application 创建时 is_auto_deploy_enabled=false——GitHub push 不触发 Coolify 自动部署, 触发权完全归 GHA workflow。即便 Coolify GitHub App integration 会订阅 GitHub push webhook, 因为 auto_deploy 关了, Coolify 收到 push 也不动。

GitHub 端配置（reconcile Step 5I）

Repo-level secrets

# strip 尾斜杠防 //api 404
gh secret set COOLIFY_API_TOKEN --body "$COOLIFY_API_TOKEN"
gh secret set COOLIFY_BASE_URL  --body "${BASE%/}"

注意命令字符串里只能引用 $COOLIFY_API_TOKEN，不能把 token 原文写进去——shell 展开发生在执行时，命令字符串本身（agent 写给 Bash tool 的字符串）必须保持 $VAR 不变。

校验是否已设：

gh secret list | grep -E '^COOLIFY_API_TOKEN|^COOLIFY_BASE_URL'

自动建 environment（gh api 直通 REST API）

gh CLI 子命令没有 create environment，但 REST API 支持。reconcile Step 5I 用：

gh api -X PUT "repos/$REPO_ORG/$REPO_NAME/environments/$DEFAULT_BRANCH" >/dev/null

• 是 PUT 不是 POST — idempotent，已存在不报错
• 空 body 即可（不需要配 reviewers / wait_timer 之类）
• 需要 token 有 repo scope + admin permission（preflight Step 0 check 过）

GitHub REST API 文档。

Environment-level vars（每个部署分支一个同名 environment）

默认分支（如 main）：

gh variable set COOLIFY_APP_UUID       --env main --body "<application-uuid>"
gh variable set IMAGE_TAG_ROLLING      --env main --body "latest"
# IMAGE_TAG_SHA_PREFIX 可省略；deploy.yml.template 默认使用 sha-，避免 GitHub env var 空值 422。
# 如要显式配置，也必须非空：
gh variable set IMAGE_TAG_SHA_PREFIX   --env main --body "sha-"