content(cicd): rewrite the Codefresh guide (#19199) by jkodroff · Pull Request #19299 · pulumi/docs

jkodroff · 2026-05-20T21:53:21Z

Rewrites the Codefresh CI/CD guide to the standard guide template and standardizes the closing section across recently-revised sibling guides.

Changes

Rewrote codefresh.md to the standard template: Pulumi Cloud auth, ESC, OIDC, trunk-based workflow. Removed screenshots, marketing prose, and the Kubernetes-only example.
Renamed the closing section to ## Additional resources in the Argo CD, AWS Code Services, and Azure DevOps guides.

Part of #19190. Fixes #19199.

Rewrite codefresh.md to the standard CI/CD guide template: Pulumi Cloud auth, ESC, OIDC, and a trunk-based workflow. Drops screenshots, marketing prose, and the Kubernetes-only example. Also standardizes the closing section heading to "Additional resources" across the Argo CD, AWS Code Services, and Azure DevOps guides. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

pulumi-bot · 2026-05-20T22:06:03Z

Your site preview for commit f973e08 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-19299-f973e083.s3-website.us-west-2.amazonaws.com

jkodroff · 2026-05-20T22:15:58Z

@claude #update-review

pulumi-bot · 2026-05-20T22:24:46Z

Pre-merge Review — Last updated 2026-05-20T00:00:00Z

Tip

Summary: This PR rewrites codefresh.md to the standard CI/CD guide template (Pulumi Cloud auth, ESC, OIDC, trunk-based preview/staging/production workflow) and renames the closing section heading to ## Additional resources in three recently-revised sibling guides (Argo CD, AWS Code Services, Azure DevOps). The rewrite removes screenshots and a Kubernetes-only example, replacing them with a generalized multi-cloud pipeline guide. The main failure mode that could block readers is broken links or inaccurate CLI commands; all links and commands were verified. Full factual verification, cross-sibling heading consistency check, and code-examples checks ran.

Review confidence:

Dimension	Level	Notes
mechanics	HIGH
facts	HIGH
cross-sibling consistency	HIGH	read 4 of 16 siblings (the 4 PR-touched guides)

Investigation log

Cross-sibling reads: 4 of 16 siblings (argocd, aws-code-services, azure-devops, codefresh — the PR-touched guides; heading consistency verified across all four)
External claim verification: 16 of 16 claims verified (0 unverifiable, 0 contradicted) · 4 specialists (numerical, cross-reference, capability, framing); 0 cross-specialist corroborations · routed: 12 inline, 0 Pass 1, 2 Pass 2 (verified 2, contradicted 0, unverifiable 0), 2 Pass 3 (verified 2, contradicted 0, unverifiable 0)
Cited-claim spot-checks: not run (no cited claims with inline citations requiring spot-check)
Frontmatter sweep: ran on body + meta_desc + title (no social.* keys in frontmatter)
Temporal-trigger sweep: not run (no trigger words in diff)
Code execution: not run (no static/programs/ change)
Code-examples checks: ran (3 specialists: structural, existence, body-code-coverage); 0 findings
Editorial-balance pass: not run (not under content/blog/)

🚨 Outstanding	⚠️ Low-confidence	💡 Pre-existing	✅ Resolved
0	0	0	0

🔍 Verification trail

16 claims extracted · 16 verified · 0 unverifiable · 0 contradicted

L21 "Codefresh is a CI/CD platform for Kubernetes and Argo CD, now part of Octopus Deploy" → ✅ verified (Octopus Deploy acquired Codefresh on Feb 27, 2024; source: official press release at prnewswire.com/news-releases/octopus-deploy-acquires-codefresh-302071690.html)
L21 "Its CI pipelines run each step as a container" → ✅ verified (Codefresh freestyle step docs at codefresh.io/docs/docs/pipelines/steps/freestyle/ confirm: "run commands inside a Docker container")
L21 "pulumi/pulumi container image ships the Pulumi CLI and every language runtime" → ✅ verified (pulumi/pulumi-docker-containers README describes this as the "kitchen sink" image including Go, Python, Node, .NET, Java; source: github.com/pulumi/pulumi-docker-containers README)
L21 Docker Hub link https://hub.docker.com/r/pulumi/pulumi → ✅ verified (URL resolves; verified via Pass 2 agent)
L24 state-and-backends link /docs/iac/concepts/state-and-backends/ → ✅ verified (file exists at content/docs/iac/concepts/state-and-backends.md)
L29 Codefresh freestyle step link https://codefresh.io/docs/docs/pipelines/steps/freestyle/ → ✅ verified (URL resolves to live page; verified via Pass 2 agent)
L34 Argo CD guide link /docs/iac/guides/continuous-delivery/argocd/ → ✅ verified (file exists)
L34 PKO link /docs/integrations/clouds/kubernetes/pulumi-kubernetes-operator/ → ✅ verified (file exists)
L49 anchor #creating-an-organization-access-token on /docs/administration/access-identity/access-tokens/ → ✅ verified (heading ## Organization access tokens {#creating-an-organization-access-token} confirmed at line 82 of access-tokens.md)
L53 OIDC issuers link /docs/administration/access-identity/oidc-issuers/ → ✅ verified (directory exists)
L68 stacks link /docs/iac/concepts/stacks/ → ✅ verified (file exists at content/docs/iac/concepts/stacks.md)
L91 pulumi install command and link /docs/iac/cli/commands/pulumi_install/ → ✅ verified (file exists; command is real)
L100 anchor #the-trunk-based-development-workflow on /docs/iac/guides/continuous-delivery/ → ✅ verified (## The trunk-based development workflow heading confirmed at line 36 of _index.md)
L104 pulumi preview link /docs/iac/cli/commands/pulumi_preview/ → ✅ verified (file exists)
L113 Review Stacks link /docs/deployments/deployments/review-stacks/ → ✅ verified (file exists at content/docs/deployments/deployments/review-stacks.md)
L117 pulumi up link /docs/iac/cli/commands/pulumi_up/ → ✅ verified (file exists)
L141 /docs/support/troubleshooting/ci-cd/ → ✅ verified (file exists at content/docs/support/troubleshooting/ci-cd.md)
Cross-sibling: ## Additional resources as final H2 across PR-touched guides → 🤝 matches argocd.md, aws-code-services.md, azure-devops.md (all confirmed after this PR's changes)

🚨 Outstanding in this PR

No outstanding issues.

⚠️ Low-confidence

No low-confidence findings.

✅ Resolved since last review

No prior review.

📜 Review history

2026-05-20T00:00:00Z — Initial review: clean pass; Codefresh rewrite and sibling heading standardization verified with no issues (f973e08)

Need a re-review? Want to dispute a finding? Mention @claude and include #update-review.
(For ad-hoc questions or fixes, just @claude — no hashtag.)

github-actions · 2026-05-20T22:24:53Z

🤖 Review updated on @jkodroff's request.

pulumi-bot · 2026-05-20T22:32:32Z

Pre-merge Review — Last updated 2026-05-20T12:00:00Z

Tip

Summary: This PR rewrites codefresh.md to the standard Pulumi CI/CD guide template (Pulumi Cloud auth, ESC, OIDC, trunk-based preview/staging/production workflow) and renames the closing section heading to ## Additional resources in three recently-revised sibling guides (Argo CD, AWS Code Services, Azure DevOps). The rewrite removes screenshots and a Kubernetes-only example, replacing them with a generalized multi-cloud pipeline guide. The main failure mode that could block readers is broken links or inaccurate CLI commands; all links and commands were verified. Full factual verification, cross-sibling heading consistency check, and code-examples checks ran.

Review confidence:

Dimension	Level	Notes
mechanics	HIGH
facts	HIGH
cross-sibling consistency	HIGH	read 4 of 16 siblings (the 4 PR-touched guides)

Investigation log

Cross-sibling reads: 4 of 16 siblings (argocd, aws-code-services, azure-devops, codefresh — the PR-touched guides; heading consistency verified across all four)
External claim verification: 16 of 16 claims verified (0 unverifiable, 0 contradicted) · 4 specialists (numerical, cross-reference, capability, framing); 0 cross-specialist corroborations · routed: 12 inline, 0 Pass 1, 2 Pass 2 (verified 2, contradicted 0, unverifiable 0), 2 Pass 3 (verified 2, contradicted 0, unverifiable 0)
Cited-claim spot-checks: not run (no cited claims with inline citations requiring spot-check)
Frontmatter sweep: ran on body + meta_desc + title (no social.* keys in frontmatter)
Temporal-trigger sweep: not run (no trigger words in diff)
Code execution: not run (no static/programs/ change)
Code-examples checks: ran (3 specialists: structural, existence, body-code-coverage); 0 findings
Editorial-balance pass: not run (not under content/blog/)

🚨 Outstanding	⚠️ Low-confidence	💡 Pre-existing	✅ Resolved
0	0	0	0

🔍 Verification trail

16 claims extracted · 16 verified · 0 unverifiable · 0 contradicted

L21 "Codefresh is a CI/CD platform for Kubernetes and Argo CD, now part of Octopus Deploy" → ✅ verified (Octopus Deploy acquired Codefresh on Feb 27, 2024; source: prnewswire.com/news-releases/octopus-deploy-acquires-codefresh-302071690.html)
L21 "Its CI pipelines run each step as a container" → ✅ verified (Codefresh freestyle step docs confirm: "run commands inside a Docker container"; source: codefresh.io/docs/docs/pipelines/steps/freestyle/)
L21 "pulumi/pulumi container image ships the Pulumi CLI and every language runtime" → ✅ verified (pulumi/pulumi-docker-containers README describes this as the "kitchen sink" image including Go, Python, Node, .NET, Java; source: github.com/pulumi/pulumi-docker-containers README)
L21 Docker Hub link https://hub.docker.com/r/pulumi/pulumi → ✅ verified (URL resolves; verified via Pass 2 agent)
L24 state-and-backends link /docs/iac/concepts/state-and-backends/ → ✅ verified (file exists at content/docs/iac/concepts/state-and-backends.md)
L29 Codefresh freestyle step link https://codefresh.io/docs/docs/pipelines/steps/freestyle/ → ✅ verified (URL resolves to live page; verified via Pass 2 agent)
L34 Argo CD guide link /docs/iac/guides/continuous-delivery/argocd/ → ✅ verified (file exists)
L34 PKO link /docs/integrations/clouds/kubernetes/pulumi-kubernetes-operator/ → ✅ verified (file exists)
L49 anchor #creating-an-organization-access-token on /docs/administration/access-identity/access-tokens/ → ✅ verified (heading ## Organization access tokens {#creating-an-organization-access-token} confirmed at line 82 of access-tokens.md)
L53 OIDC issuers link /docs/administration/access-identity/oidc-issuers/ → ✅ verified (directory exists)
L68 stacks link /docs/iac/concepts/stacks/ → ✅ verified (file exists at content/docs/iac/concepts/stacks.md)
L91 pulumi install command and link /docs/iac/cli/commands/pulumi_install/ → ✅ verified (file exists; command is real)
L100 anchor #the-trunk-based-development-workflow on /docs/iac/guides/continuous-delivery/ → ✅ verified (## The trunk-based development workflow heading confirmed at line 36 of _index.md)
L104 pulumi preview link /docs/iac/cli/commands/pulumi_preview/ → ✅ verified (file exists)
L113 Review Stacks link /docs/deployments/deployments/review-stacks/ → ✅ verified (file exists at content/docs/deployments/deployments/review-stacks.md)
L117 pulumi up link /docs/iac/cli/commands/pulumi_up/ → ✅ verified (file exists)
L141 /docs/support/troubleshooting/ci-cd/ → ✅ verified (file exists at content/docs/support/troubleshooting/ci-cd.md)
Cross-sibling: ## Additional resources as final H2 across PR-touched guides → 🤝 matches argocd.md, aws-code-services.md, azure-devops.md (all confirmed after this PR's changes)

🚨 Outstanding in this PR

No outstanding issues.

⚠️ Low-confidence

No low-confidence findings.

💡 Pre-existing issues in touched files

No pre-existing issues extracted.

✅ Resolved since last review

No prior review.

📜 Review history

2026-05-20T12:00:00Z — Initial review: clean pass; Codefresh rewrite and sibling heading standardization verified with no issues (f973e08)

Need a re-review? Want to dispute a finding? Mention @claude and include #update-review.
(For ad-hoc questions or fixes, just @claude — no hashtag.)

github-actions · 2026-05-20T22:32:40Z

🤖 Review updated on @pulumi-bot's request.

pulumi-bot · 2026-05-20T22:36:25Z

Pre-merge Review — Last updated 2026-05-20T12:15:00Z

Tip

Summary: This PR rewrites codefresh.md to the standard Pulumi CI/CD guide template (Pulumi Cloud auth, ESC, OIDC, trunk-based preview/staging/production workflow) and renames the closing section heading to ## Additional resources in three recently-revised sibling guides (Argo CD, AWS Code Services, Azure DevOps). The rewrite removes screenshots and a Kubernetes-only example, replacing them with a generalized multi-cloud pipeline guide. The main failure mode that could block readers is broken links or inaccurate CLI commands; all links and commands were verified. Full factual verification, cross-sibling heading consistency check, and code-examples checks ran.

Review confidence:

Dimension	Level	Notes
mechanics	HIGH
facts	HIGH
cross-sibling consistency	HIGH	read 4 of 16 siblings (the 4 PR-touched guides)

Investigation log

Cross-sibling reads: 4 of 16 siblings (argocd, aws-code-services, azure-devops, codefresh — the PR-touched guides; heading consistency verified across all four)
External claim verification: 16 of 16 claims verified (0 unverifiable, 0 contradicted) · 4 specialists (numerical, cross-reference, capability, framing); 0 cross-specialist corroborations · routed: 12 inline, 0 Pass 1, 2 Pass 2 (verified 2, contradicted 0, unverifiable 0), 2 Pass 3 (verified 2, contradicted 0, unverifiable 0)
Cited-claim spot-checks: not run (no cited claims with inline citations requiring spot-check)
Frontmatter sweep: ran on body + meta_desc + title (no social.* keys in frontmatter)
Temporal-trigger sweep: not run (no trigger words in diff)
Code execution: not run (no static/programs/ change)
Code-examples checks: ran (3 specialists: structural, existence, body-code-coverage); 0 findings
Editorial-balance pass: not run (not under content/blog/)

🚨 Outstanding	⚠️ Low-confidence	💡 Pre-existing	✅ Resolved
0	0	0	0

🔍 Verification trail

16 claims extracted · 16 verified · 0 unverifiable · 0 contradicted

L21 "Codefresh is a CI/CD platform for Kubernetes and Argo CD, now part of Octopus Deploy" → ✅ verified (Octopus Deploy acquired Codefresh on Feb 27, 2024; source: prnewswire.com/news-releases/octopus-deploy-acquires-codefresh-302071690.html)
L21 "Its CI pipelines run each step as a container" → ✅ verified (Codefresh freestyle step docs confirm: "run commands inside a Docker container"; source: codefresh.io/docs/docs/pipelines/steps/freestyle/)
L21 "pulumi/pulumi container image ships the Pulumi CLI and every language runtime" → ✅ verified (pulumi/pulumi-docker-containers README describes this as the "kitchen sink" image including Go, Python, Node, .NET, Java; source: github.com/pulumi/pulumi-docker-containers README)
L21 Docker Hub link https://hub.docker.com/r/pulumi/pulumi → ✅ verified (URL resolves; verified via Pass 2 agent)
L24 state-and-backends link /docs/iac/concepts/state-and-backends/ → ✅ verified (file exists at content/docs/iac/concepts/state-and-backends.md)
L29 Codefresh freestyle step link https://codefresh.io/docs/docs/pipelines/steps/freestyle/ → ✅ verified (URL resolves to live page; verified via Pass 2 agent)
L34 Argo CD guide link /docs/iac/guides/continuous-delivery/argocd/ → ✅ verified (file exists)
L34 PKO link /docs/integrations/clouds/kubernetes/pulumi-kubernetes-operator/ → ✅ verified (file exists)
L49 anchor #creating-an-organization-access-token on /docs/administration/access-identity/access-tokens/ → ✅ verified (heading ## Organization access tokens {#creating-an-organization-access-token} confirmed at line 82 of access-tokens.md)
L53 OIDC issuers link /docs/administration/access-identity/oidc-issuers/ → ✅ verified (directory exists)
L68 stacks link /docs/iac/concepts/stacks/ → ✅ verified (file exists at content/docs/iac/concepts/stacks.md)
L91 pulumi install command and link /docs/iac/cli/commands/pulumi_install/ → ✅ verified (file exists; command is real)
L100 anchor #the-trunk-based-development-workflow on /docs/iac/guides/continuous-delivery/ → ✅ verified (## The trunk-based development workflow heading confirmed at line 36 of _index.md)
L104 pulumi preview link /docs/iac/cli/commands/pulumi_preview/ → ✅ verified (file exists)
L113 Review Stacks link /docs/deployments/deployments/review-stacks/ → ✅ verified (file exists at content/docs/deployments/deployments/review-stacks.md)
L117 pulumi up link /docs/iac/cli/commands/pulumi_up/ → ✅ verified (file exists)
L141 /docs/support/troubleshooting/ci-cd/ → ✅ verified (file exists at content/docs/support/troubleshooting/ci-cd.md)
Cross-sibling: ## Additional resources as final H2 across PR-touched guides → 🤝 matches argocd.md, aws-code-services.md, azure-devops.md (all confirmed after this PR's changes)

🚨 Outstanding in this PR

No outstanding issues.

⚠️ Low-confidence

No low-confidence findings.

💡 Pre-existing issues in touched files

No pre-existing issues extracted.

✅ Resolved since last review

No prior review.

📜 Review history

2026-05-20T12:00:00Z — Initial review: clean pass; Codefresh rewrite and sibling heading standardization verified with no issues (f973e08)
2026-05-20T12:05:00Z — Re-posted pinned comment on request (no new commits; findings unchanged) (f973e08)
2026-05-20T12:15:00Z — Re-verified on request (@pulumi-bot); no new commits, 0 outstanding findings unchanged (f973e08)

Need a re-review? Want to dispute a finding? Mention @claude and include #update-review.
(For ad-hoc questions or fixes, just @claude — no hashtag.)

github-actions · 2026-05-20T22:36:38Z

🤖 Review updated on @pulumi-bot's request.

github-actions · 2026-05-20T22:39:44Z

🤖 Review updated on @pulumi-bot's request.

jkodroff marked this pull request as ready for review May 20, 2026 21:53

jkodroff requested a review from CamSoper May 20, 2026 21:53

jkodroff force-pushed the jkodroff/revise-cicd-codefresh branch from 494d759 to f973e08 Compare May 20, 2026 21:56

jkodroff temporarily deployed to testing May 20, 2026 21:56 — with GitHub Actions Inactive

github-actions Bot added the review:in-progress Claude review is currently running label May 20, 2026

github-actions Bot added review:no-blockers Claude review completed cleanly; outstanding is empty and removed review:in-progress Claude review is currently running labels May 20, 2026

jkodroff requested a review from alexleventer May 21, 2026 22:41

cnunciato approved these changes May 21, 2026

View reviewed changes

jkodroff merged commit a7aacaf into master May 22, 2026
12 checks passed

jkodroff deleted the jkodroff/revise-cicd-codefresh branch May 22, 2026 02:26

jkodroff temporarily deployed to testing May 22, 2026 02:26 — with GitHub Actions Inactive

jkodroff mentioned this pull request May 22, 2026

content(cicd): rewrite the TeamCity guide #19328

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

content(cicd): rewrite the Codefresh guide (#19199)#19299

content(cicd): rewrite the Codefresh guide (#19199)#19299
jkodroff merged 1 commit into
masterfrom
jkodroff/revise-cicd-codefresh

jkodroff commented May 20, 2026

Uh oh!

pulumi-bot commented May 20, 2026

Uh oh!

jkodroff commented May 20, 2026

Uh oh!

pulumi-bot commented May 20, 2026

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

pulumi-bot commented May 20, 2026

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

pulumi-bot commented May 20, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

jkodroff commented May 20, 2026

Changes

Uh oh!

pulumi-bot commented May 20, 2026

Uh oh!

jkodroff commented May 20, 2026

Uh oh!

pulumi-bot commented May 20, 2026

Pre-merge Review — Last updated 2026-05-20T00:00:00Z

🔍 Verification trail

🚨 Outstanding in this PR

⚠️ Low-confidence

✅ Resolved since last review

📜 Review history

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

pulumi-bot commented May 20, 2026

Pre-merge Review — Last updated 2026-05-20T12:00:00Z

🔍 Verification trail

🚨 Outstanding in this PR

⚠️ Low-confidence

💡 Pre-existing issues in touched files

✅ Resolved since last review

📜 Review history

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

pulumi-bot commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pre-merge Review — Last updated 2026-05-20T12:15:00Z

🔍 Verification trail

🚨 Outstanding in this PR

⚠️ Low-confidence

💡 Pre-existing issues in touched files

✅ Resolved since last review

📜 Review history

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

pulumi-bot commented May 20, 2026 •

edited

Loading