如何程序化重新加载TeamCity项目配置以生效版本化设置？

方案1：调用版本化设置同步接口 #

TeamCity提供了专门触发版本化设置同步的REST接口，调用后会重新拉取并应用配置，等效于手动触发重载：

• 请求方法：POST
• 请求路径：teamcity/app/rest/projects/<你的项目ID>/versionedSettings/sync
• 注意事项：
  • 需要携带具备项目管理员权限的认证信息（Token或Basic Auth）
  • 无需请求体，直接发送POST即可

示例curl命令：

curl -X POST "http://<teamcity服务器地址>/teamcity/app/rest/projects/MyProject/versionedSettings/sync" \
     -H "Authorization: Bearer <你的访问Token>" \
     -H "Content-Type: application/json"

方案2：模拟上下文参数保存操作 #

如果同步接口不可用，可以通过API修改版本化设置的上下文参数（哪怕是无意义的微小修改），触发配置重载：

1. 先GET获取当前版本化设置的项目特征：

   curl "http://<teamcity服务器地址>/teamcity/app/rest/projects/MyProject/projectFeatures" \
        -H "Authorization: Bearer <你的访问Token>" \
        | grep -A 20 "versionedSettings"
   

   找到对应type="versionedSettings"的项目特征，记录其id和当前的parameters内容。

2. 修改参数（比如给某个参数值加个临时后缀），用PUT请求更新：

   curl -X PUT "http://<teamcity服务器地址>/teamcity/app/rest/projects/MyProject/projectFeatures/<特征ID>" \
        -H "Authorization: Bearer <你的访问Token>" \
        -H "Content-Type: application/json" \
        -d '{
              "type": "versionedSettings",
              "parameters": {
                "param1": "原有值_temp",
                "param2": "原有值"
              }
            }'
   

3. 再将参数改回原值，再次发送PUT请求，两次保存操作都会触发配置重载。

方案3：使用TeamCity命令行工具（tc-cli） #

如果允许部署命令行工具，tc-cli提供了直接重载项目的命令，底层基于REST API实现：

1. 先安装tc-cli：npm install -g teamcity-cli（需要Node.js环境）
2. 配置服务器地址和认证信息：tc-cli configure
3. 执行重载命令：

   tc-cli project reload --id MyProject
   

内容的提问来源于stack exchange，提问作者nikolakoco