Membuat versi spesifik instance Agent Platform Workbench

Halaman ini menjelaskan cara membuat versi tertentu dari instance Gemini Enterprise Agent Platform Workbench.

Alasan Anda perlu membuat versi tertentu

Untuk memastikan bahwa instance Agent Platform Workbench memiliki software yang kompatibel dengan kode atau aplikasi Anda, sebaiknya buat versi tertentu.

Image instance Agent Platform Workbench sering diupdate, dan versi tertentu dari software dan paket yang diinstal sebelumnya bervariasi dari satu versi ke versi lainnya.

Untuk mempelajari versi Agent Platform Workbench tertentu lebih lanjut, lihat catatan rilis Agent Platform.

Setelah membuat versi instance Agent Platform Workbench tertentu, Anda dapat mengupgradenya. Dengan mengupgrade instance, paket dan software yang telah diinstal sebelumnya akan diupdate. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade lingkungan instance.

Sebelum memulai

  1. Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

Membuat versi tertentu

Anda dapat membuat versi instance Agent Platform Workbench tertentu menggunakan Google Cloud konsol atau Google Cloud CLI.

Konsol

Untuk membuat versi instance Agent Platform Workbench tertentu, lakukan langkah berikut:

  1. Saat Anda membuat instance, di bagian Environment, pilih Use a previous version.

  2. Klik daftar Version, lalu pilih versi. Versi diberi nomor dalam bentuk M diikuti dengan nomor rilis, misalnya, M123.

  3. Selesaikan dialog pembuatan instance selanjutnya, lalu klik Create.

    Agent Platform Workbench membuat sebuah instance dan otomatis memulainya. Saat instance siap digunakan, Agent Platform Workbench akan mengaktifkan link Open JupyterLab.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • INSTANCE_NAME: nama instance Agent Platform Workbench Anda; harus diawali dengan huruf, diikuti dengan maksimal 62 huruf kecil, angka, atau tanda hubung (-), dan tidak boleh diakhiri dengan tanda hubung
  • PROJECT_ID: project ID Anda
  • LOCATION: zona tempat Anda ingin menempatkan instance
  • VM_IMAGE_NAME: nama image; untuk mendapatkan daftar nama image yang tersedia, gunakan perintah get-config
  • MACHINE_TYPE: jenis mesin VM instance Anda

  • METADATA: metadata kustom yang akan diterapkan ke instance ini; misalnya, guna menentukan post-startup-script, Anda dapat menggunakan tag metadata post-startup-script, dalam format: --metadata=post-startup-script=gs://BUCKET_NAME/hello.sh

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud workbench instances create INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --vm-image-project="cloud-notebooks-managed" \
    --vm-image-name=VM_IMAGE_NAME \
    --machine-type=MACHINE_TYPE \
    --metadata=METADATA

Windows (PowerShell)

gcloud workbench instances create INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --vm-image-project="cloud-notebooks-managed" `
    --vm-image-name=VM_IMAGE_NAME `
    --machine-type=MACHINE_TYPE `
    --metadata=METADATA

Windows (cmd.exe)

gcloud workbench instances create INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --vm-image-project="cloud-notebooks-managed" ^
    --vm-image-name=VM_IMAGE_NAME ^
    --machine-type=MACHINE_TYPE ^
    --metadata=METADATA

Untuk mengetahui informasi lebih lanjut tentang perintah untuk membuat an instance dari command line, baca dokumentasi gcloud CLI.

Agent Platform Workbench membuat sebuah instance dan otomatis memulainya. Saat instance siap digunakan, Agent Platform Workbench akan mengaktifkan link Open JupyterLab di Google Cloud konsol.

Langkah berikutnya