단일 프로젝트에 대한 예약 만들기

이 문서에서는 동일한 프로젝트의 가상 머신(VM) 인스턴스에서만 사용할 수 있는 단일 프로젝트 예약을 만드는 방법을 설명합니다. 예약에 대한 자세한 내용은 Compute Engine 영역별 리소스 예약을 참조하세요.

예약을 만드는 다른 방법은 다음 페이지를 참조하세요.

  • 현재 프로젝트에 1년 또는 3년 약정이 있으면 예약된 리소스에 해당 약정 사용 할인이 자동으로 적용됩니다. 또한 약정을 구매할 때 예약을 만들고 약정에 연결할 수 있습니다. 자세한 내용은 약정에 예약 연결을 참조하세요.

  • 여러 프로젝트에서 사용할 수 있는 예약을 만들려면 공유 예약 만들기를 참조하세요.

시작하기 전에

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

    이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.

    콘솔

    Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스할 때는 인증을 설정할 필요가 없습니다.

    gcloud

    1. Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다. 

      gcloud init
    2. 기본 리전 및 영역을 설정합니다.

    Terraform

    로컬 개발 환경에서 이 페이지의 Terraform 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.

    1. Google Cloud CLI를 설치합니다.

    2. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다. 

      gcloud init

    3. Google 계정의 로컬 인증 사용자 인증 정보를 만듭니다. 

      gcloud auth application-default login

    자세한 내용은 로컬 개발 환경의 인증 설정를 참조하세요.

    REST

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

      Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다. 

      gcloud init

필요한 역할

