Merge pull request #287229 from anthonychu/20240924-add-built-in-vars

[Container Apps] Add built-in variables reference

Author: prmerger-automator[bot]

articles/container-apps/environment-variables.md

@@ -151,6 +151,32 @@ Update-AzContainerApp -TemplateContainer $containerTemplate
 
 ---
 
+## Built-in environment variables
+
+Azure Container Apps automatically adds environment variables that your apps and jobs can use to obtain platform metadata at run-time.
+
+### Apps
+
+The following variables are available to container apps:
+
+| Variable name | Description | Example value |
+|---------------|-------------| ------------- |
+| `CONTAINER_APP_NAME` | The name of the container app. | `my-containerapp` |
+| `CONTAINER_APP_REVISION` | The name of the container app revision. | `my-containerapp--20mh1s9` |
+| `CONTAINER_APP_HOSTNAME` | The revision-specific hostname of the container app. | `my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io` |
+| `CONTAINER_APP_ENV_DNS_SUFFIX` | The DNS suffix for the Container Apps environment. To obtain the fully qualified domain name (FQDN) of the app, append the app name to the DNS suffix in the format `$CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX`. | `<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io` |
+| `CONTAINER_APP_PORT` | The target port of the container app. | `8080` |
+| `CONTAINER_APP_REPLICA_NAME` | The name of the container app replica. | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` |
+
+### Jobs
+
+The following variables are available to Container Apps jobs:
+
+| Variable name | Description | Example value |
+|---------------|-------------| ------------- |
+| `CONTAINER_APP_JOB_NAME` | The name of the job. | `my-job` |
+| `CONTAINER_APP_JOB_EXECUTION_NAME` | The name of the job execution. | `my-job-iwpi4il` |
+
 ## Next steps
 
 - [Revision management](revisions-manage.md)