共用 Cloud TPU 預訂

本文說明如何啟用預訂共用功能。預留項目共用功能可讓您在一個專案 (用戶專案) 中建立 TPU VM,並使用另一個專案 (擁有者專案) 擁有的預留項目。您也可以透過預留項目共用功能,使用 TPU 預留項目在 Vertex AI 中執行自訂訓練或預測工作。

擁有者專案是您建立預留項目的專案。消費者專案是指共用預留項目的專案。您可以在擁有者專案和消費者專案中,使用擁有者專案中的預留項目建立 TPU VM。

如要進一步瞭解如何取得 TPU 預訂,請參閱「關於 Cloud TPU 預訂」。

限制

分享 TPU 預訂項目之前,請先考量以下事項:

  • 您只能透過擁有者專案修改共用預留項目。

  • 你可以透過日曆模式修改短期預訂,或僅修改長期預訂,方法如下:

    • 預訂開始時間過後,你才能修改預訂。

    • 您只能修改預留項目,允許或禁止 Vertex AI 中的工作使用。

共用 Cloud TPU 預訂

以下各節說明分享預訂資訊的不同方法。

啟用 TPU 預留項目共用功能

您可以在用戶專案中建立 TPU VM,並使用其他專案擁有的預留項目。共用 TPU 預留項目的所有專案都必須屬於同一個機構

如要啟用 TPU 預留項目共用功能,請按照下列步驟操作:

  1. 使用 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
  2. 透過 Google Cloud 控制台啟用 CUD 共用功能。如需操作說明,請參閱「為以資源為準的約期啟用 CUD 分享功能」。

  3. 如要啟用共用功能,請使用 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 預訂項目,請使用 gcloud beta compute reservations update 指令,並加上 --share-setting=projects--remove-share-with 標記:

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 預留項目,請使用 gcloud beta compute reservations update 指令--share-setting=local 標記,將預留項目變更為本機預留項目:

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 使用 TPU 預留項目

您可以允許 Vertex AI 中的訓練預測工作,在日曆模式中消耗短期預留項目,或僅在開始時間過後消耗長期預留項目。

如要允許 Vertex AI 使用 TPU 預留項目,請使用 gcloud beta compute reservations update 指令搭配 --reservation-sharing-policy=ALLOW_ALL 旗標:

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 預留項目,請使用 gcloud beta compute reservations update 指令搭配 --reservation-sharing-policy=DISALLOW_ALL 旗標:

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

後續步驟