단일 프로젝트 예약을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 관리자(roles/compute.admin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 단일 프로젝트 예약을 만드는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

필수 권한

단일 프로젝트 예약을 만들려면 다음 권한이 필요합니다.

  • 프로젝트에 대한 compute.reservations.create 권한
  • 인스턴스 템플릿을 지정하려는 경우: 인스턴스 템플릿에 대한 compute.instanceTemplates.useReadOnly 권한

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

단일 프로젝트 예약 만들기

이 섹션에서는 단일 프로젝트 예약을 만드는 방법을 설명합니다.

예약을 사용하려면 VM에는 예약과 정확히 일치하는 속성이 있어야 합니다. 예약하려는 VM의 속성을 지정하려면 이 문서에서 다음 섹션 중 하나를 선택합니다.

기본적으로 예약은 일치하는 속성이 있는 모든 VM에서 자동으로 사용될 수 있습니다. 예약 사용을 제어하려면 다음 중 하나 이상을 수행합니다.

또한 단일 프로젝트 예약을 만들 때 압축 배치 정책을 지정할 수 있습니다. 압축 배치 정책은 네트워크 지연 시간을 줄이기 위해 가능한 한 서로 가까운 위치에 VM을 배치하도록 지정합니다.

인스턴스 템플릿 지정

인스턴스 템플릿을 지정하여 단일 프로젝트 예약을 만들려면 Google Cloud 콘솔, gcloud CLI, REST를 사용합니다.

콘솔

인스턴스 템플릿을 지정하여 단일 프로젝트 예약을 만들려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 예약 페이지로 이동합니다.

    예약으로 이동

  2. 예약 만들기를 클릭합니다.

    예약 만들기 페이지가 열립니다.

  3. 이름 필드에 예약 이름을 입력합니다.

  4. 리소스를 예약할 리전 및 영역을 선택합니다.

  5. 공유 유형 섹션에서 로컬(기본값)을 클릭합니다.

  6. VM 인스턴스와 함께 사용 섹션에서 다음 옵션 중 하나를 선택합니다.

    • 일치하는 VM에서 이 예약을 자동으로 사용하도록 허용하려면 예약 자동 사용(기본값)을 클릭합니다.

    • 이름을 통해 이 예약을 명시적으로 타겟팅하는 일치하는 VM을 만들 때만 이 예약의 리소스를 소비하려면 특정 예약 선택을 클릭합니다.

  7. VM 인스턴스 수 필드에 예약할 VM 수를 입력합니다.

  8. 머신 구성 섹션에서 다음을 수행합니다.

    1. 기존 인스턴스 템플릿에서 VM의 속성을 지정하려면 인스턴스 템플릿 사용을 선택합니다.

    2. 인스턴스 템플릿 필드에서 원하는 인스턴스 템플릿을 선택합니다. 리전 인스턴스 템플릿을 선택하는 경우 인스턴스 템플릿의 리전 내에서만 리소스를 예약할 수 있습니다.

  9. 자동 삭제 섹션에서는 Compute Engine이 특정 날짜 및 시간에 예약을 자동으로 삭제하도록 자동 삭제 옵션을 사용 설정할 수 있습니다. 예약 자동 삭제는 예약 사용을 중지할 때 불필요한 비용이 발생하는 것을 방지하는 데 유용할 수 있습니다.

  10. 예약을 만들려면 만들기를 클릭합니다.

    예약 페이지가 열립니다. 단일 프로젝트 예약을 만드는 데 최대 1분이 걸릴 수 있습니다.

gcloud

인스턴스 템플릿을 지정해서 단일 프로젝트 예약을 만들려면 gcloud compute reservations create 명령어를 사용합니다.

선택적인 플래그 없이 인스턴스 템플릿을 지정하여 단일 프로젝트 예약을 만들려면 다음 명령어를 실행합니다.

gcloud compute reservations create RESERVATION_NAME \
    --project=PROJECT_ID \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

다음을 바꿉니다.

  • RESERVATION_NAME: 생성할 예약의 이름입니다.

  • PROJECT_ID: 인스턴스 템플릿이 있고 리소스를 예약하려는 프로젝트의 ID입니다.

  • LOCATION: 인스턴스 템플릿의 위치입니다. 다음 값 중 하나를 지정합니다.

    • 전역 인스턴스 템플릿의 경우: global

    • 리전 인스턴스 템플릿의 경우: regions/REGION. REGION을 인스턴스 템플릿이 있는 리전으로 바꿉니다. 리전 인스턴스 템플릿을 지정하는 경우 인스턴스 템플릿의 리전 내에서만 VM을 예약할 수 있습니다.

  • INSTANCE_TEMPLATE_NAME: 기존 인스턴스 템플릿의 이름입니다. 압축 배치 정책이 포함된 인스턴스 템플릿을 지정할 경우 --require-specific-reservation 플래그를 지정해야 합니다. 즉, 정확히 이 예약을 타겟팅하는 VM만 이를 사용할 수 있습니다.

  • NUMBER_OF_VMS: 예약할 VM 수입니다.

  • ZONE: 리소스를 예약할 영역입니다.

예를 들어 전역 인스턴스 템플릿을 지정하여 us-central1-a 영역에 10개의 VM에 대한 예약을 만들려면 다음 명령어를 실행합니다.

gcloud compute reservations create my-reservation \
    --project=example-project \
    --source-instance-template=projects/example-project/global/example-instance-template \
    --vm-count=10 \
    --zone=us-central1-a

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

  • 정확히 이 예약을 타겟팅하는 VM만 이를 사용할 수 있도록 지정하려면 --require-specific-reservation 플래그를 포함합니다.

    gcloud compute reservations create example-reservation \
    --require-specific-reservation \
    ...

  • Compute Engine이 예약을 자동으로 삭제하도록 하려면 다음 방법 중 하나를 선택합니다.

    • 특정 날짜 및 시간에 예약을 삭제하려면 gcloud beta compute reservations create 명령어를 사용하고 --delete-at-time 플래그를 포함합니다.

      gcloud beta compute reservations create reservation-example \
    --delete-at-time=DELETE_AT_TIME \
    ...

      DELETE_AT_TIME을 다음과 같은 RFC 3339 타임스탬프 형식의 날짜와 시간으로 바꿉니다.

      YYYY-MM-DDTHH:MM:SSOFFSET

      다음을 바꿉니다.

      • YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.

      • HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.

      • OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.

    • 특정 기간이 지난 후 예약을 삭제하려면 gcloud beta compute reservations create 명령어를 사용하고 --delete-after-duration 플래그를 포함합니다.

      gcloud beta compute reservations create reservation-example \
    --delete-after-duration=DELETE_AFTER_DURATION \
    ...

      DELETE_AFTER_DURATION을 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.

REST

인스턴스 템플릿을 지정하여 단일 프로젝트 예약을 만들려면 reservations.insert 메서드에 POST 요청을 실행합니다.

선택적인 플래그 없이 인스턴스 템플릿을 지정하여 단일 프로젝트 예약을 만들려면 다음 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  }
}

