Menggunakan reservasi dengan instance Vertex AI Workbench
Untuk memastikan resource VM tersedia saat instance Vertex AI Workbench membutuhkannya, Anda dapat menggunakan reservasi Compute Engine. Pemesanan memberikan tingkat jaminan yang tinggi dalam mendapatkan kapasitas untuk resource zona Compute Engine.
Batasan dan persyaratan
Semua batasan pemesanan Compute Engine berlaku saat instance Vertex AI Workbench menggunakan pemesanan. Lihat Cara kerja pemesanan.
Selain itu, saat menggunakan reservasi dengan instance Vertex AI Workbench, batasan dan persyaratan berikut berlaku:
Menggunakan reservasi Compute Engine dengan instance Vertex AI Workbench sedang dalam pratinjau pribadi. Untuk meminta akses, lihat halaman permintaan akses.
Diskon abonemen tidak berlaku.
Penggunaan reservasi dengan Vertex AI Workbench hanya tersedia melalui Notebooks API. Penggunaan reservasi dengan Vertex AI Workbench menggunakan konsol Google Cloud tidak didukung.
Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Compute Engine and Notebooks APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Compute Engine and Notebooks APIs.
Peran yang diperlukan
Untuk memastikan bahwa akun pengguna Anda memiliki izin yang diperlukan untuk menggunakan reservasi dengan instance Vertex AI Workbench, minta administrator untuk memberi akun pengguna Anda peran IAM berikut di project:
-
Compute Admin (
roles/compute.admin
) -
Notebooks Admin (
roles/notebooks.admin
)
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun pengguna Anda melalui peran khusus atau peran bawaan lainnya.
Membuat pemesanan
Buat reservasi Compute Engine. Pemesanan dapat berupa pemesanan satu project atau pemesanan bersama. Untuk informasi selengkapnya, lihat dokumen berikut:
Reservasi dapat mencakup akselerator GPU.
Menggunakan reservasi dengan instance baru
Anda dapat menambahkan reservasi saat membuat instance Vertex AI Workbench baru menggunakan REST API.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_ID
: project ID AndaLOCATION
adalah zona tempat instance Anda berada.INSTANCE_NAME
: nama instance AndaMACHINE_TYPE
: jenis mesin instance AndaRESERVATION_TYPE
: jenis reservasi; harus RESERVATION_ANY atau RESERVATION_SPECIFICRESERVATION_NAME
: nama reservasi Anda saat menggunakan jenis RESERVATION_SPECIFIC- Untuk pemesanan dalam project yang sama, Anda dapat menggunakan ID pemesanan.
- Untuk reservasi di project lain, Anda harus menggunakan jalur reservasi lengkap.
Metode HTTP dan URL:
POST https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances?instanceId=INSTANCE_NAME
Isi JSON permintaan:
{ "gce_setup": { "machine_type": "MACHINE_TYPE", "reservation_affinity": { "consume_reservation_type": "RESERVATION_TYPE", "key": "compute.googleapis.com/reservation-name", "values": ["RESERVATION_NAME"] } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances?instanceId=INSTANCE_NAME"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances?instanceId=INSTANCE_NAME" | Select-Object -Expand Content
Untuk menggunakan reservasi apa pun,
{
"gce_setup": {
"machine_type": "MACHINE_TYPE",
"reservation_affinity": {
"consume_reservation_type": "RESERVATION_ANY"
}
}
}
Berhenti menggunakan reservasi Anda
Untuk berhenti menggunakan reservasi, Anda dapat menghapus reservasi.
Jika ingin terus menggunakan reservasi dengan resource lain, tetapi tidak ingin instance Vertex AI Workbench yang ada menggunakannya, Anda harus menghapus instance tersebut.
Penagihan
Resource VM Compute Engine yang direservasi ditagih oleh Vertex AI Workbench saat instance Vertex AI Workbench berjalan, dan ditagih oleh Compute Engine saat resource VM tidak digunakan oleh Vertex AI Workbench.
Memecahkan masalah
Untuk menemukan metode dalam mendiagnosis dan menyelesaikan error, yang terkait dengan penggunaan reservasi dengan instance Vertex AI Workbench, lihat Memecahkan masalah instance Vertex AI Workbench.
Langkah berikutnya
- Untuk mempelajari reservasi Compute Engine lebih lanjut, lihat Pemesanan resource zona Compute Engine.