エージェント定義の更新

任意のクラスターと IBM Cloud Object Storage を選択して、エージェントの設定を更新してください。

1. IBM Cloudコンソールにログインします。
2. メニューアイコンの >Platform Automation>Schematics>Extensions をクリックします。
   • エージェントを選択します。
     • 「アクション」 > 「エージェントの編集」 を選択します。
     • 要件に応じて、 「説明」、 クラスター、 COS インスタンス名、 COS バケット名、 COS バケット・リージョン、または エージェント・バージョン を編集できます。
3. 「更新および検証」 をクリックして、クラスターおよび IBM Cloud Object Storage 構成を検証します。
4. 「デプロイ」 をクリックして、エージェントを再デプロイします。

CLIによるエージェント定義の作成

エージェントを更新および管理する IBM Cloud リージョンを選択します。 ibmcloud target -r <region> を実行して、 CLI リージョン・コマンド を設定します。 agent create コマンドで指定した location と同じリージョンを選択します。 IBM Cloud Object Storage バケットの場所は、市区町村名ではなく、 eu-gb または us-south の形式でなければなりません。 詳細については、agent update コマンドを参照してください。

例

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