透過中繼資料管理功能

本頁面說明如何修改執行個體的中繼資料鍵/值組合，管理部分 Gemini Enterprise Agent Platform Workbench 執行個體功能。

中繼資料鍵

如要瞭解功能及其對應的中繼資料鍵，請參閱下表。

開機指令碼執行順序

如果 Agent Platform Workbench 執行個體使用多個開機指令碼，這些指令碼會依下列順序執行：

1. startup-script：在初始啟動後，每次啟動時都會先執行。
2. startup-script-url：在初始啟動後，每次啟動時第二個執行。
3. workbench-startup-scripts：在 Compute Engine 開機指令碼 (startup-script 和 startup-script-url) 完成後執行。
4. post-startup-script：在 workbench-startup-scripts 完成後執行。

請注意，如果是 post-startup-script 中繼資料鍵，您必須以 Cloud Storage URI 的形式提供指令碼。您無法直接將指令碼內容做為值。

由 Compute Engine 管理的中繼資料

部分中繼資料鍵是由 Compute Engine 預先定義。詳情請參閱「預先定義的中繼資料索引鍵」。

受保護的中繼資料鍵

部分中繼資料鍵僅保留給系統使用。如果您為這些中繼資料索引鍵指派值，新值會遭到系統值覆寫。

保留的中繼資料鍵包括但不限於：

• agent-health-check-interval-seconds
• agent-health-check-path
• cos-update-strategy
• custom-container-image
• custom-container-payload
• data-disk-uri
• dataproc-allow-custom-clusters
• dataproc-cluster-name
• dataproc-configs
• dataproc-default-subnet
• dataproc-locations-list
• dataproc-machine-types-list
• dataproc-notebooks-url
• dataproc-region
• dataproc-service-account
• disable-check-xsrf
• euc-enabled
• framework
• generate-diagnostics-bucket
• generate-diagnostics-file
• generate-diagnostics-options
• google-logging-enabled
• image-url
• install-monitoring-agent
• install-nvidia-driver
• installed-extensions
• last_updated_diagnostic
• last_updated_diagnostics
• notebooks-api
• notebooks-api-version
• notebooks-examples-location
• notebooks-location
• proxy-backend-id
• proxy-byoid-url
• proxy-mode
• proxy-status
• proxy-url
• proxy-user-mail
• report-container-health
• report-event-url
• report-notebook-metrics
• report-system-health
• report-system-status
• resource-url
• restriction
• serial-port-logging-enable
• service-account-mode
• shutdown-script
• title
• use-collaborative
• user-data
• version

建立具有特定中繼資料的執行個體

您可以使用 Google Cloud 控制台、Google Cloud CLI、Terraform 或 Notebooks API，建立具有特定中繼資料的 Agent Platform Workbench 執行個體。

gcloud workbench instances create INSTANCE_NAME --metadata=KEY=VALUE

resource "google_workbench_instance" "default" {
  name     = "workbench-instance-example"
  location = "us-central1-a"

  gce_setup {
    machine_type = "n1-standard-1"
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances"
    }
    metadata = {
      key = "value"
    }
  }
}

更新執行個體的中繼資料

您可以使用 Google Cloud 控制台、Google Cloud CLI、Terraform 或 Notebooks API，更新 Agent Platform Workbench 執行個體的中繼資料。

gcloud workbench instances update INSTANCE_NAME --metadata=KEY=VALUE

resource "google_workbench_instance" "default" {
  name     = "workbench-instance-example"
  location = "us-central1-a"

  gce_setup {
    machine_type = "n1-standard-1"
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances"
    }
    metadata = {
      key = "updated_value"
    }
  }
}

移除執行個體的中繼資料

您可以使用 Google Cloud 控制台、Google Cloud CLI、Terraform 或 Notebooks API，從 Agent Platform Workbench 執行個體中移除中繼資料。

gcloud workbench instances update INSTANCE_NAME --metadata=KEY

resource "google_workbench_instance" "default" {
  name     = "workbench-instance-example"
  location = "us-central1-a"

  gce_setup {
    machine_type = "n1-standard-1"
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances"
    }
    metadata = {
    }
  }
}