Bỏ qua đến nội dung
ShopNexus Docs
Trên trang này Từ git push tới pod 1/4

Server, website, tài liệu và console chạy trên một cluster k3d, chia thành hai stack là dev và prod. Mỗi stack có namespace riêng và có Postgres, Restate, RustFS và hub AI (ai-gateway và ai-models, từ repo ai) của riêng nó. Mọi thứ cluster cần đều nằm trong infra/ ở repo tổng. App Android được build và cài bằng Gradle, không thuộc cluster.

StackTên miềnNamespaceTheo dõi
devdev.shopnexus.id.vnshopnexus-dev:main, theo digest
prodshopnexus.id.vnshopnexus-prodmột bản phát hành của repo tổng, vX.Y.Z

Mỗi stack phục vụ website trên tên miền của nó và bốn host bên dưới: api. cho server, media. cho object store, docs. cho tài liệu và console. cho console.

Hệ thống đã được build và kiểm tra trên một cluster k3d chạy cục bộ. Việc dựng nó trên server của tác giả và chạy các bài diễn tập failover là bước tiếp theo, nên các host public ở trên chưa hoạt động.

Từ git push tới pod

flowchart TB
  push[git push lên main] --> ci[GitHub Actions build.yml]
  ci --> ghcr["GHCR ghcr.io/shopnexus/*<br/>:main và sha-#lt;commit#gt;"]
  ghcr --> iu[Argo CD Image Updater]
  iu --> argo[Argo CD]
  rel["release.yml của repo tổng<br/>X.Y.Z, tag vX.Y.Z"] --> argo
  argo --> devns[shopnexus-dev]
  argo --> prodns[shopnexus-prod]
  devns --> traefik[Traefik]
  prodns --> traefik
Từ git push tới pod đang chạy

Repo của từng thành phần (server, website, docs, console) có một file .github/workflows/build.yml. Mỗi lần push lên main, workflow build image rồi đẩy lên GHCR với hai tag main và sha-<commit>. Khi phát hành lên prod, workflow Release của repo tổng thêm tag X.Y.Z vào image sha-<commit> của các commit mà submodule của nó trỏ tới. Các package để public, vì cluster kéo image về mà không có credential.

Argo CD Image Updater theo dõi GHCR cho dev. Nó theo digest của :main, ghi tag mới thành một tham số Helm trên stack-dev, rồi Argo CD sync chart trong infra/stack vào shopnexus-dev. Prod không dùng Image Updater: workflow Release ghi phiên bản vào infra/ và gắn tag vX.Y.Z cho repo tổng, rồi stack-prod render infra/stack ở tag đó. CI không bao giờ kết nối tới cluster. Traefik, đi kèm k3s, định tuyến mỗi request theo header Host tới các Service của stack.

Cluster

Tài liệu trên GitHub Pages

Tài liệu có thêm một bản triển khai bên ngoài cluster. Mỗi lần push lên main của repo docs, .github/workflows/pages.yml build trang Astro bằng Bun và xuất bản trên GitHub Pages tại https://shopnexus.github.io/docs/. Bản build đó đặt DOCS_BASE theo tiền tố đường dẫn của Pages và bỏ tab Developers nội bộ. Image trong mỗi stack được build với DOCS_BASE=/ và phục vụ trang ở gốc của docs.<domain>.

Server kiểm tra gì ở production

Server từ chối khởi động với APP_ENV=prod khi:

  • RESTATE_IDENTITY_KEY để trống;
  • FCM_CREDENTIALS để trống, khi đó push chỉ được ghi log;
  • PNV_TEST_NUMBERS=true, khi đó số test của PNV đăng nhập được.

Ở mọi môi trường, server cũng từ chối khởi động khi còn migration chưa chạy, vì vậy Job migrate chạy trước server trong mỗi stack. Chart đặt APP_ENV theo appEnv trong file values, đặt PNV_TEST_NUMBERS=false trong values-prod.yaml và LOG_FORMAT=json ở cả hai stack; các biến khác của server nằm ở trang Cấu hình.

Trang này có hữu ích không?
ShopNexus Docs
EN VI