이 페이지에서는 다음을 포함하여 배포 및 버전을 설명합니다.
- 각 배포에 저장된 메타데이터 목록입니다.
- 배포 이름 및 버전 이름의 형식입니다.
배포
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
다음 단계
- Google Cloud에서 Terraform에 대해 자세히 알아보세요.
- 배포를 만듭니다.
- 배포를 업데이트합니다.
- 배포 상태 보기
- 배포를 삭제합니다.