다음을 바꿉니다.

  • PROJECT_ID: 인스턴스 템플릿이 있고 리소스를 예약하려는 프로젝트의 ID입니다.

  • ZONE: 리소스를 예약할 영역입니다.

  • RESERVATION_NAME: 생성할 예약의 이름입니다.

  • NUMBER_OF_VMS: 예약할 VM 수입니다.

  • LOCATION: 인스턴스 템플릿의 위치입니다. 다음 값 중 하나를 지정합니다.

    • 전역 인스턴스 템플릿의 경우: global

    • 리전 인스턴스 템플릿의 경우: regions/REGION. REGION을 인스턴스 템플릿이 있는 리전으로 바꿉니다. 리전 인스턴스 템플릿을 지정하는 경우 인스턴스 템플릿의 리전 내에서만 VM을 예약할 수 있습니다.

  • INSTANCE_TEMPLATE_NAME: 기존 인스턴스 템플릿의 이름입니다. If you specify an instance template that includes a 압축 배치 정책이 포함된 인스턴스 템플릿을 지정할 경우 요청 본문에 specificReservationRequired 필드를 지정하고 true로 설정해야 합니다. 즉, 정확히 이 예약을 타겟팅하는 VM만 이를 사용할 수 있습니다.

예를 들어 전역 인스턴스 템플릿을 지정하여 us-central1-a 영역에 10개의 VM에 대한 예약을 만들려면 다음 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "specificReservation": {
    "count": "10",
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template"
  }
}

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

  • 정확히 이 예약을 타겟팅하는 VM만 이를 사용할 수 있도록 지정하려면 요청 본문에 specificReservationRequired 필드를 포함하고 true로 설정합니다.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservationRequired": true,
  ...
}

  • Compute Engine이 예약을 자동으로 삭제하도록 하려면 다음 방법 중 하나를 선택합니다.

    • 특정 날짜 및 시간에 예약을 삭제하려면 beta.reservations.insert 메서드에 POST 요청을 실행합니다. 요청 본문에 deleteAtTime 필드를 포함합니다.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAtTime": "DELETE_AT_TIME",
  ...
}

      DELETE_AT_TIME을 다음과 같은 RFC 3339 타임스탬프 형식의 날짜와 시간으로 바꿉니다.

      YYYY-MM-DDTHH:MM:SSOFFSET

      다음을 바꿉니다.

      • YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.

      • HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.

      • OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.

    • 특정 기간이 지난 후 예약을 삭제하려면 beta.reservations.insert 메서드에 POST 요청을 합니다. 요청 본문에 deleteAfterDuration 필드를 포함합니다.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  ...
}

      DELETE_AFTER_DURATION를 초 단위의 기간으로 바꿉니다. 예를 들어 86,400초(1일)의 경우 86400을 지정합니다.

속성 직접 지정

속성을 직접 지정하여 단일 프로젝트 예약을 만들려면 Google Cloud 콘솔, gcloud CLI, Terraform, REST를 사용합니다.

콘솔

