ci: move both pipelines to GitHub Actions (spec-v6)

GitHub becomes the primary repository host; the site keeps its VPS + nginx + Dockge host, the three-job pipeline and the same concurrency, so what moves is the CI host and the write-path target. .github/workflows/{deploy,deploy-infra}.yml are ports of the Gitea files with permissions: contents: read on every job. .gitea/workflows/ stays until the first green GitHub run (D9); its infra test step carries the new template variable names because the template it validates is the one this repository now ships.

The write-path values are renamed GITEA_TOKEN / GITEA_CONTENTS_API -> CONTENT_API_TOKEN / CONTENT_API_BASE and the upstream header becomes Bearer — in nginx.conf, in the compose envsubst filter and in the dev proxy, so dev and production send the identical header (D4). draft.ts learns GitHub's answer to a stale blob sha (409) while keeping the 422 "does not match" and 412 legs; smoke-draft.ts check 14 drives a stubbed proxy that answers 409 with GitHub's body and asserts the conflict refreshes the base, keeps the draft and never stops the save sequence.

Both workflows read the stack directory and the compose service / container name from the STACK_DIR and CONTAINER_NAME repository variables instead of hard-coding them, and each job refuses a missing, relative, trailing-slash or compose-disagreeing value in its first step, before any artifact download or rsync reaches the VPS (D15).

Verified: tsc -b and oxlint pass with no new warnings; validate:content, smoke-draft (14 checks) and smoke-generated-ids (7 checks) pass; both workflows parse, every run/script block passes bash -n with the variables substituted, and the guard refuses every bad value against the real compose.yaml. Owner-side variables, secrets, the write token and the VPS config rewrite stay open in spec-v6 §6.
This commit is contained in:
dong.nguyen committed 2026-10-26 20:49:34 +07:00
1 parent 1cfeda7987
commit cff981c5f3
15 files changed
+568 -83

No files matched your search

