배포 업데이트

이 페이지에서는 Infrastructure Manager를 사용하여 배포를 업데이트하는 방법을 설명합니다. 배포를 업데이트해야 하는 경우는 다음과 같습니다.

  • 인프라를 선택한 상태로 되돌리기

    배포를 만들면 시간이 지나 리소스가 변경될 수 있습니다. 예를 들어 콘솔에서 작업하는 사용자가 일부 리소스를 수정했을 수 있습니다. 원래 Terraform 구성을 사용하여 배포를 업데이트하여 선택한 상태로 되돌릴 수 있습니다.

  • 인프라 변경사항을 구현합니다.

    배포를 만든 후 인프라를 수정할 수 있습니다. 예를 들어 새 리소스를 추가하거나 일부 구성을 변경하는 경우 새 인프라를 설명하는 Terraform 구성을 사용하여 배포를 업데이트할 수 있습니다.

이 페이지에서는 Terraform에 익숙하다고 가정합니다. 자세한 내용은 Terraform 및 Infra Manager를 참고하세요.

시작하기 전에

  1. Infra Manager가 사용 설정되어 있는지 확인합니다.
  2. 배포를 만드는 데 필요한 IAM 권한이 있는지 확인합니다. roles/config.admin
  3. 필요한 권한이 있는 서비스 계정이 있는지 확인합니다. 자세한 내용은 서비스 계정 구성을 참고하세요.
  4. 업데이트할 Infra Manager 배포를 식별합니다.

  5. 업데이트를 위해 배포할 Terraform 구성을 식별합니다. 모든 구성을 버전에 사용할 수 있습니다. 이 구성은 이미 배포된 구성과 동일하거나 업데이트된 버전인 경우가 많습니다.

    이 Terraform 구성이 민감한 정보가 포함되지 않는 등 제약 조건을 준수하는지 확인합니다.

  6. 의도한 인프라와 연결된 제품에 대한 조직의 할당량을 확인합니다. 의도한 인프라가 배포에서 사용하는 제품에 대한 조직의 할당량을 초과하는 경우 배포 오류가 발생할 수 있습니다. 자세한 내용은 할당량 및 한도를 참고하세요.

  7. 수정 중인 리소스의 데이터 이전 또는 서비스 연속성에 필요한 조치를 취합니다.

  8. 리소스를 구성하기 전에 업데이트를 미리 보려면 배포 업데이트 미리보기를 참고하세요.

구성과 관련된 권한 부여

Terraform 구성에 지정된 Google Cloud 리소스를 배포하려면 Infra Manager를 호출하는 데 사용하는 서비스 계정에 다음과 관련된 권한이 필요합니다.

  • 버전에 사용 중인 구성에 정의된Google Cloud 리소스입니다.

  • 버전 관리에 사용하는 구성이 배포에 사용된 구성과 다른 리소스를 정의하는 경우 두 구성에 정의된 리소스에 대한 권한이 필요합니다.

구성에 정의된 리소스에 관한 권한은 서비스 계정이 인프라 관리자 서비스를 사용하기 위해 필요한 권한에 추가됩니다.

Google Cloud 리소스에 권한을 부여하고 필요한 프로젝트에 액세스할 수 있는지 확인하는 방법에 관한 자세한 내용은 서비스 계정 구성을 참고하세요.

비공개 Git 저장소 및 호스트를 Cloud Build에 연결

비공개 Git 저장소에서 Terraform 구성을 배포하는 경우 Git 호스트와 저장소를 Cloud Build에 연결해야 합니다.

배포 업데이트

배포를 업데이트하려면 동일한 배포 이름을 사용하여 구성을 배포하면 버전이 생성됩니다. 자세한 내용은 배포 및 버전 개요를 참고하세요.

기존 배포가 없는 경우 Infra Manager를 사용하여 인프라 배포를 참고하세요.

리소스를 프로비저닝하지 않고 업데이트를 미리 보려면 배포 미리보기를 참고하세요.

선택한 워크플로가 있는 탭을 선택하여 배포를 업데이트하는 방법을 자세히 알아보세요.

콘솔

이 섹션에서는 Google Cloud 콘솔에서 Infra Manager를 사용하여 Terraform 구성을 업데이트하는 방법을 설명합니다.

