使用命令部署XM Cloud实例时遇上传源码不允许错误

问题原因 #

当XM Cloud环境已与Git分支关联（配置了CI/CD自动部署触发规则）时，系统会禁用本地代码上传（--upload参数）的部署方式，因为这类环境的部署逻辑是通过分支推送自动触发的。

解决方案 #

1. 确认环境关联分支信息 #

先查看当前环境绑定的分支详情：

dotnet sitecore cloud environment show --environment-id <environmentId>

2. 选择对应部署方式 #

• 方式一：使用分支自动部署
  放弃本地上传方式，将本地代码推送到环境关联的Git分支，系统会自动触发部署流程，无需添加--upload参数。

• 方式二：临时使用本地上传部署
  若需临时通过本地代码部署，先解除环境与分支的关联：

  dotnet sitecore cloud environment update --environment-id <environmentId> --branch ""
  

  解除关联后，执行原部署命令即可：

  dotnet sitecore cloud deployment create --environment-id <environmentId> --no-start --no-watch --upload --working-dir <你的工作目录路径>
  

  注意：解除分支关联后，该环境的自动部署会失效，完成临时部署后可重新关联分支恢复自动触发逻辑。

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