일관성 그룹 관리

이 문서에서는 일관성 그룹을 관리하는 방법을 설명합니다. 일관성 그룹은 동일한 리전 또는 영역에 있는 여러 디스크 간에 복제를 조정하는 리소스 정책입니다.

일관성 그룹에 대한 자세한 내용은 Persistent Disk 비동기 복제 정보를 참조하세요.

제한사항

  • 단독 테넌트 노드의 디스크에 대해서는 일관성 그룹이 지원되지 않습니다.
  • 일관성 그룹에는 최대 128개의 디스크가 있을 수 있습니다.
  • 일관성 그룹의 모든 디스크는 일관성 그룹 리소스 정책과 동일한 프로젝트에 있어야 합니다.
  • 일관성 그룹의 모든 디스크는 영역 디스크의 경우 동일한 영역에 있거나 리전 디스크의 경우 동일한 영역 쌍에 있어야 합니다.
  • 일관성 그룹에는 기본 디스크 또는 보조 디스크 중 하나만 포함될 수 있습니다.
  • 디스크가 복제되는 동안에는 기본 디스크를 일관성 그룹에 추가하거나 이 그룹에서 삭제할 수 없습니다. 기본 디스크를 일관성 그룹에 추가하거나 삭제하려면 먼저 복제를 중지해야 합니다. 언제든지 보조 디스크를 일관성 그룹에 추가하거나 삭제할 수 있습니다.
  • 서로 다른 일관성 그룹에 있는 디스크 최대 16개 또는 일관성 그룹에 있지 않은 디스크를 VM에 연결할 수 있습니다. 일관성 그룹이 동일한 디스크는 디스크 한도 16개에 대해 하나의 디스크로 계산됩니다.

시작하기 전에

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

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공하는 사용자 인증 정보를 사용합니다.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      자세한 내용은 Google Cloud 인증 문서의 REST 사용 인증을 참조하세요.

일관성 그룹 만들기

여러 디스크 간에 복제를 조정하려면 기본 디스크와 동일한 리전에 일관성 그룹을 만듭니다. 디스크 클론을 조정해야 하는 경우 보조 디스크와 동일한 리전에 일관성 그룹을 만듭니다.

Google Cloud 콘솔, Google Cloud CLI 또는 REST를 사용하여 일관성 그룹을 만듭니다.

콘솔

다음을 수행하여 일관성 그룹을 만듭니다.

  1. Google Cloud 콘솔에서 비동기 복제 페이지로 이동합니다.

    비동기 복제로 이동

  2. 일관성 그룹 탭을 클릭합니다.

  3. 일관성 그룹 만들기를 클릭합니다.

  4. 이름 필드에 일관성 그룹의 이름을 입력합니다.

  5. 리전 필드에서 디스크가 있는 리전을 선택합니다. 기본 디스크를 일관성 그룹에 추가하려면 기본 리전을 선택합니다. 일관성 그룹에 보조 디스크를 추가하려면 보조 리전을 선택합니다.

  6. 만들기를 클릭합니다.

gcloud

gcloud compute resource-policies create disk-consistency-group 명령어를 사용하여 일관성 그룹을 만듭니다.

gcloud compute resource-policies create disk-consistency-group CONSISTENCY_GROUP_NAME \
    --region=REGION

다음을 바꿉니다.

  • CONSISTENCY_GROUP_NAME: 일관성 그룹의 이름입니다.
  • REGION: 일관성 그룹의 리전입니다. 기본 디스크를 일관성 그룹에 추가하려면 기본 리전을 사용하세요. 일관성 그룹에 보조 디스크를 추가하려면 보조 리전을 사용하세요.

REST

resourcePolicies.insert 메서드를 사용하여 일관성 그룹을 만듭니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
 "name": "CONSISTENCY_GROUP_NAME",
 "diskConsistencyGroupPolicy": {
  }
}

다음을 바꿉니다.

  • PROJECT: 일관성 그룹이 포함된 프로젝트입니다.
  • REGION: 일관성 그룹의 리전입니다. 기본 디스크를 일관성 그룹에 추가하려면 기본 디스크와 동일한 리전을 사용합니다. 보조 디스크를 일관성 그룹에 추가하려면 보조 디스크와 동일한 리전을 사용합니다.
  • CONSISTENCY_GROUP_NAME: 일관성 그룹의 이름입니다.

일관성 그룹의 디스크 보기

Google Cloud 콘솔, Google Cloud CLI 또는 REST를 사용하여 일관성 그룹의 디스크를 확인합니다.

콘솔

