更新代理程式定義

請選擇您想要的叢集及 IBM Cloud Object Storage，以更新您的代理程式設定。

1. 登入 IBM Cloud控制台。
2. 點擊選單圖示>平台自動化>Schematics>擴充。
   • 選取代理程式:
     • 選取 動作 > 編輯代理程式
     • 您可以依照需求來編輯 說明、叢集、COS 實例名稱、COS 儲存區名稱、COS 儲存區地區或 代理程式版本。
3. 按一下 更新並驗證，以驗證叢集及 IBM Cloud Object Storage 配置。
4. 按一下 部署 以重新部署代理程式。

透過 CLI 建立代理定義

選取您要在其中更新及管理代理程式的 IBM Cloud 地區。 執行 ibmcloud target -r <region>，以設定 CLI region 指令。 選取與 agent create 指令上指定的 location 相同的地區。 IBM Cloud Object Storage 儲存區位置的格式必須是 eu-gb 或 us-south，而不是城市名稱。 欲了解更多信息，請參閱 代理更新 命令。

範例

ibmcloud schematics agent update --id AGENT_ID --location <us-south> --agent-location <us-south> --version <1.0.0> --infra-type <ibm_kubernetes> --cluster-id <cg3fgvad0dak571xxx> --cluster-resource-group <Default> --cos-instance-name <agent-cos-instance> --cos-bucket <agent-cos-bucket> --cos-location <us-east> --resource-group <Default>

驗證代理程式更新

ibmcloud schematics agent get --id agent-ga-prod-cli-jan-10.soA.cd1c

透過 API 更新代理

遵循 步驟 來更新 IAM 存取記號，並透過 API 向 Schematics 進行鑑別。 如需相關資訊，請參閱 更新代理程式。

如果 IAM 記號已過期，您可以使用 refresh_token 來取得新的 IAM 存取記號。

範例

  curl -X PUT https://schematics.cloud.ibm.com/v2/agents/{agent_id} \-H 'Authorization: Bearer <Auth Key>' -H 'X-Feature-Agents: true' -H 'refresh_token: <refresh_token> ' -d '{
  "name": "AgentName",
  "description": "New Description",
  "resource_group": "Default",
  "tags": [
  "tag1",
  "tag2"
  ],
  "version": "v1.0.0",
  "schematics_location": "us-south",
  "agent_location": "us-south",
  "agent_infrastructure": {
  "infra_type": "ibm_kubernetes",
  "cluster_id": "cluster_id",
  "cluster_resource_group": "Default",
  "cos_instance_name": "blueprint_basic",
  "cos_bucket_name": "sample_bucket_name",
  "cos_bucket_region": "us-east"
  },
  "agent_inputs": [
  {
  "name": "ibmcloud_api_key",
  "value": "<api_key of the account where cluster and cos are present>",
  "metadata": {
  "secure": true
  }
  },
  {
  "name": "ansible_pull_ibmcloud_api_key",
  "value": "jenkins api_key for pulling agents images",
  "metadata": {
  "secure": true
  }
  },
  {
  "name": "devops_api_key",
  "value": "api_key where you want to create agent and run fvts",
  "metadata": {
  "secure": true
  }
  }
  ],
  "user_state": {
  "state": "enable"
  }
  }'

驗證已順利建立代理程式定義，如輸出中所示。 記錄要在後續指令中使用的代理程式 ID。 例如，agentb1-gsmforvpc.soA.115c。

現在，使用 agent ID 執行 agent deploy API，以更新部署代理程式的 Schematics 工作區。 agent deploy 作業會同時啟動 agent validate 及 agent deploy 作業，以設定代理程式。

語法

  PUT /v2/agents/<enter your agentID>/deploy HTTP/1.1
  Host: schematics.cloud.ibm.com
  Content-Type: application/json
  Authorization: Bearer