azure/Azure Container Apps Build and Deploy
'GitHub Action for building and deploying Azure Container Apps'
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Apr 14, 2026
- License
- MIT
- Runtime
- Deprecated runtime
Pinned Snippet
uses: azure/container-apps-deploy-action@8dff69dac3367c32ceb2690d8f13adbeab462703 # v2tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| appSourcePath | Absolute path on the GitHub runner of the source application code to be built. | no | — |
| acrName | The name of the Azure Container Registry that the runnable application image will be pushed to. | no | — |
| acrUsername | 'The username used to authenticate push requests to the provided Azure Container Registry. If not provided, an access token will be generated via "az acr login" and provided to "docker login" to authenticate the requests.' | no | — |
| acrPassword | 'The password used to authenticate push requests to the provided Azure Container Registry. If not provided, an access token will be generated via "az acr login" and provided to "docker login" to authenticate the requests.' | no | — |
| registryUrl | The base URL of the Container Registry that the runnable application image will be pushed to. | no | — |
| registryUsername | The username used to authenticate push requests to the provided Container Registry using the "docker login" action. | no | — |
| registryPassword | The password used to authenticate push requests to the provided Container Registry using the "docker login" action. | no | — |
| azureCredentials | 'Azure credentials used by the `azure/login` action to authenticate Azure CLI requests if the user has not previously authenticated in the workflow calling this action.' | no | — |
| imageToBuild | 'The custom name of the image that is to be built, pushed to the Container Registry and deployed to the Container App by this action. Note: this image name should include the registry server; e.g., <registryUrl>/<repo>:<tag>. If this argument is not provided, a default image name will be constructed in the form of <acr-name>.azurecr.io/github-action/container-app:<github-run-id>.<github-run-attempt>.' | no | — |
| imageToDeploy | 'The custom name of an image that has already been pushed to the Container Registry and will be deployed to the Container App by this action. Note: this image name should include the registry server; e.g., <registryUrl>/<repo>:<tag>. If this argument is not provided, the value provided (or determined) for the "imageToBuild" argument will be used.' | no | — |
| dockerfilePath | 'Relative path to the Dockerfile in the provided application source that should be used to build the image that is then pushed to the Container Registry and deployed to the Container App. If not provided, this action will check if there is a file named "Dockerfile" in the provided application source and use that to build the image. Otherwise, the Oryx++ Builder will be used to create the image.' | no | — |
| containerAppName | 'The name of the Azure Container App that will be created or updated. If not provided, this value will be gh-action-app-<github-run-id>-<github-run-attempt>.' | no | gh-action-app-${{ github.run_id }}-${{ github.run_attempt }} |
| resourceGroup | 'The existing resource group that the Azure Container App will be created in. If not provided, this value will be <container-app-name>-rg and its existence will first be checked before attempting to create it.' | no | — |
| containerAppEnvironment | 'The name of the Azure Container App environment to use with the application. If not provided, an existing environment in the resource group of the Container App will be used, otherwise, an environment will be created in the format <container-app-name>-env' | no | — |
| runtimeStack | 'The platform version stack that the application runs in when deployed to the Azure Container App. This should be provided in the format <platform>:<version>. If not provided, this value is determined by Oryx based on the contents of the provided application. Please view the following document for more information on the supported runtime stacks for Oryx: https://github.com/microsoft/Oryx/blob/main/doc/supportedRuntimeVersions.md' | no | — |
| builderStack | 'The stack (OS) that should be used to build the provided application source and produce the runnable application image. You can provide a specific image tag for the stack, such as "debian-bullseye-20231107.2", or you can provide a supported stack name, such as "debian-bookworm" or "debian-bullseye", and the latest supported image tag for that stack will be used. If no stack is provided, this action will attempt to build the provided application source with each supported stack until there's a successful build.' | no | — |
| buildArguments | 'A list of build arguments provided as KEY=VALUE pairings and are space-separated. If a Dockerfile has been provided or is discovered in the application source, each build argument will be passed to the "docker build" command via the --build-arg flag. If the Oryx++ builder is used to create a runnable application image, each build argument will be passed to the "pack build" command via the --env flag.' | no | — |
| targetPort | 'The designated port for the application to run on. If no value is provided and the builder is used to build the runnable application image, the target port will be set to 80 for Python applications and 8080 for all other platform applications. If no value is provided when creating a Container App, the target port will be set to 80 by default. Note: when using this action to update a Container App, the target port may be updated if not provided based on changes to the ingress property. | no | — |
| location | 'The location that the Container App (and other created resources) will be deployed to. To view locations suitable for creating the Container App in, please run the following: az provider show -n Microsoft.App --query "resourceTypes[?resourceType=='containerApps'].locations"' | no | — |
| environmentVariables | 'A list of environment variable(s) for the container. Space-separated values in 'key=value' format. Empty string to clear existing values. Prefix value with 'secretref:' to reference a secret.' | no | — |
| ingress | 'Possible options: external, internal, disabled. If set to "external" (default value if not provided when creating a Container App), the Container App will be visible from the internet or a VNET, depending on the app environment endpoint configured. If set to "internal", the Container App will be visible from within the app environment only. If set to "disabled", ingress will be disabled for this Container App and will not have an HTTP or TCP endpoint.' | no | — |
| yamlConfigPath | 'Full path (on the executing GitHub runner) to the YAML file detailing the configuration of the Container App. The 'resourceGroup' property in the YAML file will not be used; the value for this either comes from the 'resourceGroup' argument provided to the action, or the default resource group name generated by the action. Image and application source arguments (e.g., 'appSourcePath', 'imageToDeploy') will still be used to first build and/or push an image that is used by the Container App; in this case, the provided YAML configuration file will need to reference the image specified by 'imageToDeploy' (or 'imageToBuild', depending on your scenario). When creating a new Container App, all properties listed in the file will be set when the Container App is created. When updating an existing Container App, only the properties listed in the file will be updated on the Container App. For more information on the structure of this YAML configuration file, please visit https://aka.ms/azure-container-apps-yaml' | — | — |
| disableTelemetry | 'If set to "true", no telemetry will be collected by this GitHub Action. If set to "false", or if this argument is not provided, telemetry will be sent to Microsoft about the Container App build and deploy scenario targeted by this GitHub Action.' | no | false |
| targetLabel | 'Specifies the target label for the Azure Container App revision. This will replace any prior revision with the given label. This is required when using ActiveRevisionMode: Labels.' | no | — |
Outputs
no outputs