建立特定版本的執行個體

本頁說明如何建立特定版本的 Gemini Enterprise Agent Platform Workbench 執行個體。

為什麼要建立特定版本

為確保 Agent Platform Workbench 執行個體搭載的軟體與程式碼或應用程式相容，您可能需要建立特定版本。

Agent Platform Workbench 執行個體映像檔會經常更新，預先安裝的軟體和套件特定版本也會因版本而異。

如要進一步瞭解特定 Agent Platform Workbench 版本，請參閱 Agent Platform 版本資訊。

建立特定版本的 Agent Platform Workbench 執行個體後，即可升級。升級執行個體會更新預先安裝的軟體和套件。 詳情請參閱「升級執行個體環境」。

事前準備

  1. 登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

  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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

建立特定版本

您可以使用 Google Cloud 控制台或 Google Cloud CLI，建立特定版本的 Agent Platform Workbench 執行個體。

控制台

如要建立特定版本的 Agent Platform Workbench 執行個體，請按照下列步驟操作：

  1. 建立執行個體時，請在「環境」部分選取「使用舊版」。

  2. 按一下「版本」清單，然後選取版本。版本編號的格式為 M，後面接著發布編號，例如 M123。

  3. 完成例項建立對話方塊的其餘部分，然後按一下「建立」。

    Agent Platform Workbench 會建立執行個體並自動啟動。執行個體可供使用時，Agent Platform Workbench 會啟用「Open JupyterLab」(開啟 JupyterLab) 連結。

gcloud

使用下列任何指令資料之前，請先替換以下項目：

  • INSTANCE_NAME：Agent Platform Workbench 執行個體的名稱；開頭須為英文字母，後面最多可接 62 個小寫英文字母、數字或連字號 (-)，但結尾不得為連字號
  • PROJECT_ID：專案 ID
  • LOCATION：執行個體所在的可用區
  • VM_IMAGE_NAME：映像檔名稱。如要取得可用映像檔名稱清單，請使用 get-config 指令
  • MACHINE_TYPE：執行個體 VM 的機型

  • METADATA：要套用至這個執行個體的自訂中繼資料；舉例來說，如要指定開機後指令碼，可以使用 post-startup-script 中繼資料標記，格式如下：--metadata=post-startup-script=gs://BUCKET_NAME/hello.sh

執行下列指令：

Linux、macOS 或 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

如要進一步瞭解如何透過指令列建立執行個體的指令，請參閱 gcloud CLI 說明文件。

Agent Platform Workbench 會建立執行個體並自動啟動。執行個體可供使用時，Agent Platform Workbench 會在 Google Cloud 控制台中啟用「Open JupyterLab」連結。

後續步驟