다음을 수행하여 일관성 그룹에 포함된 디스크를 확인합니다.

  1. Google Cloud 콘솔에서 비동기 복제 페이지로 이동합니다.

    비동기 복제로 이동

  2. 일관성 그룹 탭을 클릭합니다.

  3. 디스크를 보려는 일관성 그룹의 이름을 클릭합니다. 일관성 그룹 관리 페이지가 열립니다.

  4. 일관성 그룹 구성원 섹션을 보고 일관성 그룹에 포함된 모든 디스크를 확인합니다.

gcloud

gcloud compute disks list 명령어를 사용하여 일관성 그룹에 포함된 디스크를 확인합니다.

gcloud compute disks list \
    --LOCATION_FLAG=LOCATION \
    --filter=resourcePolicies=CONSISTENCY_GROUP_NAME

다음을 바꿉니다.

  • LOCATION_FLAG: 일관성 그룹의 디스크에 대한 위치 플래그입니다. 일관성 그룹의 디스크가 리전 디스크이면 --region을 사용합니다. 일관성 그룹의 디스크가 영역 디스크이면 --zone을 사용합니다.
  • LOCATION: 일관성 그룹에 있는 디스크의 리전 또는 영역입니다. 리전 디스크의 경우 리전을 사용합니다. 영역 디스크의 경우 영역을 사용합니다.
  • CONSISTENCY_GROUP_NAME: 일관성 그룹의 이름입니다.

REST

다음 메서드 중 하나와 함께 쿼리 필터를 사용하여 일관성 그룹의 디스크를 확인합니다.

  • disks.get 메서드를 사용하여 일관성 그룹의 영역 디스크를 확인합니다.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME

  • regionDisks.get 메서드를 사용하여 일관성 그룹의 리전 디스크를 확인합니다.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME

다음을 바꿉니다.

  • PROJECT: 일관성 그룹이 포함된 프로젝트입니다.
  • ZONE: 일관성 그룹의 디스크 영역입니다.
  • REGION: 일관성 그룹의 디스크 리전입니다.
  • CONSISTENCY_GROUP_NAME: 일관성 그룹의 이름입니다.

일관성 그룹에 디스크 추가

기본 디스크를 일관성 그룹에 추가하려면 복제를 시작하기 전에 일관성 그룹에 디스크를 추가해야 합니다. 언제든지 보조 디스크를 일관성 그룹에 추가할 수 있습니다. 일관성 그룹의 모든 디스크는 영역 디스크의 경우 동일한 영역에 있거나 리전 디스크의 경우 동일한 영역 쌍에 있어야 합니다.

Google Cloud 콘솔, Google Cloud CLI, REST를 사용하여 일관성 그룹에 디스크를 추가합니다.

콘솔

다음을 수행하여 디스크를 일관성 그룹에 추가합니다.

  1. Google Cloud 콘솔에서 비동기 복제 페이지로 이동합니다.

    비동기 복제로 이동

  2. 일관성 그룹 탭을 클릭합니다.

  3. 디스크를 추가할 일관성 그룹의 이름을 클릭합니다. 일관성 그룹 관리 페이지가 열립니다.

  4. 디스크 할당을 클릭합니다. 디스크 할당 페이지가 열립니다.

  5. 일관성 그룹에 추가할 디스크를 선택합니다.

  6. 디스크 할당을 클릭합니다. 메시지가 표시되면 추가를 클릭합니다.

gcloud

gcloud compute disks add-resource-policies 명령어를 사용하여 디스크를 일관성 그룹에 추가합니다.

gcloud compute disks add-resource-policies DISK_NAME \
    --LOCATION_FLAG=LOCATION \
    --resource-policies=CONSISTENCY_GROUP

다음을 바꿉니다.

  • DISK_NAME: 일관성 그룹에 추가할 디스크의 이름입니다.
  • LOCATION_FLAG: 디스크의 위치 플래그입니다. 리전 디스크의 경우 --region을 사용합니다. 영역 디스크의 경우 --zone을 사용합니다.
  • LOCATION: 디스크의 리전 또는 영역입니다. 리전 디스크의 경우 리전을 사용합니다. 영역 디스크의 경우 영역을 사용합니다.
  • CONSISTENCY_GROUP: 일관성 그룹의 URL입니다. 예를 들면 projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME입니다.

REST

다음 메서드 중 하나를 사용하여 디스크를 일관성 그룹에 추가합니다.

  • disks.addResourcePolicies 메서드를 사용하여 영역 디스크를 일관성 그룹에 추가합니다.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/addResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

  • regionDisks.addResourcePolicies 메서드를 사용하여 리전 디스크를 일관성 그룹에 추가합니다.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/addResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