구성을 배포하고 버전을 만듭니다.

  1. Google Cloud 콘솔에서 인프라 관리자 페이지로 이동합니다.

    Infra Manager로 이동

  2. 배포 페이지의 ID 열에서 업데이트할 배포를 클릭합니다.
  3. 배포 ID가 제목에 표시된 페이지에서 수정을 클릭합니다.
  4. 배포 세부정보 페이지에서 Terraform 버전, 서비스 계정, 및 Terraform 구성 소스 필드를 수정할 수 있습니다. 비공개 Git 저장소를 제공하는 경우 호스트와 저장소를 Cloud Build에 연결했는지 확인하세요.

    계속을 클릭합니다.

  5. Terraform 세부정보 페이지에서 Terraform 구성의 입력 값을 수정할 수 있습니다. 계속을 클릭합니다.
  6. 고급 세부정보 페이지에서 라벨 및 주석, 작업자 풀, 아티팩트 Cloud Storage 버킷 필드를 수정할 수 있습니다.
  7. 배포에 적용한 변경사항이 만족스러우면 업데이트를 클릭하여 업데이트 프로세스를 시작합니다.

배포 매개변수 및 형식에 관한 자세한 내용은 리소스 배포 문서를 참고하세요.

gcloud CLI

이 섹션에서는 Cloud Storage 버킷에 저장된 Terraform 구성을 배포하는 방법을 설명합니다. 저장소 버킷을 사용하면 구성에 대한 액세스를 제어할 수 있습니다.

  1. Terraform 구성이 Cloud Storage 버킷에 있는지 확인합니다. 자세한 내용은 스토리지 버킷에 구성 업로드하기를 참고하세요.

  2. 스토리지 버킷이 Infra Manager를 실행하는 프로젝트와 다른 프로젝트에 있는 경우 Infra Manager의 서비스 계정에 버킷에 대한 읽기 권한이 있는지 확인해야 합니다. 자세한 내용은 서비스 계정 구성을 참고하세요.

    스토리지 버킷이 Infra Manager와 동일한 프로젝트에 있으면 버킷에 대한 읽기 권한이 이미 사용 설정되어 있습니다.

  3. 구성을 배포하고 버전을 만듭니다.

    gcloud infra-manager deployments apply projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
        --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
        --gcs-source gs://BUCKET_NAME/OBJECT_NAME \
        --quota-validation=QUOTA_VALIDATION \
        --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
        --tf-version-constraint=TERRAFORM_VERSION \
        --annotation="ANNOTATION_KEY=ANNOTATION_VALUE"
다음과 같이 바꿉니다.
  • PROJECT_ID: 인프라 관리자가 실행되는 프로젝트 ID입니다.
  • LOCATION: Infra Manager가 실행되는 위치입니다. 유효한 위치 목록은 인프라 관리자 위치를 참고하세요.
  • DEPLOYMENT_ID: 지정된 배포 식별자입니다. 배포 식별자의 제약조건에 관한 자세한 내용은 배포 이름을 참고하세요.
  • SERVICE_ACCOUNT_PROJECT_ID는 서비스 계정의 프로젝트 ID입니다. 일반적으로 Infra Manager가 실행되는 프로젝트와 동일한 프로젝트입니다.
  • SERVICE_ACCOUNT: Infra Manager를 호출하는 데 사용하는 서비스 계정의 이름입니다.
  • BUCKET_NAME: 구성이 저장된 스토리지 버킷의 이름입니다.
  • OBJECT_NAME: 구성 파일의 객체 이름입니다. 이 객체는 디렉터리 또는 zip 파일일 수 있지만 Terraform 파일은 아닙니다. 객체 버전 관리를 사용하는 경우 객체의 세대 번호를 지정할 수도 있습니다. 자세한 내용은 버전 관리형 객체 사용을 참고하세요.

    스토리지 버킷이 Terraform 구성의 루트 경로인 경우 OBJECT_NAME는 선택사항입니다.

  • 선택사항: QUOTA_VALIDATION: 배포를 만들 때 Terraform 구성 파일의 리소스에 대한 할당량 유효성 검사가 사용 설정 또는 적용되는지 여부를 결정하는 값입니다. 가능한 값은 다음과 같습니다.
    • ENABLED: Terraform 구성 파일에서 리소스에 대한 컴퓨팅 할당량 유효성 검사를 사용 설정합니다. 할당량이 부족한 리소스에 대한 가시성을 제공합니다.
    • ENFORCED: Terraform 구성 파일에 정의된 인프라에 사용할 수 있는 할당량이 충분하지 않으면 배포가 실패하도록 할당량 유효성 검사를 적용합니다.

    QUOTA_VALIDATION가 정의되지 않으면 Terraform 구성 파일의 할당량 유효성 검사가 사용 중지됩니다. 기본값입니다. 할당량 유효성 검사는 제한된 Google Cloud 리소스에 적용됩니다. 자세한 내용은 할당량 및 제한을 참고하세요.

  • INPUT_1_NAME 및 INPUT_2_NAME: 기본적으로 정의되지 않은 값을 포함하여 Terraform 구성의 모든 입력 값입니다. 예를 들어 리소스를 배포할 프로젝트를 project_id=my-project로 지정할 수 있습니다.

    모든 입력 값이 구성에서 기본적으로 정의된 경우 이 플래그는 선택사항입니다.

  • 선택사항:TERRAFORM_VERSION: Infra Manager에서 배포를 만들 때 사용할 Terraform 버전입니다. 지원되는 버전 목록은 지원되는 Terraform 버전을 참고하세요. 이 선택적 플래그를 삭제하면 지원되는 최신 Terraform 버전이 사용됩니다.
  • 선택사항: ANNOTATION_KEY 및 ANNOTATION_VALUE는 Infra Manager 배포에 연결할 수 있는 자유 형식 텍스트의 키-값 쌍을 나타냅니다. 주석 및 라벨의 사용 및 제약사항에 관한 자세한 내용은 주석 및 라벨을 참고하세요.