단일 프로젝트 예약을 만들려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 예약 페이지로 이동합니다.

    예약으로 이동

  2. 예약 만들기를 클릭합니다.

    예약 만들기 페이지가 열립니다.

  3. 이름 필드에 예약 이름을 입력합니다.

  4. 리소스를 예약할 리전 및 영역을 선택합니다.

  5. 공유 유형 섹션에서 로컬(기본값)을 클릭합니다.

  6. VM 인스턴스와 함께 사용 섹션에서 다음 옵션 중 하나를 선택합니다.

    • 일치하는 VM에서 이 예약을 자동으로 사용하도록 허용하려면 예약 자동 사용(기본값)을 클릭합니다.

    • 이름을 통해 이 예약을 명시적으로 타겟팅하는 일치하는 VM을 만들 때만 이 예약의 리소스를 소비하려면 특정 예약 선택을 클릭합니다.

  7. VM 인스턴스 수 필드에 보존하려는 VM 수를 입력합니다.

  8. 머신 구성 섹션에서 머신 유형 지정을 선택한 후 다음을 지정합니다.

    1. 머신 계열, 시리즈, 머신 유형 필드에서 머신 계열, 시리즈, 머신 유형을 선택합니다.

    2. 선택사항: 최소 CPU 플랫폼 또는 GPU를 지정하려면 다음을 수행합니다.

      1. CPU 플랫폼 및 GPU 섹션을 확장하려면 확장 화살표를 클릭합니다.

      2. 선택사항: 최소 CPU 플랫폼을 지정하려면 CPU 플랫폼 목록에서 옵션을 선택합니다.

      3. 선택사항: GPU를 추가하려면 GPU 추가를 클릭합니다. 그런 다음 GPU 유형과 GPU 수 필드에서 각 VM의 GPU 유형과 수를 선택합니다.

    3. 선택사항: 로컬 SSD를 추가하려면 다음을 수행합니다.

      1. 디스크 수 필드에서 각 VM의 로컬 SSD 수를 선택합니다.

      2. 인터페이스 유형 필드에서 로컬 SSD의 인터페이스를 선택합니다.

    4. 선택사항: 요구사항을 충족하는 예약에 대한 압축 배치 정책을 지정하려면 그룹 배치 정책 선택 또는 만들기 목록을 클릭하고 나열한 후 다음 중 하나를 수행합니다.

      • 이 예약에서 지정할 압축 배치 정책을 만들려면 다음 단계를 수행합니다.

        1. 그룹 배치 정책 만들기를 클릭합니다.

          그룹 배치 정책 만들기 창이 나타납니다.

        2. 정책 이름 필드에 정책 이름을 입력합니다.

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

          압축 배치 정책을 만드는 데 몇 초 정도 걸릴 수 있습니다.

      • 그렇지 않으면 기존 압축 배치 정책을 선택합니다.

  9. 자동 삭제 섹션에서는 Compute Engine이 특정 날짜 및 시간에 예약을 자동으로 삭제하도록 자동 삭제 옵션을 사용 설정할 수 있습니다. 예약 자동 삭제는 예약 사용을 중지할 때 불필요한 비용이 발생하는 것을 방지하는 데 유용할 수 있습니다.

  10. 예약을 만들려면 만들기를 클릭합니다.

    단일 프로젝트 예약을 만드는 데 다소 시간이 걸릴 수 있습니다. 이 작업을 수행하면 예약 페이지로 리디렉션됩니다.

gcloud

단일 프로젝트 예약을 만들려면 gcloud compute reservations create 명령어를 사용합니다.

선택적 플래그 없이 단일 프로젝트 예약을 만들려면 다음 명령어를 실행합니다.

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --project=PROJECT_ID \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

다음을 바꿉니다.

  • RESERVATION_NAME: 생성할 예약의 이름입니다.

  • MACHINE_TYPE: 각 VM에 사용할 머신 유형. 다음 값 중 하나를 지정합니다.

    • 사전 정의된 머신 유형: MACHINE_FAMILY-standard-CPUS

    • 커스텀 머신 유형: MACHINE_FAMILY-custom-CPUS-MEMORY. 커스텀 머신 유형을 지정하기 전에 커스텀 머신 유형의 VM에 대한 제한사항을 검토하세요.

    다음을 바꿉니다.

    • MACHINE_FAMILY: 머신 계열

    • CPUS: vCPU의 수

    • MEMORY: 예약 VM의 총 메모리. 메모리는 256MB의 배수여야 하며 MB 단위로 제공되어야 합니다.

    예를 들어 vCPU가 4개이고 메모리가 5GB(5,120MB)인 N2 커스텀 머신 유형을 지정하려면 n2-custom-4-5120을 지정합니다.

  • PROJECT_ID: 리소스를 예약하려는 프로젝트의 ID입니다.

  • NUMBER_OF_VMS: 예약할 VM 수입니다.

  • ZONE: 리소스를 예약할 영역입니다.

