Triển khai nhiều môi trường từ một cơ sở mã

Thông thường, bạn sẽ triển khai nhiều môi trường từ cùng một cơ sở mã, mỗi môi trường có cấu hình hơi khác nhau. Ví dụ: bạn có thể muốn chỉ định ít CPU và RAM hơn cho môi trường thử nghiệm hoặc bạn có thể muốn đảm bảo môi trường chính thức luôn duy trì ít nhất 1 thực thể đang hoạt động và sẵn sàng xử lý các yêu cầu. Bạn cũng có thể muốn chỉ định các biến môi trường và bí mật khác nhau tuỳ thuộc vào môi trường và tài nguyên mà bạn muốn sử dụng.

Hướng dẫn này mô tả cách triển khai môi trường chính thức và môi trường thử nghiệm, mỗi môi trường cho một dự án Firebase riêng biệt. Tuân theo các nguyên tắc tương tự, bạn có thể triển khai cho các loại môi trường khác. Để tìm hiểu thêm về môi trường, hãy xem bài viết Tổng quan về môi trường và Các phương pháp hay nhất chung để thiết lập dự án Firebase projects.

Điều kiện tiên quyết

Bước 0: Tạo cấu hình mặc định trong apphosting.yaml

App Hosting hỗ trợ một tệp cấu hình có tên là apphosting.yaml để quản lý các chế độ cài đặt thời gian chạy (CPU, mức độ đồng thời, giới hạn bộ nhớ, v.v.) và các biến môi trường cho ứng dụng của bạn. Tệp này cũng hỗ trợ các tham chiếu đến các bí mật được quản lý bằng Cloud Secret Manager, giúp bạn có thể kiểm tra một cách an toàn vào hệ thống kiểm soát nguồn. Để biết thêm thông tin, hãy xem Định cấu hình phần phụ trợ.

Để bắt đầu, hãy tạo một tệp apphosting.yaml trong thư mục gốc của ứng dụng. Đây là tệp cấu hình dự phòng được sử dụng khi không tìm thấy tệp cấu hình dành riêng cho môi trường. Các giá trị được lưu trữ trong apphosting.yaml phải là các giá trị mặc định an toàn để sử dụng cho tất cả các môi trường.

Các phần tiếp theo giải thích cách ghi đè các giá trị mặc định trong apphosting.yaml cho các môi trường cụ thể. Quy trình ví dụ này tạo ra một môi trường thử nghiệm.

Bước 1: Đặt tên môi trường

Mỗi phần phụ trợ App Hosting đều có chế độ cài đặt Environment name (Tên môi trường). Trường này dùng để ánh xạ phần phụ trợ của bạn đến một tệp cấu hình dành riêng cho môi trường và có thể thay đổi bất cứ lúc nào. Bạn chỉ có thể đặt một tên môi trường cho mỗi phần phụ trợ.

Cách đặt tên môi trường cho phần phụ trợ:

  1. Trong bảng điều khiển của Firebase, hãy chọn dự án thử nghiệm (trong ví dụ này, my-staging-firebase-project).
  2. Chọn App Hosting trong thanh điều hướng bên trái.
  3. Nhấp vào View dashboard (Xem trang tổng quan) trên phần phụ trợ bạn chọn.
  4. Trong thẻ Settings (Cài đặt), hãy chọn Environment (Môi trường).
  5. Trong phần Environment name (Tên môi trường), hãy nhập tên môi trường của bạn. Bạn có thể đặt tên môi trường tuỳ ý. Trong ví dụ này, đó là staging (thử nghiệm).
  6. Nhấp vào Save (Lưu).

Khi quá trình triển khai App Hosting được kích hoạt cho phần phụ trợ của bạn (trên git push hoặc theo cách thủ công thông qua bảng điều khiển), App Hosting sẽ kiểm tra tệp apphosting.ENVIRONMENT_NAME.yaml trước khi quay lại apphosting.yaml.

Bước 2: Tạo tệp dành riêng cho môi trường apphosting.yaml

Đối với cấu hình dành riêng cho môi trường, hãy tạo một tệp có tên là apphosting.ENVIRONMENT_NAME.yaml để chỉ định các giá trị ghi đè dành riêng cho môi trường. Tệp này có cùng định dạng với apphosting.yaml mặc định và phải nằm trong thư mục gốc của ứng dụng cùng với apphosting.yaml.

Vào thời gian xây dựng, App Hosting sẽ hợp nhất hai tệp này, trong đó ưu tiên các giá trị trong tệp YAML dành riêng cho môi trường so với tệp apphosting.yaml cơ sở.

Trong ví dụ này, bạn sẽ tạo một tệp có tên là apphosting.staging.yaml trong thư mục gốc của ứng dụng:


runConfig:
  cpu: 1
  memoryMiB: 512
  concurrency: 5

env:
-   variable: API_URL
    value: api.staging.service.com
    availability:
      -   BUILD

-   variable: DATABASE_URL
    secret: secretStagingDatabaseURL

Giả sử bạn đã có một apphosting.yaml có dạng như sau:

runConfig:
  cpu: 3
  memoryMiB: 1024
  maxInstances: 4
  minInstances: 0
  concurrency: 100

env:
-   variable: API_URL
    value: api.service.com
    availability:
      -   BUILD
      -   RUNTIME

-   variable: STORAGE_BUCKET
    value: mybucket.firebasestorage.app
    availability:
      -   RUNTIME

-   variable: API_KEY
    secret: secretIDforAPI

Kết quả hợp nhất cuối cùng mà bạn có thể kiểm tra trong nhật ký Cloud Build sẽ có dạng như sau:

runConfig:
  cpu: 1
  memoryMiB: 512
  maxInstances: 4
  minInstances: 0
  concurrency: 5

env:
-   variable: API_URL
    value: api.staging.service.com
    availability:
      -   BUILD

-   variable: STORAGE_BUCKET
    value: mybucket.firebasestorage.app
    availability:
      -   RUNTIME

-   variable: API_KEY
    secret: secretIDforAPI

-   variable: DATABASE_URL
    secret: secretStagingDatabaseURL

Xin lưu ý rằng một số giá trị runConfig như CPU cũng như mọi biến môi trường trùng lặp đã bị ghi đè.

Bước 3: Triển khai cơ sở mã

Sau khi bạn chỉnh sửa xong tệp apphosting.ENVIRONMENT_NAME.yaml dành riêng cho môi trường, hãy đẩy tệp đó lên GitHub:

$ git add apphosting.<ENVIRONMENT_NAME>.yaml
$ git commit -m "Added environment specific yaml file"
$ git push

Mọi phần phụ trợ được gắn thẻ bằng tên môi trường này sẽ sử dụng các giá trị ghi đè cụ thể mà bạn đã chỉ định trong tệp YAML tương ứng và quay lại apphosting.yaml khi không tìm thấy giá trị. Đối với các phần phụ trợ không có tên môi trường được liên kết, bạn có thể tiếp tục sử dụng apphosting.yaml.

Các bước tiếp theo