Skip to content

Commit ee61c74

Browse files
authored
Add info on image caching
1 parent b3dd462 commit ee61c74

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

articles/container-apps/sessions-custom-container.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,16 @@ This command creates a session pool with the following settings:
9696
| `--env-vars` | `"key1=value1" "key2=value2"` | The environment variables to set in the container. |
9797
| `--location` | `"Supported Location"` | The location of the session pool. |
9898

99+
To check on the status of the session pool, use the `az containerapp sessionpool show` command:
100+
101+
```bash
102+
az containerapp sessionpool show \
103+
--name <SESSION_POOL_NAME> \
104+
--resource-group <RESOURCE_GROUP> \
105+
--query "properties.poolManagementEndpoint" \
106+
--output tsv
107+
```
108+
99109
To update the session pool, use the `az containerapp sessionpool update` command.
100110

101111
# [Azure Resource Manager](#tab/arm)
@@ -204,13 +214,20 @@ This template creates a session pool with the following settings:
204214
> [!IMPORTANT]
205215
> If the session is used to run untrusted code, don't include information or data that you don't want the untrusted code to access. Assume the code is malicious and has full access to the container, including its environment variables, secrets, and files.
206216
217+
#### Image caching
218+
219+
When a session pool is created or updated, Azure Container Apps caches the container image in the pool. This caching helps to speed up the process of creating new sessions.
220+
221+
Because the image is cached, any changes to the image aren't automatically reflected in the sessions. To update the image in the sessions, you must update the session pool with a new image tag. Use a unique tag for each image update to ensure that the new image is pulled.
222+
207223
### Working with sessions
208224

209225
Your application interacts with a session using the session pool's management API.
210226

211227
A pool management endpoint for custom container sessions follows this format: `https://<SESSION_POOL>.<ENVIRONMENT_ID>.<REGION>.azurecontainerapps.io`.
212228

213229
To retrieve the session pool's management endpoint, use the `az containerapp sessionpool show` command:
230+
214231
```bash
215232
az containerapp sessionpool show \
216233
--name <SESSION_POOL_NAME> \

0 commit comments

Comments
 (0)