gcloud CLI

이 섹션에서는 Git 저장소에 저장된 Terraform 구성을 사용하는 방법을 설명합니다.

  1. Git이 설치되어 있는지 확인합니다.
  2. Terraform 구성이 비공개 Git 저장소에 저장된 경우 Git 호스트와 저장소가 Cloud Build에 연결되어 있는지 확인합니다.

  3. 구성을 배포하고 버전을 만듭니다.

    gcloud infra-manager deployments apply projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
        --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
        --git-source-repo="GIT_REPO" \
        --git-source-directory="DIRECTORY" \
        --git-source-ref="REF" \
        --quota-validation=QUOTA_VALIDATION \
        --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
        --tf-version-constraint=TERRAFORM_VERSION \
        --annotation="ANNOTATION_KEY=ANNOTATION_VALUE"
다음과 같이 바꿉니다.
  • PROJECT_ID: 인프라 관리자가 실행되는 프로젝트 ID입니다.
  • LOCATION: Infra Manager가 실행되는 위치입니다. 유효한 위치 목록은 인프라 관리자 위치를 참고하세요.
  • DEPLOYMENT_ID: 지정된 배포 식별자입니다. 배포 식별자의 제약조건에 관한 자세한 내용은 배포 이름을 참고하세요.
  • SERVICE_ACCOUNT_PROJECT_ID는 서비스 계정의 프로젝트 ID입니다. 일반적으로 Infra Manager가 실행되는 프로젝트와 동일한 프로젝트입니다.
  • SERVICE_ACCOUNT: Infra Manager를 호출하는 데 사용하는 서비스 계정의 이름입니다.
  • GIT_REPO: Git 저장소입니다.
  • DIRECTORY: Terraform 구성이 있는 디렉터리입니다.
  • 선택사항: REF: 구성의 Git 참조입니다. 참조는 선택사항입니다. 참조를 지정하지 않으면 Git 저장소의 기본 구성된 브랜치가 사용됩니다.
  • 선택사항: QUOTA_VALIDATION: 배포를 만들 때 Terraform 구성 파일의 리소스에 대한 할당량 유효성 검사가 사용 설정 또는 적용되는지 여부를 결정하는 값입니다. 가능한 값은 다음과 같습니다.
    • ENABLED: Terraform 구성 파일에서 리소스에 대한 컴퓨팅 할당량 유효성 검사를 사용 설정합니다. 할당량이 부족한 리소스에 대한 가시성을 제공합니다.
    • ENFORCED: Terraform 구성 파일에 정의된 인프라에 사용할 수 있는 할당량이 충분하지 않으면 배포가 실패하도록 할당량 유효성 검사를 적용합니다.

    QUOTA_VALIDATION가 정의되지 않으면 Terraform 구성 파일의 할당량 유효성 검사가 사용 중지됩니다. 기본값입니다. 할당량 유효성 검사는 제한된 Google Cloud 리소스에 적용됩니다. 자세한 내용은 할당량 및 제한을 참고하세요.

  • INPUT_1_NAME 및 INPUT_2_NAME: 기본적으로 정의되지 않은 값을 포함하여 Terraform 구성의 모든 입력 값입니다. 예를 들어 리소스를 배포할 프로젝트를 project_id=my-project로 지정할 수 있습니다.

    모든 입력 값이 구성에서 기본적으로 정의된 경우 이 플래그는 선택사항입니다.

  • 선택사항:TERRAFORM_VERSION: Infra Manager에서 배포를 만들 때 사용할 Terraform 버전입니다. 지원되는 버전 목록은 지원되는 Terraform 버전을 참고하세요. 이 선택적 플래그를 삭제하면 지원되는 최신 Terraform 버전이 사용됩니다.
  • 선택사항: ANNOTATION_KEY 및 ANNOTATION_VALUE는 Infra Manager 배포에 연결할 수 있는 자유 형식 텍스트의 키-값 쌍을 나타냅니다. 주석 및 라벨의 사용 및 제약사항에 관한 자세한 내용은 주석 및 라벨을 참고하세요.

