Skip to content

Môi trường & triển khai ​

Năm môi trường ​

Môi trườngLà gìTrạng thái
localMáy từng người: PostgreSQL 17 native ở cổng 5433, Edge Function chạy bằng Deno. Không Dockerdùng hàng ngày
devProject Supabase — môi trường tích hợp chung cho các nhómđang chạy
stagingProject Supabase — QC kiểm thửđang chạy
uatProject Supabase — khách nghiệm thuđang dừng deploy (#487)
productionChưa được tạo—

Mọi môi trường cloud deploy từ cùng một thư mục supabase/ trong Git. Chỉ cấu hình, secret và dữ liệu khác nhau.

Vì production chưa tồn tại, mọi phát biểu về production trong tài liệu này là thiết kế dự kiến — xem Phạm vi & độ tin cậy.

Luồng promote ​

merge --no-ffdeploydeployfeature/*cắt từ masterdevstagingmasterproject devproject stagingproject uatKhông cherry-pick. Không squash. Nhánh môi trường không merge vào nhau.uat đang dừng deploy (nét đứt). production chưa được tạo.

Ba luật không được phá:

  • Nhánh cắt từ master, không cắt từ nhánh môi trường.
  • Không bao giờ cherry-pick, không bao giờ squash-merge. Đơn vị được promote là một nhánh, merge bằng --no-ff.
  • Nhánh môi trường không merge vào nhau. staging được dựng lại khi cần (cho phép force-push); dev và master thì không bao giờ force-push.

CI/CD ​

deploy-supabase.yml chạy khi có push vào nhánh môi trường:

  1. Migration trước, function sau. Thứ tự này quan trọng: function mới có thể cần cột mới, nhưng function cũ phải còn chạy được với schema mới.
  2. Dry run rồi mới apply migration. db push là điểm không quay lại — một lần chạy đã qua bước đó thì luôn chạy tới hết, kể cả khi có push mới hơn.
  3. Edge Function deploy từ bản đã strip. Function graphql vượt giới hạn 5 MB của Supabase, nên CI dựng một bản copy đã bỏ type, comment và khoảng trắng bằng esbuild (không rename, không bundle, giữ nguyên cấu trúc file) rồi deploy bản đó. Repo không bị đổi. Có gate kích thước 4 MiB và một phép thử nạp function trước khi db push.
  4. Đăng ký cron sau khi deploy. CI tự đăng ký cron pi-jobs-tick (gọi function jobs mỗi phút) mỗi lần deploy, không có công tắc bật/tắt. Trước đó nó kiểm tên các secret cần thiết đã tồn tại chưa và fail nếu thiếu.
  5. Lượt chạy cũ bị huỷ trước điểm không quay lại. Nhiều pull request chạy trên cùng vài runner, nên push mới hơn sẽ huỷ lượt cũ nếu lượt cũ chưa tới db push.

Giá trị secret do người vận hành đặt trực tiếp trong Edge Function secrets của project. CI không đọc được giá trị — nó chỉ liệt kê tên secret để kiểm thiếu đủ.

Web ​

Web Admin deploy lên AWS Amplify; cấu hình ở amplify.yml tại gốc repo. Giá trị theo môi trường qua Vite env, một file cho mỗi môi trường trong apps/web-admin/env/.

Tài liệu kỹ thuật này (web-document) cũng deploy lên Amplify, với mật khẩu cơ bản bật ở phần Access control của Amplify — xem Triển khai tài liệu.

Mobile ​

Mỗi app có hai flavor native, dev và staging, với bundle id riêng nên cài song song được. local và mock chạy trên flavor dev; không có flavor cho uat hay production.

Build chạy theo yêu cầu từ GitHub Actions (mobile-build.yml: chọn nhánh, môi trường, app, nền tảng). Android lên Google Play internal testing (AAB ký release, qua Play Developer API); iOS lên TestFlight. Mỗi nền tảng một đường phát hành duy nhất.

Trạng thái từng môi trường, tính tại thời điểm sinh tài liệu ​

  • uat đang dừng deploy.
  • PiPoint: ví chạy thật ở dev và staging; tắt ở uat và production. Nơi nào tắt thì mỗi điểm chạm PiPoint suy giảm thành một trạng thái tường minh có thể phát lại sau, chứ không được ném lỗi.
  • dev và staging đã chuyển lên Supabase Pro nên không còn bị tạm dừng vì không hoạt động; job keep-alive đã bỏ.
  • Vòng quay may mắn: migration của đợt này chưa deploy môi trường nào, và có rủi ro đã biết — API mới đổi hành vi phiên quay, nên nếu API lên trước khi app được ráp thì khách không quay được.

Runbook ​

Quy trình vận hành chi tiết nằm trong docs/technical/:

ViệcTài liệu
Sao lưu, phục hồi, đối chiếu sau phục hồi15-backup-restore-runbook.md
Danh mục cảnh báo, dashboard, xử lý từng cảnh báo16-alerts-dashboards-runbooks.md
Nhà cung cấp suy giảm (PiPoint, MoMo, scheduler)17-degraded-provider-playbook.md
Bootstrap cặp admin đầu tiên, break-glass14-rbac-operator-bootstrap.md
Chi tiết bản strip khi deploy function23-function-deploy-bundle.md

Nguồn: docs/technical/02-environment.md, 11-git-workflow.md, 18-ci-cd-supabase.md, 19-mobile-flavors-cicd.md, 23-function-deploy-bundle.md, amplify.yml. Trang viết tay — xem mức độ tin cậy.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17