正在更新代理程序
更新当前所选 Schematics 区域中的代理程序配置以直接在云基础结构中工作。 更新代理程序不会验证或部署代理程序。 选择要更新的代理程序版本。 您可以分析活动日志并恢复更新。
以下是必须使用代理升级的情况。
- 通过Schematics纳入问题、特征或易受攻击的图像。 例如,您使用的代理程序版本为
1.0.0
。 如果Schematics发布了v1.0.x
,您可以使用代理更新升级v1.0.0
-v1.1.1
。 - 更新代理程序元数据,例如
name
,description
,tags
,resource group
,version
和agent_metadata
属性。 - 您可以使用
agent update
将更新后的版本撤销为其现有版本。
在已部署代理的工作区中,无法通过 terraform init
、terraform plan
和 terraform apply
对已部署代理进行代理更新。
准备工作
查看并选择要更新的 代理版本。
更新代理程序定义
选择群集和 IBM Cloud Object Storage,更新代理配置。
- 登录 IBM Cloud控制台。
- 单击菜单图标
>Platform Automation>Schematics>Extensions。
- 选择代理程序:
- 选择 操作 > 编辑代理程序
- 您可以根据需求编辑 描述,集群,COS 实例名称,COS 存储区名称,COS 存储区区域或 代理程序版本。
- 选择代理程序:
- 单击 更新并验证 以验证集群和 IBM Cloud Object Storage 配置。
- 单击 部署 以重新部署代理程序。
通过 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
通过应用程序接口更新代理
遵循 步骤 以更新 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 validate
和 agent deploy
操作以设置代理程序。
语法
PUT /v2/agents/<enter your agentID>/deploy HTTP/1.1
Host: schematics.cloud.ibm.com
Content-Type: application/json
Authorization: Bearer
代理版本历史
查找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.5 和 version 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),并提供全面的生产支持。 更多信息,请参阅 版本说明。 |