예를 들어 us-central1-a 영역에서 각각 vCPU 4개가 포함된 N2 사전 정의된 머신 유형을 사용하는 10개의 VM에 대해 예약을 만들려면 다음 명령어를 실행합니다.

gcloud compute reservations create my-reservation \
    --machine-type=n2-standard-4 \
    --project=example-project \
    --vm-count=10 \
    --zone=us-central1-a

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

  • 예약된 각 VM에 그래픽 처리 장치(GPU)를 추가하려면 --accelerator 플래그를 포함합니다.

    gcloud compute reservations create my-reservation \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE
    ...

    다음을 바꿉니다.

    • NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수

    • ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형

    예약에서 지정한 머신 유형이 지정한 GPU 유형을 지원하는지, 그리고 리소스를 예약하려는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 예약 만들기가 실패합니다.

  • 예약된 각 VM에 하나 이상의 로컬 SSD를 추가하려면 하나 이상의 --local-ssd 플래그를 포함합니다. 로컬 SSD를 최대 24개까지 지정할 수 있습니다. 각 로컬 SSD는 375GB입니다.

    예약을 만들 때 2개의 로컬 SSD를 지정하려면 2개의 --local-ssd 플래그를 포함합니다.

    gcloud compute reservations create my-reservation \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    ...

    INTERFACE_1 및 INTERFACE_2를 로컬 SSD에 사용하려는 인터페이스 유형으로 바꿉니다. 다음 값 중 하나를 지정합니다.

    • NVME 디스크 인터페이스: nvme.

    • SCSI 디스크 인터페이스: scsi

    예약된 VM에 지정되는 머신 유형이 선택된 디스크 인터페이스를 지원하는지 확인합니다. 그렇지 않으면 예약 만들기가 실패합니다. 자세한 내용은 디스크 인터페이스 선택 방법을 참조하세요.

  • 영역의 기본 CPU 플랫폼 대신 예약된 VM에 특정 최소 CPU 플랫폼이 사용되도록 하려면 --min-cpu-platform 플래그를 포함합니다.

    gcloud compute reservations create my-reservation \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    ...

    MIN_CPU_PLATFORM을 최소 CPU 플랫폼으로 바꿉니다. 리소스를 예약하는 영역에서 CPU 플랫폼을 사용할 수 있는지 확인하려면 영역별 사용 가능한 CPU 플랫폼을 확인합니다.

  • 정확히 이 예약을 타겟팅하는 VM만 이를 사용할 수 있도록 지정하려면 --require-specific-reservation 플래그를 포함합니다.

    gcloud compute reservations create example-reservation \
    --require-specific-reservation \
    ...

  • VM 간에 낮은 네트워크 지연 시간을 위해 압축 배치 정책을 지정하려면 --resource-policies=policy 플래그를 포함합니다.

    gcloud compute reservations create example-reservation \
    --resource-policies=policy=COMPACT_PLACEMENT_POLICY_NAME \
    --require-specific-reservation \
    ...

    COMPACT_PLACEMENT_POLICY_NAME을 기존 압축 배치 정책의 이름으로 바꿉니다. 또한 압축 배치 정책을 지정하는 단일 프로젝트 예약을 만들 때 오류를 방지하려면 다음을 지정해야 합니다.

    • 압축 배치 정책에 지원되는 머신 유형을 지정합니다.

    • 압축 배치 정책이 있는 리전 내 영역을 지정합니다.

    • --require-specific-reservation 플래그 즉, 정확히 이 예약을 타겟팅하는 VM만 이를 사용할 수 있습니다.

  • Compute Engine이 예약을 자동으로 삭제하도록 하려면 다음 방법 중 하나를 선택합니다.

    • 특정 날짜 및 시간에 예약을 삭제하려면 gcloud beta compute reservations create 명령어를 사용하고 --delete-at-time 플래그를 포함합니다.

      gcloud beta compute reservations create reservation-example \
    --delete-at-time=DELETE_AT_TIME \
    ...

      DELETE_AT_TIME을 다음과 같은 RFC 3339 타임스탬프 형식의 날짜와 시간으로 바꿉니다.

      YYYY-MM-DDTHH:MM:SSOFFSET

      다음을 바꿉니다.

      • YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.

      • HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.

      • OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.

    • 특정 기간이 지난 후 예약을 삭제하려면 gcloud beta compute reservations create 명령어를 사용하고 --delete-after-duration 플래그를 포함합니다.

      gcloud beta compute reservations create reservation-example \
    --delete-after-duration=DELETE_AFTER_DURATION \
    ...

      DELETE_AFTER_DURATION을 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.

