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:
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.
Aktifkan berbagi CUD dengan memperbarui cakupan CUD untuk Penagihan Cloud Anda. Untuk mengetahui petunjuknya, lihat Mengaktifkan berbagi CUD untuk komitmen berbasis resource.
Untuk mengonversi pemesanan satu project menjadi pemesanan bersama, gunakan perintah
gcloud compute reservations updatedengan flag--share-setting=projectsdan--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