IBM Cloud Docs
正在更新代理程序

正在更新代理程序

更新当前所选 Schematics 区域中的代理程序配置以直接在云基础结构中工作。 更新代理程序不会验证或部署代理程序。 选择要更新的代理程序版本。 您可以分析活动日志并恢复更新。

以下是必须使用代理升级的情况。

  • 通过Schematics纳入问题、特征或易受攻击的图像。 例如,您使用的代理程序版本为 1.0.0。 如果Schematics发布了 v1.0.x,您可以使用代理更新升级 v1.0.0- v1.1.1
  • 更新代理程序元数据,例如 namedescriptiontagsresource groupversionagent_metadata 属性。
  • 您可以使用 agent update 将更新后的版本撤销为其现有版本。

在已部署代理的工作区中,无法通过 terraform initterraform planterraform apply 对已部署代理进行代理更新。

准备工作

查看并选择要更新的 代理版本

更新代理程序定义

选择群集和 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-gbus-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

通过应用程序接口更新代理

遵循 步骤 以更新 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"
  }
  }'

验证是否已成功创建代理程序定义,如输出中所示。 记录要在后续命令中使用的代理程序标识。 例如,agentb1-gsmforvpc.soA.115c

现在,使用 agent ID 运行 agent deploy API 以更新用于部署代理程序的 Schematics 工作空间。 agent deploy 操作将启动 agent validateagent deploy 操作以设置代理程序。

语法

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

代理版本历史

查找Schematics每个版本的更改摘要。代理。 请确保更新您的Schematics代理,以便使用所有可用功能。代理的最新版本,以便使用所有可用功能。

Schematics代理版本历史
版本 发布日期 更改
1.4.0 2025 年 4 月 25 日 Schematics 代理版本 v1.4.0 支持 地区。 ca-tor
1.3.1 2025年2月28日 修复了Windows系统凭据中UI中 Ansible 库存生成的问题。
1.3.0 2024年10月30日 支持 schematics-agent-ansible-job,而不是现有的 schematics-ansible-job 和Terraform 1.9
1.2.0 2024年9月23日 支持 Terraform version 1.5version 1.6
1.1.1 2024 年 7 月 23 日 增强了代理删除超时时间,并修复了代理部署问题。
1.1.0 2024 年 3 月 19 日 已添加对Schematics的支持代理的Red Hat OpenShift支持。Kubernetes Service。
1.0.0 2024 年 1 月 10 日 Schematics对代理的支持已普遍可用(GA),并提供全面的生产支持。 更多信息,请参阅 版本说明

后续步骤