Terraform

단일 프로젝트 예약을 만들려면 google_compute_reservation Terraform 리소스를 사용합니다.

compute/reservation/create_local/main.tf 

resource "google_compute_reservation" "default" {
  name = "gce-reservation-local"
  zone = "us-central1-a"

  /**
   * To specify a single-project reservation, omit the share_settings block
   * (default) or set the share_type field to LOCAL.
   */
  share_settings {
    share_type = "LOCAL"
  }

  specific_reservation {
    count = 1
    instance_properties {
      machine_type = "n2-standard-2"
    }
  }

  /**
   * To let VMs with affinity for any reservation consume this reservation, omit
   * the specific_reservation_required field (default) or set it to false.
   */
  specific_reservation_required = false
}

Terraform 사용 방법에 대한 자세한 내용은 Google Cloud에서 Terraform 사용하기를 참조하세요.

REST

단일 프로젝트 예약을 만들려면 reservations.insert 메서드에 POST 요청을 실행합니다.

선택적인 필드 없이 단일 프로젝트 예약을 만들려면 다음 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  }
}

다음을 바꿉니다.

  • PROJECT_ID: 리소스를 예약하려는 프로젝트의 ID입니다.

  • ZONE: 리소스를 예약할 영역입니다.

  • RESERVATION_NAME: 생성할 예약의 이름입니다.

  • NUMBER_OF_VMS: 예약할 VM 수입니다.

  • MACHINE_TYPE: 각 VM에 사용할 머신 유형. 다음 값 중 하나를 지정합니다.

    • 사전 정의된 머신 유형: MACHINE_FAMILY-standard-CPUS

    • 커스텀 머신 유형: MACHINE_FAMILY-custom-CPUS-MEMORY. 커스텀 머신 유형을 지정하기 전에 커스텀 머신 유형의 VM에 대한 제한사항을 검토하세요.

    다음을 바꿉니다.

    • MACHINE_FAMILY: 머신 계열

    • CPUS: vCPU의 수

    • MEMORY: 예약 VM의 총 메모리. 메모리는 256MB의 배수여야 하며 MB 단위로 제공되어야 합니다.

    예를 들어 vCPU가 4개이고 메모리가 5GB(5,120MB)인 N2 커스텀 머신 유형을 지정하려면 n2-custom-4-5120을 지정합니다.

