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

  1. 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.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Enable the Compute Engine and Notebooks APIs.

    Enable the APIs

    4.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Enable the Compute Engine and Notebooks APIs.

    Enable the APIs

    6.

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:

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

  1. 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 Anda
  • LOCATION adalah zona tempat instance Anda berada.
  • INSTANCE_NAME: nama instance Anda
  • MACHINE_TYPE: jenis mesin instance Anda
  • RESERVATION_TYPE: jenis reservasi; harus RESERVATION_ANY atau RESERVATION_SPECIFIC
  • RESERVATION_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
Jika berhasil, isi respons akan berisi instance Operation.

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