Dunia C3: Lancar & Deploy

Misi capstone 3: Lancarkan

Anda akan belajar: beri Kedai Kancil staging, production, langkah canary dan job rollback, kemudian buktikan dengan release yang teruk.

Teks BM belum disemak oleh penutur asli.

Disemak dengan GitHub Actions 2026-10 pada 31 Okt 2026

Masalahnya

Pilih satu event. Tekan Run dan tengok tali sawat.

Tag v1.0.1: canary gagal smoke test, production dilangkau, dan rollback berjalan.

Apa yang berlaku di GitHub

Push tag v1.0.1

Fail workflow .github/workflows/release.yml

1name: Release
2on:
3  push:
4    tags: ['v*']
5permissions:
6  contents: read
7jobs:
8  canary:
9    runs-on: ubuntu-latest
10    environment: staging
11    steps:
12      - uses: actions/checkout@v7
13      - run: npm ci
14      - run: npx wrangler deploy --env staging
15        env:
16          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
17      - run: curl --fail --silent "$STAGING_URL/health"
18        env:
19          STAGING_URL: ${{ vars.STAGING_URL }}
20  production:
21    needs: canary
22    runs-on: ubuntu-latest
23    environment:
24      name: production
25      url: ${{ vars.SITE_URL }}
26    steps:
27      - uses: actions/checkout@v7
28      - run: npm ci
29      - run: npx wrangler deploy --env production
30        env:
31          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
32  rollback:
33    needs: canary
34    if: failure()
35    runs-on: ubuntu-latest
36    environment: staging
37    steps:
38      - uses: actions/checkout@v7
39      - run: npm ci
40      - run: npx wrangler rollback --env staging --message "Canary failed"
41        env:
42          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

Tali sawat

Push tag v1.0.1 · v1.0.1

Misi 3: Lancarkan. Kedai Kancil dah uji dan build dirinya sendiri. Sekarang jadikan release selamat. Matlamat anda: release teruk yang ditangkap dan diundur oleh pipeline. Run untuk lihat matlamatnya.

Cuba

Langkah 1: dua dapur. Bahagian depan web kedai anda masuk ke pelan Workers percuma Cloudflare. Tambah ini dalam wrangler.jsonc:

"account_id": "YOUR_ACCOUNT_ID",
"env": { "staging": {}, "production": {} }

Misi sebenar

Buat token API Cloudflare daripada templat "Edit Cloudflare Workers". Hadkan kepada satu akaun anda.
Pastikan laman yang dibina menjawab /health dengan ok. Fail health.html dalam folder build pun boleh.
Buat environment staging dalam repo anda.
gh api --method PUT "repos/{owner}/{repo}/environments/staging"
Buat production juga. Kemudian, dalam tetapannya, tambah diri anda sebagai penyemak wajib.
gh api --method PUT "repos/{owner}/{repo}/environments/production"
Simpan token dalam staging. Ia minta anda tampal nilainya.
gh secret set CLOUDFLARE_API_TOKEN --env staging
Simpan token dalam production juga.
gh secret set CLOUDFLARE_API_TOKEN --env production
Simpan alamat staging anda sebagai pemboleh ubah repo. Buat yang sama untuk SITE_URL.
gh variable set STAGING_URL --body "https://kedai-kancil-staging.YOUR-SUBDOMAIN.workers.dev"

0 daripada 7 langkah siap · Tanda anda disimpan.

Cuba

Langkah 2: bina release.yml. Canary dulu. Production selepasnya, dengan kelulusan anda. Rollback hanya kalau canary gagal.

Tekan blok untuk tambah. Susun ikut urutan.

Blok

Workflow anda

Tekan satu blok di atas untuk mula.

Fail workflow .github/workflows/

name: Release

Apa yang berjalan

Belum ada apa untuk dijalankan.

Cuba

Langkah 3: hantar satu release yang elok, kemudian satu yang teruk dengan sengaja.

Misi sebenar

Commit workflow itu dan push.
git add .github/workflows/release.yml && git commit -m "ci: add release workflow" && git push
Hantar release yang elok: buat tag v1.0.0 dan push.
git tag v1.0.0 && git push origin v1.0.0
Canary lulus. Production menunggu. Buka larian itu dan luluskan.
Rosakkan dengan sengaja: padam halaman health, kemudian commit dan push.
Tag release yang teruk dan push tag itu.
git tag v1.0.1 && git push origin v1.0.1
Perhati larian: canary merah, production dilangkau, rollback hijau.
Pulangkan halaman health, kemudian hantar v1.0.2 dengan cara sama.

0 daripada 7 langkah siap · Tanda anda disimpan.

Semak

Biar API awam GitHub sahkan. Taip nama pengguna anda, kemudian semak.

Semak di GitHub

Repo Kedai Kancil anda awamBelum disemak
Workflow berjalan sekurang-kurangnya 3 kaliBelum disemak
Ada sekurang-kurangnya 2 tag releaseBelum disemak

Semak

API tak boleh tengok dalam larian. Semak yang ini sendiri.

Misi sebenar

Larian v1.0.1 tunjuk: canary gagal, production dilangkau, rollback lulus.
Halaman /health staging anda kata ok semula.
Production tak pernah dapat v1.0.1.
Production tunggu kelulusan anda untuk v1.0.0.

0 daripada 4 langkah siap · Tanda anda disimpan.

Anda berjaya!

Kini anda boleh lancarkan Kedai Kancil dengan selamat, dengan butang undur.

Nak tahu lebih (pilihan)

Keselamatan: pelan Workers percuma dah cukup di sini. Containers untuk API perlukan Workers Paid. Tetapkan amaran bajet dulu. Guna token ujian dan padam bila selesai. Canary ini ialah salinan staging. Canary sebenar hantar sebahagian pengguna sebenar. Di Cloudflare, itu gradual deployment.