az webapp deployment source
Manage web app deployment via source control.
Commands
az webapp deployment source config |
Manage deployment from git or Mercurial repositories. |
az webapp deployment source config-local-git |
Get a URL for a git repository endpoint to clone and push to for web app deployment. |
az webapp deployment source config-zip |
Perform deployment using the kudu zip push deployment for a web app. |
az webapp deployment source delete |
Delete a source control deployment configuration. |
az webapp deployment source show |
Get the details of a source control deployment configuration. |
az webapp deployment source sync |
Synchronize from the repository. Only needed under manual integration mode. |
az webapp deployment source update-token |
Update source control token cached in Azure app service. |
az webapp deployment source config
Manage deployment from git or Mercurial repositories.
az webapp deployment source config --repo-url
[--app-working-dir]
[--branch]
[--cd-account-create]
[--cd-app-type {AspNet, AspNetCore, NodeJS, PHP, Python}]
[--cd-project-url]
[--git-token]
[--ids]
[--manual-integration]
[--name]
[--nodejs-task-runner {Grunt, Gulp, None}]
[--private-repo-password]
[--private-repo-username]
[--python-framework {Bottle, Django, Flask}]
[--python-version {Python 2.7.12 x64, Python 2.7.12 x86, Python 2.7.13 x64, Python 2.7.13 x86, Python 3.5.3 x64, Python 3.5.3 x86, Python 3.6.0 x64, Python 3.6.0 x86, Python 3.6.1 x86, Python 3.6.2 x64}]
[--repository-type {externalgit, git, github, localgit, mercurial, vsts}]
[--resource-group]
[--slot]
[--slot-swap]
[--subscription]
[--test]
Examples
Manage deployment from git or Mercurial repositories. (autogenerated)
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
Required Parameters
Repository url to pull the latest source from, e.g. https://github.com/foo/foo-web.
Optional Parameters
Working directory of the application. Default will be root of the repo.
The branch name of the repository.
To create a new Visual Studio Team Services (VSTS) account if it doesn't exist already.
Web application framework you used to develop your app. Default is AspNet.
URL of the Visual Studio Team Services (VSTS) project to use for continuous delivery. URL should be in format https://<accountname>.visualstudio.com/<projectname>
.
Git access token required for auto sync.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Disable automatic sync between source control and web.
Name of the web app. If left unspecified, a name will be randomly generated. You can configure the default using az configure --defaults web=<name>
.
Task runner for nodejs. Default is None.
Password for the private repository.
Username for the private repository.
Framework used for Python application. Default is Django.
Python version used for application. Default is Python 3.5.3 x86.
Repository type.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the slot. Default to the productions slot if not specified.
Name of the slot to be used for deployment and later promote to production. If slot is not available, it will be created. Default: Not configured.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Name of the web app to be used for load testing. If web app is not available, it will be created. Default: Disable.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az webapp deployment source config-local-git
Get a URL for a git repository endpoint to clone and push to for web app deployment.
az webapp deployment source config-local-git [--ids]
[--name]
[--resource-group]
[--slot]
[--subscription]
Examples
Get an endpoint and add it as a git remote.
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
Optional Parameters
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of the web app. If left unspecified, a name will be randomly generated. You can configure the default using az configure --defaults web=<name>
.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the slot. Default to the productions slot if not specified.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az webapp deployment source config-zip
Perform deployment using the kudu zip push deployment for a web app.
By default Kudu assumes that zip deployments do not require any build-related actions like npm install or dotnet publish. This can be overridden by including a .deployment file in your zip file with the following content '[config] SCM_DO_BUILD_DURING_DEPLOYMENT = true', to enable Kudu detection logic and build script generation process. See https://github.com/projectkudu/kudu/wiki/Configurable-settings#enabledisable-build-actions-preview. Alternately the setting can be enabled using the az webapp config appsettings set command.
az webapp deployment source config-zip --src
[--ids]
[--name]
[--resource-group]
[--slot]
[--subscription]
[--timeout]
Examples
Perform deployment by using zip file content.
az webapp deployment source config-zip \
-g {myRG} -n {myAppName} \
--src {zipFilePathLocation}
Required Parameters
A zip file path for deployment.
Optional Parameters
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of the web app. If left unspecified, a name will be randomly generated. You can configure the default using az configure --defaults web=<name>
.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the slot. Default to the productions slot if not specified.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Configurable timeout in seconds for checking the status of deployment.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az webapp deployment source delete
Delete a source control deployment configuration.
az webapp deployment source delete [--ids]
[--name]
[--resource-group]
[--slot]
[--subscription]
Examples
Delete a source control deployment configuration. (autogenerated)
az webapp deployment source delete --name MyWebApp --resource-group MyResourceGroup
Optional Parameters
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of the web app. If left unspecified, a name will be randomly generated. You can configure the default using az configure --defaults web=<name>
.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the slot. Default to the productions slot if not specified.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az webapp deployment source show
Get the details of a source control deployment configuration.
az webapp deployment source show [--ids]
[--name]
[--query-examples]
[--resource-group]
[--slot]
[--subscription]
Examples
Get the details of a source control deployment configuration. (autogenerated)
az webapp deployment source show --name MyWebApp --resource-group MyResourceGroup
Optional Parameters
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of the web app. If left unspecified, a name will be randomly generated. You can configure the default using az configure --defaults web=<name>
.
Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the slot. Default to the productions slot if not specified.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az webapp deployment source sync
Synchronize from the repository. Only needed under manual integration mode.
az webapp deployment source sync [--ids]
[--name]
[--resource-group]
[--slot]
[--subscription]
Examples
Synchronize from the repository. Only needed under manual integration mode. (autogenerated)
az webapp deployment source sync --name MyWebapp --resource-group MyResourceGroup
Optional Parameters
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of the web app. If left unspecified, a name will be randomly generated. You can configure the default using az configure --defaults web=<name>
.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the slot. Default to the productions slot if not specified.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az webapp deployment source update-token
Update source control token cached in Azure app service.
If no token is provided, the command will clean up existing token.
az webapp deployment source update-token [--git-token]
[--subscription]
Optional Parameters
Git access token required for auto sync.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.