你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az webapp deployment source

注意

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展，使其受益于其扩展功能。 详细了解扩展。

通过源代码管理来管理 Web 应用部署。

命令

名称	说明	类型	状态
az webapp deployment source config	从 git 或 Mercurial 存储库管理部署。	核心	GA
az webapp deployment source config-local-git	获取 git 存储库终结点的 URL 用于为 web 应用部署克隆和推送。	核心	GA
az webapp deployment source config-zip	使用 Web 应用的 kudu zip 推送部署执行部署。	核心	已放弃
az webapp deployment source config-zip (appservice-kube 扩展)	使用 Web 应用的 kudu zip 推送部署执行部署。	扩展	GA
az webapp deployment source delete	删除源代码管理部署配置。	核心	GA
az webapp deployment source show	获取源代码管理部署配置的详细信息。	核心	GA
az webapp deployment source sync	从存储库同步。 仅在手动集成模式下需要。	核心	GA
az webapp deployment source update-token	更新 Azure 应用服务中缓存的源代码管理令牌。	核心	GA

az webapp deployment source config

从 git 或 Mercurial 存储库管理部署。

请注意，GitHub 操作密码现在在结果中进行了修订。 请使用 az webapp deployment source show 命令查看 GitHub 操作密码。

az webapp deployment source config --repo-url
                                   [--branch]
                                   [--git-token]
                                   [--github-action]
                                   [--ids]
                                   [--manual-integration]
                                   [--name]
                                   [--repository-type {externalgit, git, github, localgit, mercurial}]
                                   [--resource-group]
                                   [--slot]
                                   [--subscription]

示例

从 git 或 Mercurial 存储库管理部署。 （自动生成）

az webapp deployment source config --branch master --manual-integration --name MyWebApp --repo-url https://github.com/Azure-Samples/function-image-upload-resize --resource-group MyResourceGroup

必需参数

--repo-url -u

要从中拉取最新源的存储库 URL，例如 https://github.com/foo/foo-web。

可选参数

--branch

存储库的分支名称。

--git-token

自动同步所需的 Git 访问令牌。

--github-action

如果使用 GitHub 操作，则默认为 False。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--manual-integration

禁用源代码管理和 Web 之间的自动同步。

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--repository-type

存储库类型。

接受的值: externalgit, git, github, localgit, mercurial

默认值: git

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az webapp deployment source config-local-git

获取 git 存储库终结点的 URL 用于为 web 应用部署克隆和推送。

az webapp deployment source config-local-git [--ids]
                                             [--name]
                                             [--resource-group]
                                             [--slot]
                                             [--subscription]

示例

获取终结点并将其添加为 git 远程。

az webapp deployment source config-local-git \
    -g MyResourceGroup -n MyUniqueApp

git remote add azure \
    https://{deploy_user_name}@MyUniqueApp.scm.azurewebsites.net/MyUniqueApp.git

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az webapp deployment source config-zip

已放弃

此命令已弃用，将在将来的版本中删除。 请改用“az webapp deploy”。

使用 Web 应用的 kudu zip 推送部署执行部署。

默认情况下，Kudu 假定 zip 部署不需要任何与生成相关的操作，例如 npm 安装或 dotnet 发布。 若要启用 Kudu 检测逻辑并生成脚本生成过程，可以将 .deployment 文件包含在 zip 文件中，其内容为“[config] SCM_DO_BUILD_DURING_DEPLOYMENT = true”。 请参阅 https://github.com/projectkudu/kudu/wiki/Configurable-settings#enabledisable-build-actions-preview。 或者，可以使用 az webapp config appsettings set 命令启用设置。

az webapp deployment source config-zip --src
                                       [--ids]
                                       [--name]
                                       [--resource-group]
                                       [--slot]
                                       [--subscription]
                                       [--timeout]
                                       [--track-status {false, true}]

示例

使用 zip 文件内容执行部署。

az webapp deployment source config-zip \
    -g {myRG} -n {myAppName} \
    --src {zipFilePathLocation}

必需参数

--src

用于部署的 zip 文件路径。

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--timeout -t

检查部署状态的可配置超时（以秒为单位）。

--track-status

如果为 true，则会在部署期间跟踪 Web 应用启动状态，以用于 Linux Web 应用。

接受的值: false, true

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az webapp deployment source config-zip (appservice-kube 扩展)

使用 Web 应用的 kudu zip 推送部署执行部署。

默认情况下，Kudu 假定 zip 部署不需要任何与生成相关的操作，例如 npm 安装或 dotnet 发布。 若要启用 Kudu 检测逻辑并生成脚本生成过程，可以将 .deployment 文件包含在 zip 文件中，其内容为“[config] SCM_DO_BUILD_DURING_DEPLOYMENT = true”。 请参阅 https://github.com/projectkudu/kudu/wiki/Configurable-settings#enabledisable-build-actions-preview。 或者，可以使用 az webapp config appsettings set 命令启用设置。

az webapp deployment source config-zip --src
                                       [--ids]
                                       [--is-kube]
                                       [--name]
                                       [--resource-group]
                                       [--slot]
                                       [--subscription]
                                       [--timeout]

示例

使用 zip 文件内容执行部署。

az webapp deployment source config-zip \
    -g {myRG} -n {myAppName} \
    --src {zipFilePathLocation}

必需参数

--src

用于部署的 zip 文件路径。

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--is-kube

该应用是 kubernetes 应用。

默认值: False

--name -n

Web 应用的名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--timeout -t

检查部署状态的可配置超时（以秒为单位）。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az webapp deployment source delete

删除源代码管理部署配置。

az webapp deployment source delete [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--slot]
                                   [--subscription]

示例

删除源代码管理部署配置。 （自动生成）

az webapp deployment source delete --name MyWebApp --resource-group MyResourceGroup

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az webapp deployment source show

获取源代码管理部署配置的详细信息。

az webapp deployment source show [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--slot]
                                 [--subscription]

示例

获取源代码管理部署配置的详细信息。 （自动生成）

az webapp deployment source show --name MyWebApp --resource-group MyResourceGroup

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az webapp deployment source sync

从存储库同步。 仅在手动集成模式下需要。

az webapp deployment source sync [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--slot]
                                 [--subscription]

示例

从存储库同步。 仅在手动集成模式下需要。 （自动生成）

az webapp deployment source sync --name MyWebapp --resource-group MyResourceGroup

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az webapp deployment source update-token

更新 Azure 应用服务中缓存的源代码管理令牌。

如果未提供令牌，该命令将清理现有令牌。 请注意，令牌现在在结果中进行了修订。

az webapp deployment source update-token [--git-token]

可选参数

--git-token

自动同步所需的 Git 访问令牌。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。