Menggunakan reservasi dengan instance Vertex AI Workbench
Dokumen ini menjelaskan cara menggunakan reservasi Compute Engine untuk mendapatkan tingkat jaminan yang tinggi bahwa instance Vertex AI Workbench Anda memiliki resource virtual machine (VM) yang cukup untuk dijalankan.
Pemesanan adalah fitur Compute Engine. Pemesanan ini membantu memastikan bahwa Anda memiliki resource yang tersedia untuk membuat VM dengan hardware yang sama (memori dan vCPU) dan resource opsional (GPU dan disk SSD Lokal) kapan pun Anda membutuhkannya.
Saat Anda membuat pemesanan, Compute Engine akan memverifikasi bahwa kapasitas yang diminta tersedia di zona yang ditentukan. Jika ya, Compute Engine akan memesan resource, membuat pemesanan, dan hal berikut akan terjadi:
Resource yang dicadangkan akan segera tersedia untuk Anda gunakan, dan tetap tersedia hingga Anda menghapus pemesanan.
Anda akan ditagih untuk resource yang dipesan dengan tarif on-demand yang sama seperti VM yang berjalan, termasuk diskon yang berlaku, hingga pemesanan dihapus. Saat menggunakan pemesanan, VM tidak dikenakan biaya duplikat untuk resource karena pemesanan sudah ditagih untuk biaya resource yang dicadangkan. Untuk mempelajari lebih lanjut, lihat Reservasi 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:
Reservasi Anda harus berupa salah satu dari berikut:
- Dalam project yang sama dengan instance Vertex AI Workbench Anda.
- Dibagikan dengan project yang sama dengan instance Vertex AI Workbench Anda.
Properti VM pada reservasi harus sama persis dengan instance Vertex AI Workbench Anda untuk menggunakan reservasi. Misalnya, jika reservasi menentukan jenis mesin
e2-standard-8
, maka instance Vertex AI Workbench hanya dapat menggunakan reservasi jika juga menggunakan jenis mesine2-standard-8
. Lihat Persyaratan.
Sebelum memulai
- Tinjau persyaratan dan batasan untuk pemesanan.
- Tinjau persyaratan kuota dan batasan untuk pemesanan bersama.
- 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.
-
Compute Admin (
roles/compute.admin
) -
Notebooks Admin (
roles/notebooks.admin
) 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 berupaRESERVATION_ANY
atauRESERVATION_SPECIFIC
RESERVATION_NAME
: nama reservasi Anda saat menggunakan jenisRESERVATION_SPECIFIC
- Untuk pemesanan dalam project yang sama, Anda dapat menggunakan ID pemesanan.
- Untuk reservasi di project lain, Anda harus menggunakan jalur reservasi lengkap.
Resource Compute Engine, termasuk diskon abonemen (CUD) yang berlaku, dengan harga Compute Engine. Biaya ini memiliki label
goog-vertex-ai-product: workbench-instances
pada SKU. Lihat harga Compute Engine.Biaya pengelolaan Vertex AI Workbench selain penggunaan infrastruktur Anda. Lihat harga Vertex AI Workbench.
- Untuk mempelajari lebih lanjut reservasi Compute Engine, lihat Reservasi resource zona Compute Engine.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk menggunakan reservasi dengan instance Vertex AI Workbench, minta administrator Anda untuk memberi Anda peran IAM berikut pada project:
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Membuat pemesanan
Buat reservasi Compute Engine. Pemesanan ini 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:
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
Berhenti menggunakan reservasi Anda
Untuk berhenti menggunakan reservasi, Anda dapat menghapus reservasi Anda.
Jika ingin terus menggunakan reservasi dengan resource lain, tetapi tidak ingin instance Vertex AI Workbench yang ada menggunakannya, Anda harus menghapus instance tersebut.
Penagihan
Saat menggunakan reservasi Compute Engine, Anda akan ditagih untuk hal berikut:
Memecahkan masalah
Untuk menemukan metode dalam mendiagnosis dan menyelesaikan error, terkait dengan penggunaan reservasi dengan instance Vertex AI Workbench, lihat Memecahkan masalah instance Vertex AI Workbench.