예를 들어 us-central1-a 영역에서 각각 vCPU 4개가 포함된 N2 사전 정의된 머신 유형을 사용하는 10개의 VM에 대해 예약을 만들려면 다음 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "specificReservation": {
    "count": "10",
    "instanceProperties": {
      "machineType": "n2-standard-4",
    }
  }
}

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

  • 예약된 각 VM에 그래픽 처리 장치(GPU)를 추가하려면 요청 본문에 guestAccelerators 필드를 포함합니다.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      ...
    },
    ...
  }
}

    다음을 바꿉니다.

    • NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수

    • ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형

    예약에서 지정한 머신 유형이 지정한 GPU 유형을 지원하는지, 그리고 리소스를 예약하려는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 예약 만들기가 실패합니다.

  • 예약된 각 VM에 하나 이상의 로컬 SSD를 추가하려면 요청 본문에 localSsds 필드를 포함합니다. 로컬 SSD를 최대 24개까지 지정할 수 있습니다. 각 로컬 SSD는 375GB입니다.

    예를 들어 예약을 만들 때 2개의 로컬 SSD를 지정하려면 다음을 지정합니다.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      ...
    },
    ...
  }
}

    INTERFACE_1 및 INTERFACE_2를 각 로컬 SSD에서 사용할 인터페이스 유형으로 바꿉니다. 다음 값 중 하나를 지정합니다.

    • NVME 디스크 인터페이스: NVME.

    • SCSI 디스크 인터페이스: SCSI

    예약된 VM에 지정되는 머신 유형이 선택된 디스크 인터페이스를 지원하는지 확인합니다. 그렇지 않으면 예약 만들기가 실패합니다. 자세한 내용은 디스크 인터페이스 선택 방법을 참조하세요.

  • 영역의 기본 CPU 플랫폼 대신 예약된 VM에 특정 최소 CPU 플랫폼이 사용되도록 하려면 요청 본문에 minCpuPlatform 필드를 포함합니다.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservation": {
    "instanceProperties": {
      "minCpuPlatform": "MIN_CPU_PLATFORM",
      ...
    },
    ...
  }
}

    MIN_CPU_PLATFORM을 최소 CPU 플랫폼으로 바꿉니다. 리소스를 예약하는 영역에서 CPU 플랫폼을 사용할 수 있는지 확인하려면 영역별 사용 가능한 CPU 플랫폼을 확인합니다.

  • 예약된 VM 간에 네트워크 지연 시간을 줄이기 위해 압축 배치 정책을 지정하려면 요청 본문에 resourcePolicies 필드를 포함합니다.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "resourcePolicies": {
    "policy" : "projects/example-project/regions/REGION/resourcePolicies/COMPACT_PLACEMENT_POLICY_NAME"
  },
  "specificReservationRequired": true,
  ...
}

    다음을 바꿉니다.

    • REGION: 압축 배치 정책이 있는 리전입니다. 배치 정책의 동일한 리전 내에서 리소스를 예약해야 합니다. 그렇지 않으면 예약 만들기가 실패합니다.

    • COMPACT_PLACEMENT_POLICY_NAME: 기존 압축 배치 정책의 이름입니다.

    또한 압축 배치 정책을 지정하는 단일 프로젝트 예약을 만들 때 오류를 방지하려면 다음을 지정해야 합니다.

  • 정확히 이 예약을 타겟팅하는 VM만 이를 사용할 수 있도록 지정하려면 요청 본문에 specificReservationRequired 필드를 포함하고 true로 설정합니다.

    POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "specificReservationRequired": true,
  ...
}

  • Compute Engine이 예약을 자동으로 삭제하도록 하려면 다음 방법 중 하나를 선택합니다.

    • 특정 날짜 및 시간에 예약을 삭제하려면 beta.reservations.insert 메서드에 POST 요청을 실행합니다. 요청 본문에 deleteAtTime 필드를 포함합니다.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAtTime": "DELETE_AT_TIME",
  ...
}

      DELETE_AT_TIME을 다음과 같은 RFC 3339 타임스탬프 형식의 날짜와 시간으로 바꿉니다.

      YYYY-MM-DDTHH:MM:SSOFFSET

      다음을 바꿉니다.

      • YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.

      • HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.

      • OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.

    • 특정 기간이 지난 후 예약을 삭제하려면 beta.reservations.insert 메서드에 POST 요청을 합니다. 요청 본문에 deleteAfterDuration 필드를 포함합니다.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations

{
  "name": "example-reservation",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  },
  ...
}

      DELETE_AFTER_DURATION를 초 단위의 기간으로 바꿉니다. 예를 들어 86,400초(1일)의 경우 86400을 지정합니다.

문제 해결

예약 생성 문제 해결 방법 알아보기

다음 단계