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

이 페이지에서는 다음을 비롯한 배포 및 수정 버전을 설명합니다.

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

배포

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: Infra Manager가 실행되는 프로젝트 ID입니다.
  • LOCATION: Infra Manager가 실행되는 위치입니다.

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

  • Cloud Build 로그
  • Terraform 로그
  • Terraform 구성의 사본입니다.

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

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

배포 ID

배포 ID는 배포 리소스의 사용자 지정 식별자입니다. 배포 ID를 사용하여 다음 형식으로 배포를 참조합니다.

projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

다음을 바꿉니다.

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

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

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

버전

버전은 배포의 버전입니다. 처음에 배포를 만들면 이 배포도 버전이 되며 버전 ID가 r-0입니다.

버전 이름

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

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

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인 스토리지 버킷

Infrastructure Manager는 Terraform 구성을 청사진이라고 합니다.

다음을 바꿉니다.

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

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

  • Cloud Build 로그
  • Terraform 로그
  • Terraform 구성의 사본입니다.

미리보기 이름

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

projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

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

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

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

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

다음 단계