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 mesin e2-standard-8. Lihat Persyaratan.

Sebelum memulai

  1. Tinjau persyaratan dan batasan untuk pemesanan.
  2. Tinjau persyaratan kuota dan batasan untuk pemesanan bersama.
  3. 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.
  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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Enable the Compute Engine and Notebooks APIs.

    Enable the APIs

  8. 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:

    • 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 berupa 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 berisi instance Operation.

    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:

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

    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.

    Langkah berikutnya