Vị trí Cloud Functions

Cloud Functions là theo khu vực, nghĩa là cơ sở hạ tầng chạy hàm của bạn nằm ở một số khu vực cụ thể và được Google quản lý để có sẵn nhiều bản sao trên tất cả các vùng trong những khu vực đó.

Khi chọn khu vực để chạy hàm, bạn nên cân nhắc đến độ trễ và khả năng sử dụng. Nhìn chung, bạn có thể chọn các khu vực gần với người dùng, nhưng bạn cũng nên cân nhắc vị trí của các sản phẩm và dịch vụ khác mà ứng dụng của bạn sử dụng. Việc sử dụng dịch vụ trên nhiều khu vực có thể ảnh hưởng đến độ trễ của ứng dụng cũng như giá cả.

Theo mặc định, các hàm chạy trong vùng us-central1. Xin lưu ý rằng khu vực này có thể khác với khu vực của nguồn sự kiện, chẳng hạn như bộ chứa Cloud Storage. Tìm hiểu cách chỉ định vùng mà hàm chạy ở phần sau của trang này.

Khu vực được hỗ trợ

Trong danh sách trong phần này, biểu tượng energy_savings_leaf cho biết rằng điện năng cho khu vực này được sản xuất với lượng khí thải carbon thấp. Để biết thêm thông tin, hãy xem bài viết Năng lượng không phát thải carbon cho các khu vực của Google Cloud.

Mức giá cấp 1

Cloud Functions được cung cấp ở các khu vực sau với mức giá theo bậc 1:

Mức giá cấp 2

Cloud Functions được cung cấp ở các khu vực sau với mức giá theo bậc 2:

Các hàm trong một khu vực nhất định trong một dự án nhất định phải có tên riêng biệt (không phân biệt chữ hoa chữ thường), nhưng các hàm trên các khu vực hoặc trên các dự án có thể có cùng tên.

Các phương pháp hay nhất để chỉ định một khu vực

Theo mặc định, các hàm chạy trong vùng us-central1. Xin lưu ý rằng khu vực này có thể khác với khu vực của nguồn sự kiện, chẳng hạn như bộ chứa Cloud Storage. Nếu bạn cần chỉ định vùng mà hàm chạy, hãy làm theo các đề xuất trong phần này cho từng loại điều kiện kích hoạt hàm.

Để đặt vùng mà một hàm chạy, hãy đặt tham số region trong định nghĩa hàm như sau:

exports.firestoreAsia = onDocumentCreated(
  {
    document: "my-collection/{docId}",
    region: "asia-northeast1",
  },
  (event) => {},
);

# Before
@firestore_fn.on_document_created("my-collection/{docId}")
def firestore_trigger(event):
    pass

# After
@firestore_fn.on_document_created("my-collection/{docId}",
                                  region="asia-northeast1")
def firestore_trigger_asia(event):
    pass

Bạn có thể chỉ định nhiều khu vực bằng cách truyền nhiều chuỗi khu vực được phân tách bằng dấu phẩy trong region. Ngoài ra, xin lưu ý rằng khi chỉ định một khu vực cho nhiều loại trình kích hoạt ở chế độ nền, bạn cần chỉ định bộ lọc sự kiện chính xác cùng với khu vực đó. Trong ví dụ trên, đây là Cloud Firestore document phát ra sự kiện. Đối với điều kiện kích hoạt Cloud Storage, bộ lọc sự kiện có thể là bucket; đối với điều kiện kích hoạt Pub/Sub, bộ lọc sự kiện sẽ là topic, v.v.

Hãy xem phần thay đổi vùng của một hàm để biết thêm thông tin về cách thay đổi vùng cho một hàm đang xử lý lưu lượng truy cập chính thức.

HTTP và các hàm có thể gọi của máy khách

