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
                                   [--branch]
                                   [--git-token]
                                   [--github-action]
                                   [--ids]
                                   [--manual-integration]
                                   [--name]
                                   [--repository-type {externalgit, git, github, localgit, mercurial}]
                                   [--resource-group]
                                   [--slot]

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

--repo-url -u

Repository url to pull the latest source from, e.g. https://github.com/foo/foo-web.

Optional Parameters

--branch

The branch name of the repository.

--git-token

Git access token required for auto sync.

--github-action

If using GitHub action, default to False.

--ids

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.

--manual-integration

Disable automatic sync between source control and web.

--name -n

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>.

--repository-type

Repository type.

accepted values: externalgit, git, github, localgit, mercurial
default value: git
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

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]

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

--ids

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 -n

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>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

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]
                                       [--timeout]

Examples

Perform deployment by using zip file content.

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

Required Parameters

--src

A zip file path for deployment.

Optional Parameters

--ids

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 -n

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>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

--timeout -t

Configurable timeout in seconds for checking the status of deployment.

az webapp deployment source delete

Delete a source control deployment configuration.

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

Examples

Delete a source control deployment configuration. (autogenerated)

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

Optional Parameters

--ids

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 -n

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>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

az webapp deployment source show

Get the details of a source control deployment configuration.

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

Examples

Get the details of a source control deployment configuration. (autogenerated)

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

Optional Parameters

--ids

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 -n

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>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

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]

Examples

Synchronize from the repository. Only needed under manual integration mode. (autogenerated)

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

Optional Parameters

--ids

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 -n

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>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

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]

Optional Parameters

--git-token

Git access token required for auto sync.