배포, 버전, 미리보기 개요

이 페이지에서는 다음을 포함하여 배포 및 버전을 설명합니다.

  • 각 배포에 저장된 메타데이터 목록입니다.
  • 배포 이름 및 버전 이름의 형식입니다.

배포

Infra Manager는 Google Cloud 에 리소스를 배포로 프로비저닝합니다.

배포는 여러 위치 및 여러 프로젝트에 Google Cloud 리소스를 프로비저닝할 수 있습니다. 다음 사항을 참고하세요.

  • 해당 위치에서 특정 리소스를 사용할 수 있어야 합니다. 예를 들어 Cloud Run이 제공되는 위치 목록은 Cloud Run 위치를 참고하세요.
  • 서비스 계정에는 지정된 프로젝트에 배포하는 데 필요한 권한이 있어야 합니다. 자세한 내용은 서비스 계정 구성을 참고하세요.

배포 메타데이터

Infra Manager는 Infra Manager가 실행되는 프로젝트 및 위치에 스토리지 버킷을 만듭니다. 배포가 생성되면 Infrastructure Manager 아티팩트는 gs://PROJECT_NUMBER-LOCATION-blueprint-config라는 이름의 이 스토리지 버킷에 있습니다.

Infra Manager는 Terraform 구성을 나타내는 데 블루프린트라는 용어를 사용합니다.

여기서 다음을 바꿉니다.

  • PROJECT_ID: 인프라 관리자가 실행되는 프로젝트 ID입니다.
  • LOCATION: Infra Manager가 실행되는 위치입니다.

스토리지 버킷의 배포 아티팩트에는 다음이 포함됩니다.

  • Cloud Build 로그
  • Terraform 로그
  • Terraform 구성 사본

Infra Manager는 Terraform 상태 파일의 사본도 저장합니다. 파일 액세스를 비롯한 상태 파일에 관한 자세한 내용은 Terraform 상태 파일 관리를 참고하세요.

버전은 배포의 버전이므로 Infra Manager는 각 버전에 대해 이 배포 메타데이터를 저장합니다.

배포 이름

배포 이름의 형식은 다음과 같습니다.

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID는 Infra Manager가 실행되는 프로젝트 ID입니다.
  • LOCATION은 Infra Manager가 실행되는 위치입니다. 유효한 위치 목록은 인프라 관리자 위치를 참고하세요.
  • DEPLOYMENT_ID은 배포 식별자이며 사용자가 지정한 이름입니다. 이름은 다음 조건을 충족해야 합니다.
    • 소문자, 숫자 또는 하이픈만 포함해야 합니다.
    • 소문자로 시작해야 합니다.
    • 숫자 또는 소문자로 끝납니다.
    • archived-deployments 또는 archived-previews 문자열이 될 수 없습니다.
    • 인프라 관리자가 실행되는 프로젝트 및 위치 내에서 고유해야 합니다.

예를 들면 다음과 같습니다.

projects/my-project/locations/us-central1/deployments/my-deployment

버전

버전은 배포의 버전입니다. 배포를 처음 만들 때 이 배포는 버전이기도 하며 버전 ID가 r-0입니다.

버전 이름

Infra Manager 배포를 만들면 버전 식별자 r-0가 자동으로 할당됩니다. 배포를 업데이트하면 인프라 관리자가 식별자 r-1를 사용하여 새 버전을 만듭니다. 새 버전이 생성될 때마다 식별자가 1씩 증가합니다. 버전 식별자는 인프라 관리자만 설정할 수 있습니다.

예를 들어 버전 이름은 다음과 같습니다.

projects/my-project/locations/us-central1/deployments/my-deployment/revisions/r-1

미리보기

미리보기에는 특정 Terraform 구성을 실행하는 작업이 설명됩니다. 새 배포를 만들거나 배포를 업데이트하기 전에 배포를 미리 보고 프로비저닝할 리소스를 확인할 수 있습니다.

메타데이터 미리보기

Infra Manager는 Infra Manager가 실행되는 프로젝트 및 위치에 스토리지 버킷을 만듭니다. 미리보기가 생성되면 Infra Manager 아티팩트는 이름이 gs://PROJECT_NUMBER-LOCATION-blueprint-config인 이 저장소 버킷에 있습니다.

새 배포의 미리보기의 경우 메타데이터가 new-previews 접두사로 구성됩니다(예: gs://PROJECT_NUMBER-LOCATION-blueprint-config/new-previews/preview-name).

기존 배포의 업데이트를 미리 볼 수도 있습니다. 기존 배포를 타겟팅하는 이러한 미리보기의 경우 아티팩트가 배포 아티팩트와 동일한 스토리지 버킷에 저장됩니다. 이름이 gs://PROJECT_ID-LOCATION-blueprint-config/deployment-ID/previews/preview-ID인 스토리지 버킷

Infra Manager는 Terraform 구성을 나타내는 데 blueprint라는 용어를 사용합니다.

다음을 바꿉니다.

  • PROJECT_ID: 인프라 관리자가 실행되는 프로젝트 ID입니다.
  • LOCATION: Infra Manager가 실행되는 위치입니다.

저장소 버킷의 미리보기 아티팩트에는 다음이 포함됩니다.

  • Cloud Build 로그
  • Terraform 로그
  • Terraform 구성 사본

미리보기 이름

미리보기 이름의 형식은 다음과 같습니다.

projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID는 Infra Manager가 실행되는 프로젝트 ID입니다.
  • LOCATION은 Infra Manager가 실행되는 위치입니다. 유효한 위치 목록은 인프라 관리자 위치를 참고하세요.
  • PREVIEW_ID은 배포 식별자이며 사용자가 지정한 이름입니다. 이름은 다음 조건을 충족해야 합니다.
    • 소문자, 숫자 또는 하이픈만 포함해야 합니다.
    • 소문자로 시작해야 합니다.
    • 숫자 또는 소문자로 끝납니다.
    • archived-deployments 또는 archived-previews 문자열이 될 수 없습니다.
    • 인프라 관리자가 실행되는 프로젝트 및 위치 내에서 고유해야 합니다.

예를 들면 다음과 같습니다.

projects/my-project/locations/us-central1/previews/my-preview

다음 단계