GitHub Action

让仓库推送触发部署。

appaloft/deploy-action 会安装并校验 Appaloft CLI，映射 GitHub Secrets，然后调用已有 Appaloft 部署路径。

入口

GitHub Actions

默认

Pure SSH BYOS

Preview

显式 workflow

GitHub App

control-plane owned

最小部署 workflow

name: Deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: appaloft/deploy-action@v1
        with:
          config: appaloft.yml
          ssh-host: ${{ secrets.APPALOFT_SSH_HOST }}
          ssh-user: ${{ secrets.APPALOFT_SSH_USER }}
          ssh-private-key: ${{ secrets.APPALOFT_SSH_PRIVATE_KEY }}

内容对齐

同步自 public deploy-action 计划、PR preview workflow spec 与 Cloud 自部署 runbook。

push 部署和 PR preview 都需要用户显式写 workflow

Pure SSH Action 默认适合 BYOS，无需预备 Cloud 控制台 id

Self-hosted Server Action 则由 Appaloft server/API 拥有状态和 source-link

三种模式

Pure SSH Action 运行 CLI 并把状态放在目标服务器；Self-hosted Server Action 调用控制面 API；Product-grade Preview 由 Cloud 或自托管控制面拥有 preview policy、评论、checks、清理和审计。

凭据模型

SSH key、token 和 secret 都来自 GitHub Secrets 或受信任环境。workflow 可以列 secret 名称，但不能打印 secret 值。

PR preview

Action 在 workflow 订阅 pull_request 事件时运行。close cleanup 走单独的 close-event workflow，preview 成功后不会自动重试。

部署流程

Checkout

GitHub Actions 检出仓库或 PR SHA。

Run action

deploy-action 安装 CLI 或调用 self-hosted server API。

Emit status

返回 deployment status、preview URL 和后续诊断入口。