배치 정책 교체, 삭제, 제거하기

이 문서에서는 배치 정책을 관리하는 방법을 설명합니다. 구체적으로는 다음과 같습니다.

배치 정책을 지정하는 가상 머신(VM) 인스턴스의 속성을 업데이트하여 다음 중 하나를 수행합니다.
- 배치 정책을 다른 기존 배치 정책으로 바꿉니다.
- 배치 정책을 삭제합니다.
더 이상 필요하지 않은 배치 정책을 삭제합니다.

시작하기 전에

배치 정책의 제한사항을 검토합니다.
아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.

Select the tab for how you plan to use the samples on this page:
gcloud
1. Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다.
```
gcloud init
```
  참고: gcloud CLI를 이전에 설치했으면 gcloud components update를 실행하여 최신 버전을 사용할 수 있는지 확인합니다.
2. Set a default region and zone.

필요한 역할

배치 정책을 교체, 삭제, 제거하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자(v1)(roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 배치 정책을 교체, 삭제, 제거하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

배치 정책을 교체, 삭제, 제거하려면 다음 권한이 필요합니다.

VM의 속성을 업데이트하려는 경우: 프로젝트에 대한 compute.instances.update
배치 정책을 삭제하려는 경우: 프로젝트에 대한 compute.resourcePolicies.delete

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

VM에서 배치 정책 바꾸기

gcloud CLI 및 REST를 사용하여 VM에 지정된 배치 정책을 다른 배치 정책으로 바꿀 수 있습니다.

gcloud

VM의 배치 정책을 다른 배치 정책으로 바꾸려면 다음 단계를 수행합니다.

기존 VM의 속성을 내보내려면 gcloud compute instances export 명령어를 사용합니다.
```
gcloud compute instances export VM_NAME \
    --destination=FILE_PATH \
    --zone=ZONE
```
다음을 바꿉니다.
- VM_NAME: 배치 정책을 지정하는 기존 VM의 이름입니다.
- FILE_PATH: VM 구성 파일을 저장할 경로입니다.
- ZONE: VM이 있는 영역입니다.
원하는 텍스트 편집기에서 VM 구성 파일을 엽니다.
배치 정책을 다른 기존 정책으로 바꾸려면 resourcePolicies 필드의 값을 다른 배치 정책으로 바꿉니다.
```
...
resourcePolicies:
- https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy
...
```
VM의 다른 속성을 수정할 수도 있습니다. 자세한 내용은 업데이트할 수 있는 속성을 참조하세요.
VM 속성 업데이트의 나머지 단계를 수행합니다.

REST

VM의 배치 정책을 다른 배치 정책으로 바꾸려면 다음 단계를 수행합니다.

기존 VM의 속성을 내보내려면 instances.get 메서드에 GET 요청을 실행합니다.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
```
다음을 바꿉니다.
- PROJECT_ID: VM이 있는 프로젝트의 ID입니다.
- ZONE: VM이 있는 영역입니다.
- VM_NAME: 배치 정책을 지정하는 기존 VM의 이름입니다.
배치 정책을 다른 기존 정책으로 바꾸려면 resourcePolicies 필드의 값을 다른 배치 정책으로 바꿉니다.
```
{
...
"resourcePolicies": [
  "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy"
],
...
}
```
VM의 다른 속성을 수정할 수도 있습니다. 자세한 내용은 업데이트할 수 있는 속성을 참조하세요.
VM 속성 업데이트의 나머지 단계를 수행합니다.

VM에서 배치 정책 삭제

gcloud CLI 및 REST를 사용하여 VM에 적용된 배치 정책을 삭제할 수 있습니다.

gcloud

VM에서 배치 정책을 삭제하려면 gcloud compute instances remove-resource-policies 명령어를 사용합니다.

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

다음을 바꿉니다.

VM_NAME: 배치 정책을 지정하는 기존 VM의 이름입니다.
POLICY_NAME: VM에 적용된 배치 정책의 이름입니다. 배치 정책 이름을 확인하려면 VM 세부정보를 보고 resourcePolicies 필드를 살펴봅니다.
ZONE: VM이 있는 영역입니다.

REST

VM에서 배치 정책을 삭제하려면 instances.removeResourcePolicies 메서드에 대해 POST 요청을 수행합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

다음을 바꿉니다.

PROJECT_ID: VM이 있는 프로젝트의 ID입니다.
ZONE: VM이 있는 영역입니다.
VM_NAME: 배치 정책을 지정하는 기존 VM의 이름입니다.
REGION: 배치 정책이 있는 리전입니다.
POLICY_NAME: VM에 적용된 배치 정책의 이름입니다. 배치 정책 이름을 확인하려면 VM 세부정보를 보고 resourcePolicies 필드를 살펴봅니다.

배치 정책 삭제

Compute Engine 리소스에 적용되지 않는 경우에만 배치 정책을 삭제할 수 있습니다. 그렇지 않으면 배치 정책을 삭제할 수 없습니다. Compute Engine 리소스에 적용된 배치 정책을 삭제하려면 다음 중 하나를 수행합니다.

정책이 VM에만 적용되고 VM을 유지하려면 다음을 수행합니다.
1. VM에서 배치 정책을 삭제합니다.
2. 배치 정책을 삭제합니다.
그렇지 않은 경우에는 다음 단계를 따라야 합니다.
1. 선택사항: 유지하려는 모든 VM에서 배치 정책을 삭제합니다.
2. 배치 정책이 적용되는 다른 모든 Compute Engine 리소스를 다음 순서대로 삭제합니다.
  1. VM
  2. 예약
  3. 인스턴스 템플릿
3. 배치 정책을 삭제합니다.

gcloud CLI 및 REST를 사용하여 배치 정책을 삭제할 수 있습니다.

gcloud

배치 정책을 삭제하려면 gcloud compute resource-policies delete 명령어를 사용합니다.

gcloud compute resource-policies delete POLICY_NAME \
    --region=REGION

다음을 바꿉니다.

POLICY_NAME: 기존 배치 정책의 이름입니다.
REGION: 배치 정책이 있는 리전입니다.

REST

배치 정책을 삭제하려면 resourcePolicies.delete 메서드에 DELETE 요청을 보냅니다.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

다음을 바꿉니다.

PROJECT_ID: 배치 정책이 저장된 프로젝트의 ID입니다.
REGION: 배치 정책이 있는 리전입니다.
POLICY_NAME: 기존 배치 정책의 이름입니다.

다음 단계

배치 정책을 보는 방법 알아보기
배치 정책을 지정하는 VM을 사용하여 다음 작업을 수행하는 방법 알아보기
- VM의 상태 확인
- VM에 연결