Cloud Functions 위치

Cloud Functions리전이며, 이는 애플리케이션을 실행하는 인프라를 의미합니다. 함수가 특정 리전에 위치해 있고 Google에서 관리하며 가용성이 높고 해당 리전 내의 모든 영역에 액세스할 수 있습니다.

함수를 실행할 지역을 선택할 때 가장 우선적으로 고려해야 할 사항은 지연 시간과 가용성입니다. 일반적으로 사용자와 가장 가까운 지역을 선택하게 되지만 앱에서 사용하는 기타 제품 및 서비스의 위치도 고려해야 합니다. 여러 리전에서 서비스를 사용하면 앱의 지연 시간과 가격이 영향을 받을 수 있습니다.

기본적으로 함수는 us-central1 리전에서 실행됩니다. 이는 이벤트 소스의 리전과 다른 인스턴스(예: Cloud Storage 버킷)에 연결할 수 있습니다. 이 페이지의 뒷부분에서 함수가 실행되는 지역을 지정하는 방법을 알아보세요.

지원되는 리전

이 섹션의 목록에서 energy_savings_leaf 아이콘은 이 리전의 전기가 저탄소 배출로 생성되었음을 나타냅니다. 자세한 내용은 Google Cloud 리전의 무탄소 에너지를 참조하세요.

Cloud Functions은(는) 다음 리전에서 사용할 수 있으며 등급 1 가격:

  • asia-east1(타이완)
  • asia-east2(홍콩) 1세대만
  • asia-northeast1(도쿄)
  • asia-northeast2(오사카)
  • europe-north1(핀란드) energy_savings_leaf 2세대만
  • europe-west1(벨기에) energy_savings_leaf
  • europe-west2(런던) 1세대만
  • us-central1(아이오와) energy_savings_leaf
  • us-east1(사우스캐롤라이나)
  • us-east4(북 버지니아)
  • us-west1(오리건) energy_savings_leaf

Cloud Functions은(는) 다음 리전에서 사용할 수 있으며 Tier 2 가격 책정:

  • asia-east2(홍콩) 2세대만
  • asia-northeast3(서울)
  • asia-southeast1(싱가포르)
  • asia-southeast2(자카르타)
  • asia-south1(뭄바이) 2세대만
  • australia-southeast1(시드니)
  • australia-southeast2(멜버른) 2세대만
  • europe-central2(바르샤바)
  • europe-west2(런던) 2세대만
  • europe-west3(프랑크푸르트)
  • europe-west6(취리히) energy_savings_leaf
  • northamerica-northeast1(몬트리올) energy_savings_leaf
  • northamerica-northeast2(토론토) energy_savings_leaf 2세대만
  • southamerica-east1(상파울루) energy_savings_leaf
  • southamerica-west1(칠레 산티아고) 2세대만
  • us-west2(로스앤젤레스)
  • us-west3(솔트레이크시티)
  • us-west4(라스베이거스)

특정 프로젝트의 특정 리전에서 사용하는 함수의 이름은 고유(대소문자를 구분하지 않음)해야 하지만, 다른 리전 또는 프로젝트에서 사용하는 함수의 경우 이름이 동일해도 됩니다.

지역 지정 권장사항

기본적으로 함수는 us-central1 리전에서 실행됩니다. 이는 이벤트 소스의 리전과 다른 인스턴스(예: Cloud Storage 버킷)에 연결할 수 있습니다. 만약 함수가 실행되는 리전을 지정하고 이 섹션에서 각 함수 트리거 유형에 대한 권장사항을 확인할 수 있습니다.

함수가 실행되는 리전을 설정하려면 다음과 같이 함수 정의에서 region 매개변수를 설정합니다.

Node.js

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

Python

# 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

region에서 쉼표로 구분된 여러 리전 문자열을 전달하여 리전을 여러 개 지정할 수 있습니다. 또한 여러 백그라운드 트리거 유형의 리전을 지정할 때는 리전과 함께 올바른 이벤트 필터를 지정해야 합니다. 위 예에서 Cloud Firestore document입니다. 이벤트를 내보내는 이벤트입니다. Cloud Storage의 경우 이벤트 필터를 트리거합니다. bucket일 수 있습니다. Pub/Sub 트리거의 경우에는 topic 등입니다.

자세한 내용은 함수의 리전 변경 를 처리하는 함수의 리전 변경에 대한 자세한 내용은 배포할 수 있습니다

HTTP 및 클라이언트 호출 가능 함수

