Refresh stale convenience-image config examples (SUPENG-409) - #10760
denislemire wants to merge 1 commit into
Conversation
Replace EOL Node 17, cimg/base:2021.04, cimg/go:1.16, and legacy circleci/node pins, and stop listing ubuntu-2004 as the recommended Arm machine image. Co-authored-by: Cursor <cursoragent@cursor.com>
circleci-factory-bot
left a comment
There was a problem hiding this comment.
FAIL 🔴 author-membership ⚙️ author not in allow-list
denislemire is not in the allow-listed users; allowed: rosieyohannan
PASS 🟢 impact-matches-intent ✨ Docs example tag refresh; impact matches intent
Docs-only change to example image tags across circleci-docs .adoc files; the diff matches the stated intent (replace EOL/legacy tags with cimg/*:current/lts, discourage ubuntu-2004). No code consumes these examples, so cross-repo .circleci configs still using ubuntu-2004:current or cimg/base:2021.04 are unaffected and out of scope. Author may optionally confirm cimg/node:lts, cimg/base:current, cimg/go:current resolve on Developer Hub per the test plan.
SKIP ⚪ 6 skipped check(s)
SKIP ⚪ api-auth-and-design ⚙️ no V3/auth signals in diff
no V3 or auth signals in 22 changed file(s): docs/contributors/modules/docs-style/pages/using-code-samples.adoc, docs/contributors/modules/templates/pages/template-conceptual.adoc, docs/contributors/modules/templates/pages/template-how-to.adoc, docs/contributors/modules/templates/pages/template-tutorial.adoc, docs/guides/modules/execution-managed/pages/circleci-images.adoc, docs/guides/modules/execution-managed/pages/private-images.adoc, docs/guides/modules/execution-managed/pages/using-arm.adoc, docs/guides/modules/getting-started/pages/config-intro.adoc (+14 more)
SKIP ⚪ agents-md-respect ✨ Image-tag refresh respects style-guide rules
The diff swaps stale convenience-image tags in code examples and rewrites the Arm images section; xref link text uses title case, prose is active voice, and no AGENTS.md rule is clearly broken. The new xref targets (configuration-reference anchor and linux-vm-support-policy.adoc) exist per the explored context, so nothing here violates the instruction files.
SKIP ⚪ git-hygiene ⚙️ git history is clean
no merge commits, and no problems with the commit messages
SKIP ⚪ go-best-practices ⚙️ no Go changes to review
no reviewable Go changes among 22 changed file(s)
ignoring 22 non-Go files: docs/contributors/modules/docs-style/pages/using-code-samples.adoc, docs/contributors/modules/templates/pages/template-conceptual.adoc, docs/contributors/modules/templates/pages/template-how-to.adoc, docs/contributors/modules/templates/pages/template-tutorial.adoc, docs/guides/modules/execution-managed/pages/circleci-images.adoc, docs/guides/modules/execution-managed/pages/private-images.adoc, docs/guides/modules/execution-managed/pages/using-arm.adoc, docs/guides/modules/getting-started/pages/config-intro.adoc (+14 more)
SKIP ⚪ reduces-risk ⚙️ non-test files changed
change touches 20 non-test file(s): docs/contributors/modules/docs-style/pages/using-code-samples.adoc, docs/contributors/modules/templates/pages/template-conceptual.adoc, docs/contributors/modules/templates/pages/template-how-to.adoc, docs/contributors/modules/templates/pages/template-tutorial.adoc, docs/guides/modules/execution-managed/pages/circleci-images.adoc, docs/guides/modules/execution-managed/pages/private-images.adoc, docs/guides/modules/execution-managed/pages/using-arm.adoc, docs/guides/modules/getting-started/pages/config-intro.adoc (+12 more)
SKIP ⚪ server-compat ⚙️ no new required config keys
no new env.MustGet calls added in this PR
🤖 factory-bot · codeowner mode · reviewed @ 2026-09-18T23:37:02Z · re-request a review to re-run
[bot e93b483] [config 7d1b49f] [target 22e0d22]
Description
Update copy-pasted
.circleci/config.ymlexamples so they use current next-gen convenience images and supported Linux VM tags.This is one increment of a larger docs audit (SUPENG-409). Ubuntu 20.04 machine examples in getting-started, migrate, and the configuration reference are already on 24.04/26.04. This PR covers the remaining pasted tags:
cimg/node:17.2.0(EOL) →cimg/node:lts(andlts-browserswhere the variant is used)cimg/base:2021.04→cimg/base:currentcimg/go:1.16→cimg/go:currentcircleci/nodeDocker images →cimg/nodeubuntu-2004:current"recommended for all users"; point at 22.04/24.04/26.04:currentand the configuration referenceContributor templates and the style-guide sample are updated so new pages do not re-copy the old pins. Versioned Server admin proxy examples that used the same Node 17 snippet are aligned.
Reasons
Readers who paste these samples land on deprecated legacy
circleci/images or brownout-bait tags (Node 17, Ubuntu 20.04, 2021-eracimg/base). That contradicts the convenience-images deprecation notice and the Linux VM Gen2 support policy.Unchanged in this PR: runner SSH/launch-agent copy, contexts security-group language, ECS/ECR retirement, Insights snapshot badge, and VCS matrix work (separate SUPENG-409 PRs).
Content checks
ci/circleci: lintjobci/circleci: buildjob Artifacts tab (index.html)Formatting:
Test plan
valeonusing-arm.adoc(changed section)cimg/node:lts,cimg/node:lts-browsers,cimg/base:current, andcimg/go:currentresolve on Docker Hub / Developer Hub