You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/container-apps/sessions.md
+16-20Lines changed: 16 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,38 +38,34 @@ Dynamic sessions are useful in a variety of situations, including:
38
38
39
39
40
40
## Key Concepts
41
-
-**Session Pool**
42
-
A session pool is the foundation for dynamic sessions. It contains a set of prewarmed, ready-to-use sessions that enable nearinstant startup. When a request comes in, the system allocates a session from the pool instead of creating one from scratch, which dramatically reduces latency.
41
+
-**Session Pool**: A session pool is the foundation for dynamic sessions. It contains a set of prewarmed, ready-to-use sessions that enable near instant startup. When a request comes in, the system allocates a session from the pool instead of creating one from scratch, which dramatically reduces latency.
43
42
44
-
-**Session**
45
-
A session is the actual execution environment where your code or container runs. Sessions are ephemeral and isolated, designed for short-lived tasks. When you create a session, it's allocated from the session pool, ensuring fast startup. After the task completes or the cooldown period expires, the session is destroyed and resources are cleaned up.
43
+
-**Session**: A session is the actual execution environment where your code or container runs. Sessions are ephemeral and isolated, designed for short-lived tasks. When you create a session, it's allocated from the session pool, ensuring fast startup. After the task completes or the cooldown period expires, the session is destroyed and resources are cleaned up.
46
44
47
-
-**Session Lifecycle**
48
-
When your application sends a request with a session identifier, the session pool allocates a session automatically. The session stays active as long as requests continue. Once the cooldown period expires with no activity, the session is destroyed and its resources are cleaned up automatically.
45
+
-**Session lifecycle**: When your application sends a request with a session identifier, the session pool allocates a session automatically. The session stays active as long as requests continue. Once the cooldown period expires with no activity, the session is destroyed and its resources are cleaned up automatically.
49
46
50
-
-**Request routing and identifiers**
51
-
Sessions are accessed through the session pool management endpoint. Requests include an `identifier` query parameter, and the pool routes the request to an existing session or allocates a new one if needed. The request path after the management endpoint is forwarded to the session container.
47
+
-**Request routing and identifiers**: Sessions are accessed through the session pool management endpoint. Requests include an `identifier` query parameter, and the pool routes the request to an existing session or allocates a new one if needed. The request path after the management endpoint is forwarded to the session container.
52
48
53
-
-**Session Pool Types**
54
-
-**Code Interpreter Session Pools**: These use platform built-in containers that provide preconfigured environments for running code, including AI-generated scripts. Ideal for scenarios like LLM-driven workflows or secure code execution.
55
-
-**Custom Container Session Pools**: Bring-your-own-container for custom workloads that require specific dependencies or runtime environments.
49
+
-**Session pool types**
50
+
-**Code interpreter session pools**: These use platform built-in containers that provide preconfigured environments for running code, including AI-generated scripts. Ideal for scenarios like LLM-driven workflows or secure code execution.
51
+
-**Custom container session pools**: Bring-your-own-container for custom workloads that require specific dependencies or runtime environments.
|**Best For**| Running AI‑generated code, user-submitted scripts, or quick secure code execution without managing a runtime environment. | Workloads requiring a custom runtime, libraries, binaries, or specialized tools not supported by built-in interpreters. |
58
+
|**Best for**| Running AI‑generated code, user-submitted scripts, or quick secure code execution without managing a runtime environment. | Workloads requiring a custom runtime, libraries, binaries, or specialized tools not supported by built-in interpreters. |
63
59
|**Environment**| Preconfigured with common runtimes and tools; no container build or image publishing required. | Fully customizable container image with your own dependencies, packages, and configuration. |
64
-
|**When to Choose**| Choose this for simplicity, fastest startup, and minimal setup. | Choose this when you need full control over the execution environment or rely on custom dependencies. |
65
-
|**Ideal Use Cases**| LLM workflows, code interpretation, educational/sandbox scenarios, safe execution of user code. | Custom compute tasks, proprietary interpreters, specialized environments, or workloads with specific OS/library requirements. |
60
+
|**When to choose**| Choose this for simplicity, fastest startup, and minimal setup. | Choose this when you need full control over the execution environment or rely on custom dependencies. |
61
+
|**Ideal use cases**| LLM workflows, code interpretation, educational/sandbox scenarios, safe execution of user code. | Custom compute tasks, proprietary interpreters, specialized environments, or workloads with specific OS/library requirements. |
66
62
|**Language and protocol**| Limited to the built-in runtimes and the REST API surface provided by the code interpreter. | Any language or stack supported by your container, with any TCP protocol you choose to expose. |
67
-
|**Image Requirement**| None—uses platform built‑in interpreter environments. | Required—supply your own container image URI. |
63
+
|**Image requirement**| None—uses platform built‑in interpreter environments. | Required—supply your own container image URI. |
68
64
69
65
For more information, see [Usage](./sessions-usage.md).
70
66
71
67
72
-
## Supported Regions
68
+
## Supported regions
73
69
74
70
Dynamic sessions are available in the following regions. Both code interpreter and custom container sessions are supported in all listed regions.
75
71
@@ -99,7 +95,7 @@ Dynamic sessions are designed to run untrusted code in isolated environments. Fo
99
95
Custom container sessions are billed based on the resources consumed by the session pool. For more information, see [Azure Container Apps billing](./billing.md#dynamic-sessions).
100
96
101
97
102
-
## Next Steps
103
-
- Learn how to configure [Session pools](./session-pool.md)
104
-
- Learn how to use [Dynamic sessions](./sessions-usage.md), including security and best practices
98
+
## Next steps
99
+
- Learn how to configure [session pools](./session-pool.md)
100
+
- Learn how to use [dynamic sessions](./sessions-usage.md), including security and best practices
0 commit comments