gcloud CLI

이 섹션에서는 로컬 머신에 저장된 Terraform 구성을 사용하는 방법을 설명합니다.

  1. Cloud Shell을 사용하는 경우 구성을 Cloud Shell에 업로드해야 합니다. 자세한 내용은 Cloud Shell로 파일 관리하기를 참고하세요.

  2. 구성을 배포하고 버전을 만듭니다.

    gcloud infra-manager deployments apply projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
        --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
        --local-source="LOCAL_DIRECTORY" \
        --quota-validation=QUOTA_VALIDATION \
        --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
        --tf-version-constraint=TERRAFORM_VERSION \
        --annotation="ANNOTATION_KEY=ANNOTATION_VALUE"
다음과 같이 바꿉니다.
  • PROJECT_ID: 인프라 관리자가 실행되는 프로젝트 ID입니다.
  • LOCATION: Infra Manager가 실행되는 위치입니다. 유효한 위치 목록은 인프라 관리자 위치를 참고하세요.
  • DEPLOYMENT_ID: 지정된 배포 식별자입니다. 배포 식별자의 제약조건에 관한 자세한 내용은 배포 이름을 참고하세요.
  • SERVICE_ACCOUNT_PROJECT_ID는 서비스 계정의 프로젝트 ID입니다. 일반적으로 Infra Manager가 실행되는 프로젝트와 동일한 프로젝트입니다.
  • SERVICE_ACCOUNT: Infra Manager를 호출하는 데 사용하는 서비스 계정의 이름입니다.
  • LOCAL_DIRECTORY: Terraform 구성을 저장하는 로컬 디렉터리입니다. Cloud Shell을 사용하는 경우 구성이 저장되는 Cloud Shell의 디렉터리입니다.
  • 선택사항: QUOTA_VALIDATION: 배포를 만들 때 Terraform 구성 파일의 리소스에 대한 할당량 유효성 검사가 사용 설정 또는 적용되는지 여부를 결정하는 값입니다. 가능한 값은 다음과 같습니다.
    • ENABLED: Terraform 구성 파일에서 리소스에 대한 컴퓨팅 할당량 유효성 검사를 사용 설정합니다. 할당량이 부족한 리소스에 대한 가시성을 제공합니다.
    • ENFORCED: Terraform 구성 파일에 정의된 인프라에 사용할 수 있는 할당량이 충분하지 않으면 배포가 실패하도록 할당량 유효성 검사를 적용합니다.

    QUOTA_VALIDATION가 정의되지 않으면 Terraform 구성 파일의 할당량 유효성 검사가 사용 중지됩니다. 기본값입니다. 할당량 유효성 검사는 제한된 Google Cloud 리소스에 적용됩니다. 자세한 내용은 할당량 및 제한을 참고하세요.

  • INPUT_1_NAME 및 INPUT_2_NAME: 기본적으로 정의되지 않은 값을 포함하여 Terraform 구성의 모든 입력 값입니다. 예를 들어 리소스를 배포할 프로젝트를 project_id=my-project로 지정할 수 있습니다.

    모든 입력 값이 구성에서 기본적으로 정의된 경우 이 플래그는 선택사항입니다.

  • 선택사항:TERRAFORM_VERSION: Infra Manager에서 배포를 만들 때 사용할 Terraform 버전입니다. 지원되는 버전 목록은 지원되는 Terraform 버전을 참고하세요. 이 선택적 플래그를 삭제하면 지원되는 최신 Terraform 버전이 사용됩니다.
  • 선택사항: ANNOTATION_KEY 및 ANNOTATION_VALUE는 Infra Manager 배포에 연결할 수 있는 자유 형식 텍스트의 키-값 쌍을 나타냅니다. 주석 및 라벨의 사용 및 제약사항에 관한 자세한 내용은 주석 및 라벨을 참고하세요.

다음 단계