+145
View File
@@ -0,0 +1,145 @@
name: Redeploy Nginx
# Infra files only (spec-v4-deploy-infra D1): a change to the nginx template,
# the compose definition, or the Basic-auth file redeploys the container —
# content commits never do. workflow_dispatch is the token-rotation runbook.
on:
push:
branches:
- feature/github-migration
paths:
- nginx.conf
- compose.yaml
- deploy/htpasswd
workflow_dispatch:
concurrency:
group: deploy-infra
cancel-in-progress: false
jobs:
redeploy:
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@v7
# The stack directory and the container name are the server's deployment layout,
# not repository content: both come from repository variables (spec-v6 D15), and
# STACK_DIR is the same value `deploy.yml` uses. A missing STACK_DIR would rsync
# the three infra files into the remote user's home and then run docker in the
# wrong place; a CONTAINER_NAME that disagrees with the service this repository
# ships would recreate nothing and probe a container that does not exist. Both are
# refused here — before any rsync, before anything reaches the server.
- name: Check stack variables
env:
STACK_DIR: ${{ vars.STACK_DIR }}
CONTAINER_NAME: ${{ vars.CONTAINER_NAME }}
run: |
case "$STACK_DIR" in
/*) ;;
*)
echo "::error::STACK_DIR is not an absolute path — add it as a repository variable (Settings → Secrets and variables → Variables), value: the Dockge stack directory, e.g. /opt/stacks/dong-site"
exit 1
;;
esac
case "$STACK_DIR" in
*/)
echo "::error::STACK_DIR must not end with / — this job appends the slashes it needs"
exit 1
;;
esac
# The name is used twice over: as the compose service to recreate, and as the
# docker target of the health probe. compose.yaml — this repository — declares
# both, so the variable is checked against the file it has to agree with.
if ! grep -qE "^ ${CONTAINER_NAME}:" compose.yaml; then
echo "::error::CONTAINER_NAME is not a service in compose.yaml — the recreate step names a compose service, so the two must match"
exit 1
fi
if ! grep -qF "container_name: ${CONTAINER_NAME}" compose.yaml; then
echo "::error::CONTAINER_NAME does not match container_name in compose.yaml — docker exec and docker logs target that name"
exit 1
fi
echo "Stack: $STACK_DIR, container: $CONTAINER_NAME"
# Ship exactly the three triggered files. Never .env, never secrets/ (D6).
# The action builds the rsync source as "$GITHUB_WORKSPACE/$path" and passes
# it as one argument (entrypoint.sh) — so NO --relative: -R mirrors the whole
# absolute workspace path onto the server (run 2026-10-23 created
# dong-site/workspace/dong.nguyen/cv/… on the VPS). Plain -avz lands each
# file's basename in remote_path; the htpasswd step names deploy/ itself.
- name: Sync nginx.conf
uses: burnett01/rsync-deployments@v9
with:
switches: -avz
path: nginx.conf
remote_path: ${{ vars.STACK_DIR }}/
remote_host: ${{ secrets.DEPLOY_HOST }}
remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
remote_user: ${{ secrets.DEPLOY_USER }}
remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}
- name: Sync compose.yaml
uses: burnett01/rsync-deployments@v9
with:
switches: -avz
path: compose.yaml
remote_path: ${{ vars.STACK_DIR }}/
remote_host: ${{ secrets.DEPLOY_HOST }}
remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
remote_user: ${{ secrets.DEPLOY_USER }}
remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}
- name: Sync deploy/htpasswd
uses: burnett01/rsync-deployments@v9
with:
switches: -avz
path: deploy/htpasswd
remote_path: ${{ vars.STACK_DIR }}/deploy/
remote_host: ${{ secrets.DEPLOY_HOST }}
remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
remote_user: ${{ secrets.DEPLOY_USER }}
remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}
# Test-before-touch (D3): the throwaway container runs the same entrypoint
# render pipeline as production, with placeholder values — nginx -t checks
# syntax only, so the real token never enters this container or the job.
# A failure here fails the job; the live container keeps serving.
# The placeholder must be a resolvable literal IP: a literal hostname in
# proxy_pass IS resolved while the config is parsed (spec-v4-deploy-infra §4).
- name: Test new config
uses: appleboy/ssh-action@v1.2.0
with:
host: ${{ secrets.DEPLOY_HOST }}
port: ${{ secrets.DEPLOY_SSH_PORT }}
username: ${{ secrets.DEPLOY_USER }}
key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}
script: |
cd "${{ vars.STACK_DIR }}"
docker run --rm \
-v "$PWD/nginx.conf:/etc/nginx/templates/default.conf.template:ro" \
-v "$PWD/deploy/htpasswd:/etc/nginx/htpasswd:ro" \
-e CONTENT_API_TOKEN=placeholder \
-e CONTENT_API_BASE=http://127.0.0.1:1 \
-e 'NGINX_ENVSUBST_FILTER=CONTENT_API_TOKEN|CONTENT_API_BASE' \
nginx:alpine nginx -t
# Apply + verify (D4): recreate is the same command the Dockge deploy
# button runs, with the service/container names from CONTAINER_NAME — already
# checked against compose.yaml above. The health probe uses wget because
# nginx:alpine carries no curl; on failure the job prints the container log and
# fails.
- name: Recreate and probe
uses: appleboy/ssh-action@v1.2.0
with:
host: ${{ secrets.DEPLOY_HOST }}
port: ${{ secrets.DEPLOY_SSH_PORT }}
username: ${{ secrets.DEPLOY_USER }}
key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}
script: |
cd "${{ vars.STACK_DIR }}"
docker compose up -d --force-recreate "${{ vars.CONTAINER_NAME }}"
sleep 2
if ! docker exec "${{ vars.CONTAINER_NAME }}" wget -q -O /dev/null http://127.0.0.1/; then
docker logs --tail 50 "${{ vars.CONTAINER_NAME }}"
exit 1
fi
docker exec "${{ vars.CONTAINER_NAME }}" nginx -t
+141
View File
@@ -0,0 +1,141 @@
name: Deploy Static Site
on:
push:
branches:
- feature/github-migration
concurrency:
group: deploy
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
permissions:
contents: read
# Site identity (spec-v4-deploy-infra D10/D12, spec-v6 D3): the build and the
# resume generator derive every published URL and the page title from these two
# values; the build fails loudly when either is missing. They are repository
# variables — public values, not secrets.
env:
SITE_URL: ${{ vars.SITE_URL }}
SITE_NAME: ${{ vars.SITE_NAME }}
steps:
- uses: actions/checkout@v7
- uses: pnpm/setup@v3
with:
cache: true
version: ^12.0.0
runtime: node@24
- run: pnpm tsx scripts/validate-content.ts
- run: pnpm build
- uses: actions/upload-artifact@v7
with:
name: static-site
path: dist/
retention-days: 5
generate-resume:
runs-on: ubuntu-latest
needs: build
permissions:
contents: read
env:
SITE_URL: ${{ vars.SITE_URL }}
SITE_NAME: ${{ vars.SITE_NAME }}
steps:
- uses: actions/checkout@v7
- uses: pnpm/setup@v3
with:
cache: true
version: ^12.0.0
runtime: node@24
# Cache Playwright browser — download once, reuse
- name: Cache Playwright browser
uses: actions/cache@v4
with:
path: ~/.cache/ms-playwright
key: playwright-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}
restore-keys: |
playwright-${{ runner.os }}-
- run: pnpm install --frozen-lockfile
- run: npx playwright install chromium
- run: npx playwright install-deps chromium
# Generate English version (default)
- run: pnpm tsx scripts/generate-resume.ts --lang=en
# Generate Vietnamese version
- run: pnpm tsx scripts/generate-resume.ts --lang=vi
# Upload both PDF artifacts
- uses: actions/upload-artifact@v7
with:
name: resume-pdf-en
path: dist/resume.pdf
retention-days: 1
- uses: actions/upload-artifact@v7
with:
name: resume-pdf-vi
path: dist/resume-vi.pdf
retention-days: 1
deploy:
runs-on: ubuntu-latest
needs: [build, generate-resume]
permissions:
contents: read
steps:
# The stack directory is the server's deployment layout, not repository
# content: it comes from the STACK_DIR repository variable (spec-v6 D15). An
# empty or malformed value would aim rsync at /dist/ on the remote host, so the
# job refuses it here — before any artifact download, before anything reaches the
# server — exactly like the site-identity check refuses a missing SITE_URL.
- name: Check stack directory
env:
STACK_DIR: ${{ vars.STACK_DIR }}
run: |
case "$STACK_DIR" in
/*) ;;
*)
echo "::error::STACK_DIR is not an absolute path — add it as a repository variable (Settings → Secrets and variables → Variables), value: the Dockge stack directory, e.g. /opt/stacks/dong-site"
exit 1
;;
esac
case "$STACK_DIR" in
*/)
echo "::error::STACK_DIR must not end with / — this job appends /dist/ itself"
exit 1
;;
esac
echo "Deploy target: $STACK_DIR/dist/"
- uses: actions/download-artifact@v8
with:
name: static-site
path: dist/
- uses: actions/download-artifact@v8
with:
name: resume-pdf-en
path: dist/
- uses: actions/download-artifact@v8
with:
name: resume-pdf-vi
path: dist/
- name: rsync deployments
uses: burnett01/rsync-deployments@v9
with:
debug: true
switches: -avzr --delete
path: dist/
remote_path: ${{ vars.STACK_DIR }}/dist/
remote_host: ${{ secrets.DEPLOY_HOST }}
remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
remote_user: ${{ secrets.DEPLOY_USER }}
remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}