HTTP 및 호출 가능 함수의 경우, 함수를 일단 대상 지역 또는 고객이 가장 많이 위치할 것으로 예상되는 지역으로 설정한 다음 HTTP 요청을 새로운 함수로 리디렉션하도록 원래 함수를 변경하는 것이 좋습니다(두 함수의 이름이 동일해도 상관없음). HTTP 함수의 클라이언트가 리디렉션을 지원하는 경우 원래 함수가 새로운 함수의 URL에 따라 HTTP 리디렉션 상태(301)를 반환하도록 변경하기만 하면 됩니다. 클라이언트에서 리디렉션을 제대로 처리하지 않는 경우, 원래 함수에서 새로운 함수로 새 요청을 시작하여 원래 함수의 요청을 새로운 함수로 프록시하면 됩니다. 최종 단계로 모든 클라이언트가 새로운 함수를 호출하는지 확인합니다.

호출 가능한 함수의 클라이언트 측 위치 선정

호출 가능한 함수와 관련된 경우 클라이언트 호출 가능한 설정이 HTTP 함수와 동일한 가이드라인을 따라야 합니다. 또한 클라이언트는 리전을 지정할 수 있으며 함수가 us-central1 이외의 다른 리전에서 실행되는 경우에는 반드시 지정해야 합니다.

클라이언트에서 리전을 설정하려면 초기화할 때 원하는 리전을 지정합니다.

Swift

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

Objective-C

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


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

Android

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

C++

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

Unity

firebase.Functions.FirebaseFunctions functions;

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

백그라운드 함수

백그라운드 함수는 최소 1회 이벤트 전송 의미 체계를 사용합니다. 즉, 일부 상황에서는 중복 이벤트를 수신할 수 있으므로 멱등성을 갖도록 구현해야 합니다. 함수에 이미 멱등성이 있는 경우에는 동일한 이벤트 트리거로 새로운 지역에 함수를 재배포할 수 있으며, 새로운 함수가 트래픽을 제대로 수신하는지 확인한 후 기존 함수를 제거해도 됩니다. 이 전환 중에는 두 함수 모두 이벤트를 수신합니다. 함수 리전을 변경하는 권장 명령어 시퀀스는 함수 리전 변경을 참조하세요.

현재 함수에 멱등성이 없거나 함수의 멱등성이 리전 외부로 확장되지 않은 경우에는 함수를 옮기기 전에 먼저 멱등성을 구현하는 것이 좋습니다.

최적의 권장 지역은 이벤트 트리거 유형에 따라 다릅니다.

트리거 유형 권장 지역
Cloud Firestore Cloud Firestore 인스턴스 위치와 가장 가까운 리전 (다음 섹션 참조)
Realtime Database 항상 us-central1
Cloud Storage Cloud Storage 버킷 위치와 가장 가까운 리전 (다음 섹션 참조)
기타 Realtime Database 인스턴스와 상호작용하는 경우 Cloud Firestore 인스턴스 또는 함수 내부의 Cloud Storage 버킷에 있다면 권장되는 해당 리전 중 하나로 트리거된 함수가 있는 경우와 리소스를 배포합니다 그 외의 경우에는 기본 리전(us-central1)을 사용합니다. Firebase Hosting에 연결된 함수는 어느 리전에나 있을 수 있지만 다음을 참고하세요. 호스팅 서버리스 개요에서 권장사항을 확인하세요.

Cloud FirestoreCloud Storage 위치를 기준으로 리전 선택

함수를 사용할 수 있는 영역은 Cloud Firestore 데이터베이스 및 Cloud Storage에 사용 가능한 리전 버킷과 동기화할 수 있습니다

함수와 리소스 (데이터베이스 인스턴스 또는 Cloud Storage)가 버킷)이 다른 위치에 있는 경우 다음과 같은 문제가 발생할 수 있습니다. 지연 시간 증가 및 청구 비용입니다.

다음은 Cloud Firestore와 가장 가까운 함수 지원 리전의 매핑입니다. 동일한 리전이 지원되지 않는 경우 Cloud Storage를 사용하세요.

Cloud FirestoreCloud Storage의 리전/멀티 리전 가장 가까운 함수 리전
nam5 또는 us-central(멀티 리전) us-central1
eur3 또는 europe-west(멀티 리전) europe-west1
europe-west4(네덜란드) europe-west1
asia-south1(뭄바이) asia-east2
asia-south2(델리) asia-east2
australia-southeast2(멜버른) australia-southeast1