Membagikan reservasi Cloud TPU

Dokumen ini menjelaskan cara membagikan pemesanan TPU ke beberapa project. Berbagi pemesanan memungkinkan Anda membuat pemesanan Cloud TPU di satu project (project pemilik) dan menggunakan pemesanan tersebut di project lain (project konsumen) dalam organisasi yang sama dengan project pemilik. Berbagi pemesanan juga memungkinkan Anda menjalankan tugas pelatihan kustom atau prediksi di Vertex AI menggunakan pemesanan TPU.

Project pemilik adalah project tempat Anda membuat reservasi. Project konsumen adalah satu atau beberapa project yang menggunakan pemesanan bersama. Anda dapat membuat VM TPU di project pemilik dan project konsumen menggunakan reservasi di project pemilik.

Untuk mengetahui informasi selengkapnya tentang cara mendapatkan reservasi TPU, lihat Tentang reservasi Cloud TPU.

Batasan

Sebelum Anda mengubah pemesanan TPU, pertimbangkan hal berikut:

  • Anda hanya dapat mengubah pemesanan bersama dari project pemiliknya.

  • Anda hanya dapat mengubah pemesanan sebagai berikut:

Mengonversi pemesanan satu project menjadi pemesanan bersama

Anda dapat mengonversi pemesanan satu project menjadi pemesanan bersama. Mengubah jenis berbagi pemesanan TPU membantu Anda membagikan resource yang dicadangkan ke hingga 100 project di organisasi Anda. Semua project yang berbagi reservasi TPU harus menjadi bagian dari organisasi yang sama.

Sebelum mengonversi pemesanan satu project menjadi pemesanan bersama, pastikan Anda memiliki kuota yang cukup. Ada persyaratan kuota yang berbeda untuk pemesanan bersama dan satu project. Untuk mengetahui informasi selengkapnya, lihat Persyaratan kuota tambahan untuk pemesanan bersama.

Untuk mengaktifkan berbagi reservasi TPU, lakukan hal berikut:

  1. Berikan izin ke project pemilik untuk membuat dan mengubah pemesanan bersama menggunakan perintah gcloud resource-manager org-policies allow:

    gcloud resource-manager org-policies allow \
        compute.sharedReservationsOwnerProjects \
        projects/OWNER_PROJECT_NUMBER --organization=ORGANIZATION_ID

    Ganti kode berikut:

    • OWNER_PROJECT_NUMBER: Nomor project (bukan project ID) dari project di organisasi Anda yang ingin Anda izinkan untuk membuat dan mengubah pemesanan bersama.
    • ORGANIZATION_ID: ID resource organisasi organisasi Anda.
  2. Aktifkan berbagi CUD dengan memperbarui cakupan CUD untuk Penagihan Cloud Anda. Untuk mengetahui petunjuknya, lihat Mengaktifkan berbagi CUD untuk komitmen berbasis resource.

  3. Untuk mengonversi pemesanan satu project menjadi pemesanan bersama, gunakan perintah gcloud compute reservations update dengan flag --share-setting=projects dan --add-share-with:

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

    Ganti kode berikut:

    • RESERVATION_NAME: Nama pemesanan.
    • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
    • CONSUMER_PROJECT_IDS: Daftar ID project yang dipisahkan koma yang dapat menggunakan pemesanan ini. Contoh, project-1,project-2. Anda dapat menyertakan hingga 100 project konsumen. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan sertakan project pemilik. Secara default, project pemilik sudah diizinkan untuk menggunakan reservasi.
    • ZONE: Zona tempat pemesanan berada.

Mengonversi pemesanan bersama menjadi pemesanan satu project

Untuk mengonversi reservasi yang ditargetkan secara khusus dari reservasi bersama menjadi reservasi project tunggal, Anda harus menghentikan atau menghapus semua instance yang menggunakan reservasi di setiap project yang diberi akses ke reservasi tersebut. Persyaratan ini tidak berlaku untuk instance di project pemilik.

Untuk berhenti berbagi pemesanan TPU dengan semua project konsumen, ubah pemesanan bersama menjadi pemesanan satu project menggunakan perintah gcloud compute reservations update dengan flag --share-setting=local:

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

