Cloud Build 위치

Cloud Build는 비공개 풀 및 기본 풀에서 리전 빌드를 지원합니다.

빌드 리전을 선택할 때 가장 우선해서 고려해야 할 사항은 지연 시간과 가용성입니다. 일반적으로 Cloud Build 사용자와 가장 가까운 리전을 선택할 수 있지만 빌드와 통합할 수 있는 다른 Google Cloud 제품 및 서비스의 위치도 고려해야 합니다. 여러 위치에서 서비스를 사용하면 앱의 지연 시간과 가격에 영향을 미칠 수 있습니다.

Cloud Build는 다음 리전에서 사용할 수 있습니다.

  • africa-south1
  • asia-east1
  • asia-east2
  • asia-northeast1
  • asia-northeast2
  • asia-northeast3
  • asia-south1
  • asia-south2
  • asia-southeast1
  • asia-southeast2
  • australia-southeast1
  • australia-southeast2
  • europe-central2
  • europe-north1
  • europe-north2
  • europe-southwest1
  • europe-west1
  • europe-west2
  • europe-west3
  • europe-west4
  • europe-west6
  • europe-west8
  • europe-west9
  • europe-west10
  • europe-west12
  • me-central1
  • me-central2
  • me-west1
  • northamerica-northeast1
  • northamerica-northeast2
  • northamerica-south1
  • southamerica-east1
  • southamerica-west1
  • us-central1
  • us-east1
  • us-east4
  • us-east5
  • us-south1
  • us-west1
  • us-west2
  • us-west3
  • us-west4

리전 선택

리전 빌드를 실행하려면 명령줄을 통해 빌드를 시작하거나 빌드 트리거를 만들 때 리전을 지정합니다.

비공개 풀의 리전을 선택하려면 비공개 풀을 만들 때 리전을 지정합니다. 리전 내에서 비공개 풀을 만든 후에는 다른 리전으로 이동할 수 없습니다. 특정 리전에 비공개 풀을 만들면 해당 리전 내의 모든 영역에 중복으로 사용할 수 있도록 Google에서 관리됩니다.

트리거와 연결된 빌드 구성 파일이 비공개 풀을 지정하는 경우, 트리거에 선택한 리전이 비공개 풀의 리전과 일치해야 합니다.

빌드 트리거의 리전으로 global을 선택하면 Cloud Build는 트리거와 연결된 빌드 구성 파일에 지정된 리전을 사용하여 빌드를 실행합니다. 빌드 구성 파일에 비공개 풀을 지정하는 경우 비공개 풀의 리전이거나 비공개 풀을 지정하지 않은 경우 전역 기본 풀일 수 있습니다.

리전 엔드포인트를 사용하여 Cloud Build 리소스에 액세스

리전 엔드포인트를 사용하여 Cloud Build의 리소스에 액세스할 수 있습니다. 리전 엔드포인트를 사용하면 데이터 상주 및 데이터 주권 요구사항을 준수하는 방식으로 워크로드를 실행할 수 있으며, 여기서 요청 트래픽은 엔드포인트에 지정된 리전으로 직접 라우팅됩니다.

리전 엔드포인트는 영향을 받는 리소스가 엔드포인트에서 지정된 위치에 있는 경우에만 요청 처리를 허용하는 요청 엔드포인트입니다. 예를 들어 빌드 생성 요청에서 엔드포인트 https://cloudBuild.me-central2.rep.googleapis.com을 사용하는 경우 빌드 구성 파일이 me-central2에 있는 경우에만 요청이 진행됩니다.

리소스가 있는 곳과 다른 위치에서 요청을 처리할 수 있는 전역 엔드포인트와 달리 리전 엔드포인트는 리소스가 있는 엔드포인트에서 지정한 위치 내에서 요청이 처리되도록 보장합니다. 리전 엔드포인트는 인터넷, 기타Google Cloud 리소스 (예: Compute Engine 가상 머신),VPN 또는 Interconnect를 사용하는 온프레미스 서비스, Virtual Private Cloud (VPC)에서 수신된 요청에 대해 엔드포인트에서 지정된 위치에서 TLS 세션을 종료합니다.

리전 엔드포인트는 객체의 저장 데이터와 전송 중 데이터가 엔드포인트에서 지정된 위치 외부로 이동하지 않도록 하여 데이터 상주를 보장합니다. 이렇게 하면 객체 이름 및 버킷 IAM 정책과 같은 리소스 메타데이터가 제외됩니다. 자세한 내용은 고객 데이터 및 서비스 데이터 참고사항을 참고하세요.

빌드를 실행하는 데 필요한 단계에 관한 자세한 내용은 빌드 실행을 참고하세요.

리전 엔드포인트에서 사용할 Google Cloud CLI 구성

리전 엔드포인트에서 사용할 gcloud CLI를 구성하려면 다음을 실행하세요.

  1. Google Cloud CLI 402.0.0 이상을 사용하는지 확인합니다.

  2. api_endpoint_overrides/cloudbuild 속성을 사용할 리전 엔드포인트로 설정합니다.

    gcloud config set api_endpoint_overrides/cloudbuild https://cloudbuild.LOCATION.rep.googleapis.com/

    또는 CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD 환경 변수를 엔드포인트로 설정할 수 있습니다.

    CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD=https://cloudbuild.LOCATION.rep.googleapis.com/