az functionapp deployment: Deploy Functions in CI

Deploy an Azure Functions app, commonly with the source config zip subcommand.

az functionapp deployment manages deployments for a Function App. The most common CI path is az functionapp deployment source config-zip, which pushes a packaged zip to the app via Kudu. It is the function-app analogue of az webapp deploy.

Common flags

source config-zip - deploy a zip package (subcommand)
-g RESOURCE_GROUP and -n NAME - target function app
--src PATH - the zip artifact to deploy
--build-remote true - run remote build (Oryx)

Example in CI

Push a packaged function app zip.

shell

az functionapp deployment source config-zip \
  -g my-rg -n my-func --src functionapp.zip

Common errors in CI

ResourceNotFound: ... functionapp ... not found - wrong app name or resource group
Deployment failed ... 401 - SP lacks Contributor or SCM basic auth disabled
Zip deployment failed ... Oryx build - missing build dependencies or wrong runtime stack

Key takeaways

Deploys a packaged zip to an Azure Functions app via Kudu.
Use --build-remote true when dependencies must be built on Azure.
Name/resource-group and SCM-auth issues cause most deploy failures.