Skip to content

Commit 463b40e

Browse files
committed
Update pipeline-settings.md
1 parent 3c9af23 commit 463b40e

File tree

1 file changed

+14
-8
lines changed

1 file changed

+14
-8
lines changed

docs/platform/pipelines/pipeline-settings.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ Currently, this feature is behind the feature flag `PIPE_PROJECT_LEVEL_EXECUTION
9797

9898
You can take fine-grained control of how many pipelines run concurrently in each of your projects. By splitting your account-wide concurrency limit into a **High-Priority** and **Low-Priority** partition, you guarantee reserved execution slots for critical projects while preventing any one project from consuming all available capacity.
9999

100-
You can configure this at the account scope only. Navigate to **Account Settings** -> **Pipeline** -> **Concurrent Active Pipeline Executions**.
100+
You can configure this at the account scope only. Navigate to **Account Settings** -> **General** -> **Default Settings** -> **Pipeline** -> **CONCURRENCY MANAGEMENT**.
101101

102102
#### How to Configure
103103

@@ -123,19 +123,25 @@ You can configure this at the account scope only. Navigate to **Account Settings
123123

124124
#### How It Works
125125

126-
- **Define partitions**
127-
- You choose a **High** slot count (e.g. 200 of your 1000 total capacity).
128-
- The remainder becomes the **Low** partition (800 slots in this example).
126+
**Partition Approaches**
127+
You have two options for carving up your total concurrency:
129128

130-
- **Assign projects**
131-
- Provide **either** a list of High-Priority projects **or** a list of Low-Priority projects—others go to the opposite set.
129+
1. **High-Priority Partition (Whitelist)**
130+
- You define a **High** slot count and explicitly specify which projects belong there.
131+
- All remaining (and any newly created) projects automatically fall into Low-Priority.
132+
- **When to use**: reserve slots for a handful of critical projects (e.g. security fixes, patch releases), so they always start quickly.
133+
134+
2. **Low-Priority Partition (Blacklist)**
135+
- You define a **Low** slot count and explicitly specify which projects belong there.
136+
- All remaining (and any newly created) projects automatically fall into High-Priority.
137+
- **When to use**: throttle noisy or build-heavy projects (e.g. CI pipelines) to free up capacity for everything else.
132138

133139
- **Runtime behavior**
134140
1. When both **High** (200) and **Low** (800) are full, new **High** executions queue—but start immediately as soon as **either** partition frees a slot (allowing High to spill over up to the full 1000 over time).
135141
2. New **Low** executions consume only the Low partition; if those 800 are full, they queue until a Low slot opens.
136-
3. On dequeuing mixed queues:
142+
3. On dequeuing mixed queues:
137143
- **High** pipelines start on the first available slot in **High** or **Low**.
138-
- **Low** pipelines wait for the next available **Low** slot.
144+
- **Low** pipelines wait for the next available **Low** slot.
139145

140146
### Pipeline Timeout and Stage Timeout (execution time limits)
141147

0 commit comments

Comments
 (0)