Đối với HTTP và các hàm có thể gọi, trước tiên, bạn nên đặt hàm của mình thành vùng đích hoặc gần nhất với vị trí của hầu hết khách hàng dự kiến, sau đó thay đổi hàm ban đầu để chuyển hướng yêu cầu HTTP của hàm đó đến hàm mới (các hàm này có thể có cùng tên). Nếu ứng dụng của hàm HTTP hỗ trợ chuyển hướng, bạn chỉ cần thay đổi hàm ban đầu để trả về trạng thái chuyển hướng HTTP (301) cùng với URL của hàm mới. Nếu ứng dụng của bạn không xử lý tốt các lệnh chuyển hướng, bạn có thể proxy yêu cầu từ hàm ban đầu đến hàm mới bằng cách bắt đầu một yêu cầu mới từ hàm ban đầu đến hàm mới. Bước cuối cùng là đảm bảo rằng tất cả ứng dụng đều gọi hàm mới.

Lựa chọn vị trí phía máy khách cho các hàm có thể gọi

Đối với hàm có thể gọi, chế độ thiết lập hàm có thể gọi của ứng dụng phải tuân theo các nguyên tắc giống như hàm HTTP. Ứng dụng cũng có thể chỉ định một vùng và phải làm như vậy nếu hàm chạy trong bất kỳ vùng nào khác ngoài us-central1.

Để đặt vùng trên ứng dụng, hãy chỉ định vùng mong muốn khi khởi tạo:

lazy var functions = Functions.functions(region:"europe-west1")

@property(strong, nonatomic) FIRFunctions *functions;
// ...
self.functions = [FIRFunctions functionsWithRegion:@"europe-west1"];

var functions = firebase.app().functions('europe-west1');

private FirebaseFunctions mFunctions;
// ...
mFunctions = FirebaseFunctions.getInstance("europe-west1");

firebase::functions::Functions* functions;
// ...
functions = firebase::functions::Functions::GetInstance("europe-west1");

firebase.Functions.FirebaseFunctions functions;

functions = Firebase.Functions.FirebaseFunctions.GetInstance("europe-west1");

Hàm trong nền

Các hàm trong nền sử dụng ngữ nghĩa phân phối sự kiện ít nhất một lần, nghĩa là trong một số trường hợp, các hàm này có thể nhận được sự kiện trùng lặp. Vì vậy, bạn nên triển khai các hàm để không thay đổi. Nếu hàm của bạn đã idempotent, thì bạn có thể triển khai lại hàm đó ở khu vực mới bằng cùng một trình kích hoạt sự kiện và xoá hàm cũ sau khi xác minh rằng hàm mới đang nhận được lưu lượng truy cập chính xác. Trong quá trình chuyển đổi này, cả hai hàm sẽ nhận được sự kiện. Hãy xem phần thay đổi vùng của hàm để biết trình tự lệnh được đề xuất nhằm thay đổi vùng cho các hàm.

Nếu hàm của bạn hiện không mang tính chất idempotent hoặc tính chất idempotent của hàm không mở rộng ra ngoài khu vực, thì trước tiên, bạn nên triển khai tính chất idempotent trước khi di chuyển hàm.

Đề xuất về khu vực tối ưu khác nhau tuỳ theo loại trình kích hoạt sự kiện:

Chọn khu vực dựa trên vị trí Cloud Firestore và Cloud Storage

Các vùng có sẵn cho hàm không phải lúc nào cũng khớp chính xác với các vùng có sẵn cho cơ sở dữ liệu Cloud Firestore và các bộ chứa Cloud Storage.

Xin lưu ý rằng nếu hàm và tài nguyên (phiên bản cơ sở dữ liệu hoặc bộ chứa Cloud Storage) ở các vị trí khác nhau, thì bạn có thể phải chịu độ trễ và chi phí thanh toán cao hơn.

Dưới đây là bản đồ ánh xạ các vùng được hỗ trợ chức năng gần nhất cho Cloud Firestore và Cloud Storage, trong trường hợp cùng một vùng không được hỗ trợ: