Cloud TPU 예약 공유

이 문서에서는 예약 공유를 사용 설정하는 방법을 설명합니다. 예약 공유를 사용하면 한 프로젝트(소비자 프로젝트)에서 TPU VM을 만들고 다른 프로젝트(소유자 프로젝트)가 소유한 예약을 사용할 수 있습니다. 예약 공유를 사용하면 TPU 예약을 사용하여 Vertex AI에서 커스텀 학습 또는 예측 작업을 실행할 수도 있습니다.

소유자 프로젝트는 예약을 생성한 프로젝트입니다. 소비자 프로젝트는 예약을 공유하는 하나 이상의 프로젝트입니다. 소유자 프로젝트의 예약을 사용하여 소유자 프로젝트와 소비자 프로젝트에서 TPU VM을 만들 수 있습니다.

TPU 예약을 획득하는 방법에 대한 자세한 내용은 Cloud TPU 예약 정보를 참고하세요.

제한사항

TPU 예약을 공유하기 전에 다음 사항을 고려하세요.

공유 예약은 소유자 프로젝트에서만 수정할 수 있습니다.
캘린더 모드의 단기 예약 또는 장기 예약은 다음과 같은 경우에만 수정할 수 있습니다.
- 예약은 시작 시간 이후에만 수정할 수 있습니다.
- Vertex AI의 작업에서 예약을 사용할 수 있도록 허용하거나 허용하지 않도록 예약만 수정할 수 있습니다.

다음 섹션에서는 예약 공유 방법을 설명합니다.

다른 프로젝트가 소유한 예약을 사용하여 소비자 프로젝트에서 TPU VM을 만들 수 있습니다. TPU 예약을 공유하는 모든 프로젝트는 동일한 조직에 속해야 합니다.

TPU 예약 공유 사용 설정하기:

gcloud resource-manager org-policies allow 명령어를 사용하여 소유자 프로젝트에 공유 예약을 만들고 수정할 수 있는 권한을 부여합니다.
```
gcloud resource-manager org-policies allow \
    compute.sharedReservationsOwnerProjects \
    projects/OWNER_PROJECT_NUMBER --organization=ORGANIZATION_ID
```
다음을 바꿉니다.
- OWNER_PROJECT_NUMBER: 공유 예약을 만들고 수정하는 것을 허용할 조직 프로젝트의 프로젝트 번호(프로젝트 ID가 아님)
- ORGANIZATION_ID: 조직의 조직 리소스 ID
Google Cloud 콘솔을 통해 CUD 공유를 사용 설정합니다. 자세한 내용은 리소스 기반 약정에 CUD 공유 사용 설정을 참고하세요.

참고: 새 CUD 공유 약정 범위가 적용되는 데 최대 24시간이 소요될 수 있습니다.
공유를 사용 설정하려면 gcloud beta compute reservations update 명령어를 --share-setting=projects 및 --share-with 플래그와 함께 사용합니다.
```
gcloud beta compute reservations update RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
다음을 바꿉니다.
- RESERVATION_NAME: 예약 이름
- OWNER_PROJECT_ID: 예약이 포함된 프로젝트의 ID
- CONSUMER_PROJECT_IDS: 이 예약을 사용할 수 있는 프로젝트의 ID를 쉼표로 구분한 목록. 예를 들면 project-1,project-2입니다. 소비자 프로젝트를 최대 100개까지 포함할 수 있습니다. 이러한 프로젝트는 소유자 프로젝트와 동일한 조직에 있어야 합니다. 소유자 프로젝트를 포함하지 마세요. 기본적으로 소유자 프로젝트는 이미 예약을 사용할 수 있습니다.
- ZONE: 예약이 있는 영역

TPU 예약 공유 사용 중지

소비자 프로젝트 목록과의 TPU 예약 공유를 사용 중지하려면 --share-setting=projects 및 --remove-share-with 플래그와 함께 gcloud beta compute reservations update 명령어를 사용합니다.

gcloud compute reservations update RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --share-setting=projects \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

다음을 바꿉니다.

RESERVATION_NAME: 예약 이름
OWNER_PROJECT_ID: 예약이 포함된 프로젝트의 ID
CONSUMER_PROJECT_IDS: 예약 공유를 중지할 프로젝트의 쉼표로 구분된 ID 목록. 예를 들면 project-1,project-2입니다.
ZONE: 예약이 있는 영역

모든 소비자 프로젝트와의 TPU 예약 공유를 사용 중지하려면 --share-setting=local 플래그와 함께 gcloud beta compute reservations update 명령어를 사용하여 예약을 로컬 예약으로 변경합니다.

gcloud beta compute reservations update RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --share-setting=local \
    --zone=ZONE

다음을 바꿉니다.

RESERVATION_NAME: 예약 이름
OWNER_PROJECT_ID: 예약이 포함된 프로젝트의 ID
ZONE: 예약이 있는 영역

Vertex AI의 학습 또는 예측 작업에서 시작 시간 이후에만 캘린더 모드의 단기 예약 또는 장기 예약을 사용할 수 있습니다.

Vertex AI에서 TPU 예약을 사용하도록 허용하려면 --reservation-sharing-policy=ALLOW_ALL 플래그와 함께 gcloud beta compute reservations update 명령어를 사용합니다.

gcloud beta compute reservations update RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --zone=ZONE \
    --reservation-sharing-policy=ALLOW_ALL

다음을 바꿉니다.

RESERVATION_NAME: 예약 이름
OWNER_PROJECT_ID: 예약이 포함된 프로젝트의 ID
ZONE: 예약의 영역

Vertex AI에서 TPU 예약 사용 금지

Vertex AI에서 TPU 예약을 사용하지 못하도록 하기 전에 예약을 사용하는 Vertex AI 작업을 중지합니다. 그렇지 않으면 오류가 발생합니다.

Vertex AI에서 TPU 예약을 사용하지 못하도록 하려면 --reservation-sharing-policy=DISALLOW_ALL 플래그와 함께 gcloud beta compute reservations update 명령어를 사용합니다.

gcloud beta compute reservations update RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --zone=ZONE \
    --reservation-sharing-policy=DISALLOW_ALL

다음을 바꿉니다.

RESERVATION_NAME: 예약 이름
OWNER_PROJECT_ID: 예약이 포함된 프로젝트의 ID
ZONE: 예약의 영역

공유 예약에 대한 정보 가져오기

공유 예약에 대한 정보는 소유자 프로젝트에서만 가져올 수 있습니다.

공유 예약에 대한 정보를 가져오려면 gcloud compute reservations describe 명령어를 사용합니다.

gcloud compute reservations describe RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --zone=ZONE

다음을 바꿉니다.

RESERVATION_NAME: 예약 이름
OWNER_PROJECT_ID: 예약이 포함된 프로젝트의 ID
ZONE: 예약의 영역

응답은 다음 예시와 유사합니다.

aggregateReservation:
[...]
name: RESERVATION_NAME
reservationSharingPolicy:
  serviceShareType: ALLOW_ALL
resourceStatus: {}
selfLink: https://www.googleapis.com/compute/v1/projects/OWNER_PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
shareSettings:
  projectMap:
    'CONSUMER_PROJECT_1':
      projectId: 'CONSUMER_PROJECT_1'
    'CONSUMER_PROJECT_2':
      projectId: 'CONSUMER_PROJECT_2'
  shareType: SPECIFIC_PROJECTS
specificReservationRequired: true
status: READY
zone: https://www.googleapis.com/compute/v1/projects/OWNER_PROJECT_ID/zones/ZONE

Cloud TPU 예약 공유

제한사항