Skip to content

Commit 475942b

Browse files
Apply suggestions from code review
Co-authored-by: Craig Shoemaker <[email protected]>
1 parent bd673f7 commit 475942b

1 file changed

Lines changed: 16 additions & 20 deletions

File tree

articles/container-apps/sessions.md

Lines changed: 16 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -38,38 +38,34 @@ Dynamic sessions are useful in a variety of situations, including:
3838

3939

4040
## 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.
4342

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.
4644

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.
4946

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.
5248

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.
5652

5753

5854
#### Session pool types comparison
5955

60-
| | **Code Interpreter Session Pool** | **Custom Container Session Pool** |
56+
| | **Code interpreter session pool** | **Custom container session pool** |
6157
|---------------|------------------------------|------------------------------|
62-
| **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. |
6359
| **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. |
6662
| **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. |
6864

6965
For more information, see [Usage](./sessions-usage.md).
7066

7167

72-
## Supported Regions
68+
## Supported regions
7369

7470
Dynamic sessions are available in the following regions. Both code interpreter and custom container sessions are supported in all listed regions.
7571

@@ -99,7 +95,7 @@ Dynamic sessions are designed to run untrusted code in isolated environments. Fo
9995
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).
10096

10197

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
105101

0 commit comments

Comments
 (0)