Ganti kode berikut:

  • RESERVATION_NAME: Nama pemesanan.
  • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
  • ZONE: Zona tempat pemesanan berada.

Mengubah project konsumen dalam pemesanan bersama

Untuk menghindari error saat Anda mengubah project konsumen untuk pemesanan bersama, pertimbangkan hal berikut:

  • Penghapusan project: Anda dapat menghapus project konsumen dari pemesanan bersama hanya jika project tersebut tidak menggunakan resource yang dipesan. Untuk menghentikan instance menggunakan reservasi, hentikan atau hapus instance.

  • Penambahan project: Anda dapat mengizinkan project konsumen menggunakan pemesanan bersama hanya jika project tersebut berada dalam organisasi yang sama dengan project pemilik. Untuk memigrasikan project ke organisasi project pemilik, lihat Memigrasikan project di antara resource organisasi dalam dokumentasi Resource Manager.

Menambahkan project ke pemesanan bersama

Untuk menambahkan satu atau beberapa project ke pemesanan bersama, gunakan perintah gcloud compute reservations updatedengan flag --add-share-with:

gcloud compute reservations update RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: Nama pemesanan.
  • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
  • CONSUMER_PROJECT_IDS: Daftar project ID yang dipisahkan koma untuk berbagi reservasi. Contoh, project-1,project-2.
  • ZONE: Zona tempat pemesanan berada.

Menghapus project dari pemesanan bersama

Untuk menghapus satu atau beberapa project dari pemesanan bersama, gunakan perintah gcloud compute reservations updatedengan flag --remove-share-with:

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

Ganti kode berikut:

  • RESERVATION_NAME: Nama pemesanan.
  • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
  • CONSUMER_PROJECT_IDS: Daftar project ID yang dipisahkan koma yang tidak lagi Anda izinkan menggunakan pemesanan bersama ini. Contoh, project-1,project-2.
  • ZONE: Zona tempat pemesanan berada.

Mengganti daftar project yang dapat menggunakan pemesanan bersama

Untuk mengganti daftar project yang dapat menggunakan pemesanan bersama, gunakan perintah gcloud beta compute reservations update dengan flag --share-with:

gcloud beta compute reservations update RESERVATION_NAME \
    --project=OWNER_PROJECT_ID \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: Nama pemesanan.
  • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
  • CONSUMER_PROJECT_IDS: Daftar project ID yang dipisahkan koma untuk berbagi reservasi. Contoh, project-1,project-2.
  • ZONE: Zona tempat pemesanan berada.

Mengizinkan Vertex AI menggunakan reservasi TPU

Anda dapat mengizinkan tugas pelatihan atau tugas prediksi di Vertex AI untuk menggunakan reservasi TPU hanya setelah waktu mulainya.

Untuk mengizinkan Vertex AI menggunakan pemesanan TPU, gunakan perintah gcloud compute reservations update dengan flag --reservation-sharing-policy=ALLOW_ALL:

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

Ganti kode berikut:

  • RESERVATION_NAME: Nama pemesanan.
  • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
  • ZONE: Zona pemesanan.

Melarang Vertex AI menggunakan reservasi TPU

Sebelum Anda melarang Vertex AI menggunakan reservasi TPU, hentikan semua tugas Vertex AI yang menggunakannya. Jika tidak, Anda akan mengalami error.

Untuk melarang Vertex AI menggunakan reservasi TPU, gunakan perintah gcloud compute reservations update dengan flag --reservation-sharing-policy=DISALLOW_ALL:

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

Ganti kode berikut:

  • RESERVATION_NAME: Nama pemesanan.
  • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
  • ZONE: Zona pemesanan.

Mendapatkan informasi tentang reservasi bersama

Anda hanya bisa mendapatkan informasi tentang pemesanan bersama dari project pemiliknya.

Untuk mendapatkan informasi tentang pemesanan bersama, gunakan perintah gcloud compute reservations describe:

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

Ganti kode berikut:

  • RESERVATION_NAME: Nama pemesanan.
  • OWNER_PROJECT_ID: ID project yang berisi pemesanan.
  • ZONE: Zona pemesanan.

Responsnya mirip dengan hal berikut ini:

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

Langkah berikutnya