다음을 바꿉니다.

  • PROJECT: 디스크가 포함된 프로젝트입니다.
  • LOCATION: 디스크의 영역 또는 리전입니다. 영역 디스크의 경우 영역을 사용합니다. 리전 디스크의 경우 리전을 사용합니다.
  • DISK_NAME: 일관성 그룹에 추가할 디스크의 이름입니다.
  • CONSISTENCY_GROUP: 일관성 그룹의 URL입니다. 예를 들면 projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME입니다.

일관성 그룹에서 디스크 삭제

일관성 그룹에서 디스크를 삭제하려면 먼저 디스크에 대해 복제를 중지해야 합니다.

Google Cloud 콘솔, Google Cloud CLI 또는 REST를 사용하여 일관성 그룹에서 디스크를 삭제합니다.

콘솔

다음을 수행하여 일관성 그룹에서 기본 디스크를 삭제합니다.

  1. Google Cloud 콘솔에서 비동기 복제 페이지로 이동합니다.

    비동기 복제로 이동

  2. 일관성 그룹 탭을 클릭합니다.

  3. 디스크를 추가할 일관성 그룹의 이름을 클릭합니다. 일관성 그룹 관리 페이지가 열립니다.

  4. 일관성 그룹에서 삭제할 디스크를 선택합니다.

  5. 디스크 삭제를 클릭합니다. 메시지가 표시되면 삭제를 클릭합니다.

gcloud

gcloud compute disks remove-resource-policies 명령어를 사용하여 일관성 그룹에서 디스크를 삭제합니다.

gcloud compute disks remove-resource-policies DISK_NAME \
    --LOCATION_FLAG=LOCATION \
    --resource-policies=CONSISTENCY_GROUP

다음을 바꿉니다.

  • DISK_NAME: 일관성 그룹에서 삭제할 디스크의 이름입니다.
  • LOCATION_FLAG: 디스크의 위치 플래그입니다. 리전 디스크의 경우 --region을 사용합니다. 영역 디스크의 경우 --zone을 사용합니다.
  • LOCATION: 디스크의 리전 또는 영역입니다. 리전 디스크의 경우 리전을 사용합니다. 영역 디스크의 경우 영역을 사용합니다.
  • CONSISTENCY_GROUP: 일관성 그룹의 URL입니다. 예를 들면 projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME입니다.

REST

영역 디스크의 경우 disks.removeResourcePolicies 메서드 또는 리전 디스크의 경우 regionDisks.removeResourcePolicies 메서드를 사용하여 일관성 그룹에서 디스크를 삭제합니다.

  • 일관성 그룹에서 영역 디스크를 삭제합니다.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/removeResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

  • 일관성 그룹에서 리전 디스크를 삭제합니다.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/removeResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

다음을 바꿉니다.

  • PROJECT: 디스크가 포함된 프로젝트입니다.
  • LOCATION: 디스크의 영역 또는 리전입니다. 영역 디스크의 경우 영역을 사용합니다. 리전 디스크의 경우 리전을 사용합니다.
  • DISK_NAME: 일관성 그룹에서 삭제할 디스크의 이름입니다.
  • CONSISTENCY_GROUP: 일관성 그룹의 URL입니다. 예를 들면 projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME입니다.

일관성 그룹 삭제

Google Cloud 콘솔, Google Cloud CLI 또는 REST를 사용하여 일관성 그룹을 삭제합니다.

콘솔

다음을 수행하여 일관성을 삭제합니다.

  1. Google Cloud 콘솔에서 비동기 복제 페이지로 이동합니다.

    비동기 복제로 이동

  2. 일관성 그룹 탭을 클릭합니다.

  3. 삭제할 일관성 그룹을 선택합니다.

  4. 삭제를 클릭합니다. 일관성 그룹 삭제 창이 열립니다.

  5. 삭제를 클릭합니다.

gcloud

gcloud compute resource-policies delete 명령어를 사용하여 리소스 정책을 삭제합니다.

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

다음을 바꿉니다.

  • CONSISTENCY_GROUP: 일관성 그룹의 이름입니다.
  • REGION: 일관성 그룹의 리전입니다.

REST

resourcePolicies.delete 메서드를 사용하여 일관성을 삭제합니다.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

다음을 바꿉니다.

  • PROJECT: 일관성 그룹이 포함된 프로젝트입니다.
  • REGION: 일관성 그룹의 리전입니다.
  • CONSISTENCY_GROUP: 일관성 그룹의 이름입니다.

다음 단계