管理云代理

云代理配置文件可根据需求从云服务提供商（AWS、Azure、GCP、Kubernetes 等）创建构建代理。配置文件属于 TeamCity 项目，镜像定义了要创建的内容，实例是正在运行的云主机。 teamcity project cloud 命令组可用于查看和管理上述三项。

云配置文件

查看为项目配置的云配置文件：

teamcity project cloud profile list

列出特定项目的配置文件：

teamcity project cloud profile list --project MyProject
teamcity project cloud profile list --project MyProject --json

标志	描述
`-p`， `--项目`	根据项目 ID 筛选器筛选
`-n`， `--limit`	显示的最大配置文件数量
`--json`	输出为 JSON。使用 `--json=` 可列出可用字段， `--json=f1,f2` 可查看指定字段。

teamcity project cloud profile view amazon-1
teamcity project cloud profile view amazon-1 --json

查看项目可用的云镜像：

teamcity project cloud image list --project MyProject

按云配置文件筛选：

teamcity project cloud image list --project MyProject --profile aws-prod

标志	描述
`-p`， `--项目`	根据项目 ID 筛选器筛选
`--profile`	按云配置文件 ID 筛选镜像
`-n`， `--limit`	显示的最大镜像数
`--json`	输出为 JSON。使用 `--json=` 可列出可用字段， `--json=f1,f2` 可查看指定字段。

teamcity project cloud image view ubuntu-22-large
teamcity project cloud image view ubuntu-22-large --json

从选定镜像启动新的云实例：

teamcity project cloud image start ubuntu-22-large
teamcity project cloud image start ubuntu-22-large --json

命令成功后会返回新实例 ID。

查看项目正在运行的云实例：

teamcity project cloud instance list --project MyProject

按镜像筛选：

teamcity project cloud instance list --project MyProject --image ubuntu-22-large

   

标志	描述
`-p`， `--项目`	根据项目 ID 筛选器筛选
`--image`	按云镜像名称或显式 ID 定位器筛选实例
`-n`， `--limit`	显示的最大实例数
`--json`	输出为 JSON。使用 `--json=` 可列出可用字段， `--json=f1,f2` 可查看指定字段。

teamcity project cloud instance view i-0245b46070c443201
teamcity project cloud instance view i-0245b46070c443201 --json

优雅停止云实例：

teamcity project cloud instance stop i-0245b46070c443201

强制终止：

teamcity project cloud instance stop i-0245b46070c443201 --force

2026年 8月 6日