Skip to content

Clarify hosted-agent vCPU concurrency limits - #3161

Closed
dbr787 wants to merge 3 commits into
mainfrom
docs/hosted-agent-vcpu-limits
Closed

Clarify hosted-agent vCPU concurrency limits#3161
dbr787 wants to merge 3 commits into
mainfrom
docs/hosted-agent-vcpu-limits

Conversation

@dbr787

@dbr787 dbr787 commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Why

The hosted-agent limits table described concurrency as machine counts and used outdated plan names and values. Because each instance shape consumes a different number of vCPUs, this did not answer how many jobs an organization can run concurrently.

What

  • Define hosted-agent concurrency as combined vCPU capacity and show the current Free, Pro, and Enterprise limits.
  • Add practical job-count examples for each standard Linux shape and explain mixed-shape usage.
  • Preserve the 50 GB container-cache and 5 GB Git-mirror default storage quotas.
  • Keep volatile minute allowances, rates, shape availability, and plan features on the public pricing page, while directing trials and custom policies to Service Quotas.
  • Replace remaining Personal/Trial plan terminology on the limits page and the linked Linux hosted-agent page.

Sources were the current public pricing and hosted-agent documentation, cross-checked against current bk/bk entitlement, shape, and service-quota configuration. billing/foundation was not accessible from this workspace, so no internal-only billing details are included.

Validated with Vale, markdownlint, Alex, link HTTP checks, and the 80-example page-rendering spec.

@dbr787
dbr787 requested a review from a team as a code owner September 4, 2026 02:15
@github-actions github-actions Bot added the agent label Sep 4, 2026
@buildkite-systems

Copy link
Copy Markdown

@buildsworth-bk-app buildsworth-bk-app Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Want to dig deeper?

Paste this into your agent to explore the findings from this review's Buildkite build:

Download the buildsworth logs from build 25405, then answer my questions about the findings.

Install the reading-buildsworth-logs skill to run this.

About buildsworth

Model: gpt-5.6-sol with xhigh thinking.

How to request a review: Comment @buildsworth-bk review on the PR, or request buildsworth-bk as a reviewer.

Risk labels (how buildsworth classifies risk) — buildsworth classifies risk itself from the diff. Unless repository policy already allows L2 approval, grant it by mentioning @buildsworth-bk (see approval ceiling and L2 approval grant):

  • L1 — Low risk (dep bumps, docs/copy, lockfiles, small presentational fixes). buildsworth may approve by default.
  • L2 — Standard risk (new UI, additive API fields, refactors). Approved only when repository policy or a verified grant allows it; otherwise comment-only.
  • L3 — High risk (auth, migrations, payments, secrets, perf-critical pipeline paths). Human review always required.

Comment thread pages/platform/limits.md
@@ -2,8 +2,8 @@

This page outlines usage limits designed to protect your builds from unintentional resource issues and ensure reliable service for all customers. Limits vary by subscription tier:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Non-blocking: The All Access Trial is an evaluation period rather than a subscription tier, so this lead-in misclassifies it.

Suggested change
This page outlines usage limits designed to protect your builds from unintentional resource issues and ensure reliable service for all customers. Limits vary by subscription tier:
This page outlines usage limits designed to protect your builds from unintentional resource issues and ensure reliable service for all customers. Limits vary across plans and the All Access Trial:

ampagent and others added 2 commits September 4, 2026 02:39
@karensawrey

Copy link
Copy Markdown
Contributor

Closing as a duplicate and superseded by https://github.com/buildkite/docs-private/pull/2181

@karensawrey karensawrey closed this Sep 9, 2026
pull Bot pushed a commit to MaxMood96/docs-2 that referenced this pull request Sep 10, 2026
An updated duplicate of buildkite#3161

Summary

- Update hosted-agent concurrency limits to use combined vCPU capacity.
- Document current Free and Pro concurrency limits with machine-size examples.
- Restore included Linux vCPU minutes and clarify M4 Mac usage pricing.
- Preserve hosted-agent cache storage quotas.
- Replace outdated Personal and Trial plan terminology.
- Direct trial and custom-limit organizations to Service Quotas.

Validation

- Vale
- markdownlint
- Alex
- 80 page-rendering specs

Changes from the original PR

- Restored explicit monthly usage information:
- Free: up to 2,000 Linux vCPU minutes.
- Pro: 4,000 included Linux vCPU minutes.
- Pro M4 Mac: pay as you go.
- Enterprise: volume discounts.
- All Access Trial: refer to Service Quotas.
- Changed the introduction from “subscription tiers” to “plans and the All Access Trial,” because the trial is not a plan.
- Reordered the list so Free, Pro, and Enterprise are grouped as plans, followed by the trial.
- Updated the pricing paragraph because allowances are now documented directly rather than only linked to Pricing.

Everything else from PR buildkite#3161 was retained.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants