Skip to content

[ready to merge] [TRUNK-17580] Add Google Cloud Build CI provider documentation#482

Merged
trunk-staging-io[bot] merged 7 commits into
mainfrom
sam-gutentag/google-cloud-build-ci-provider
May 7, 2026
Merged

[ready to merge] [TRUNK-17580] Add Google Cloud Build CI provider documentation#482
trunk-staging-io[bot] merged 7 commits into
mainfrom
sam-gutentag/google-cloud-build-ci-provider

Conversation

@samgutentag
Copy link
Copy Markdown
Member

Summary

  • Add new Google Cloud Build CI provider page at flaky-tests/get-started/ci-providers/google-cloud-build.md
  • Cover full setup: GCP Secret Manager for Trunk token, Cloud Build GitHub App connection, trigger creation (PR + push), and cloudbuild.yaml configuration
  • Document required environment variables (TRIGGER_NAME, PROJECT_ID, BUILD_ID, BRANCH_NAME, _HEAD_BRANCH, _PR_NUMBER) — these must be explicitly passed since Cloud Build does not auto-provide them to build steps
  • Include example configurations for both JUnit XML and Bazel BEP uploads
  • Add Google Cloud Build to CI Providers index page card grid and summary.md table of contents

Linear tickets

  • TRUNK-17580 — Add Google Cloud Build CI provider documentation for Flaky Tests (previous attempt was canceled, this is a fresh PR)
  • TRUNK-17525 — Related: CLI flags for non-standard CI usage
  • TRUNK-16338 — Related: AgencyAnalytics uploads from Google Cloud Build

Engineering authors

  • @dfrankland (Dylan Frankland) — authored analytics-cli PR #1031 (Google Cloud Build env var parsing) and flake-farm PR #17341 (example cloudbuild.yaml)

Context links

Files changed

  • flaky-tests/get-started/ci-providers/google-cloud-build.md (new)
  • flaky-tests/get-started/ci-providers/README.md (updated card grid)
  • summary.md (added ToC entry)

Open questions

  1. Google Cloud Build icon: The CI Providers README card grid references google-cloud-build.png as the card cover image. Dylan submitted trunk2 PR #2861 for the UI icon, but a docs-ready PNG for the GitBook card grid needs to be added to .gitbook/assets/. Without this image, the card will render without a cover.
  2. Trunk CLI launcher vs analytics-cli binary: The draft notes used trunk-analytics-cli directly. This PR uses the ./trunk flakytests upload pattern consistent with all other CI provider docs. Confirm this is correct for Google Cloud Build (the Trunk launcher should auto-detect the platform the same way).

Test plan

  • Check GitBook preview renders correctly
  • Verify summary.md entry appears in correct alphabetical position
  • Verify Google Cloud Build card appears in CI Providers index
  • Confirm example cloudbuild.yaml is syntactically valid
  • Have @dfrankland review for technical accuracy
  • Add google-cloud-build.png icon to .gitbook/assets/

Generated with Claude Code

@trunk-staging-io
Copy link
Copy Markdown

trunk-staging-io Bot commented Mar 16, 2026

😎 Merged successfully - details.

New CI provider page with setup instructions for Google Cloud Build integration,
including GCP Secret Manager configuration, Cloud Build triggers, required
environment variables, and example cloudbuild.yaml configurations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@samgutentag samgutentag force-pushed the sam-gutentag/google-cloud-build-ci-provider branch from 8b6f204 to b8c8ca1 Compare March 17, 2026 06:01
@samgutentag
Copy link
Copy Markdown
Member Author

Triage status (2026-05-05): merge conflicts with main in flaky-tests/get-started/ci-providers/README.md and summary.md. Also still needs the google-cloud-build.png icon asset.

@samgutentag
Copy link
Copy Markdown
Member Author

Verification status (2026-05-06): live

Verified: customers can use this. Ready to publish.

  • Eng PRs: analytics-cli#1031 (merged 2026-02-05), flake-farm#17341 (merged 2026-02-10), trunk2#2861 (merged 2026-02-11)
  • Linear tickets: TRUNK-17580 (primary), TRUNK-17525 (related), TRUNK-16338 (related)
  • Flag: none. analytics-cli and flake-farm are non-trunk2 repos so flag detection is skipped (per skill spec). trunk2#2861 just adds an icon asset and has no flag references.
  • Signals: all three merge commits are present on main. The CLI changes shipped in analytics-cli release v0.12.5.

Suggested next action: replace the placeholder google-cloud-build.png icon, ping @dfrankland for technical review, then merge. The docs branch has merge conflicts with main; resolve those first.

samgutentag and others added 5 commits May 6, 2026 20:54
…loud-build-ci-provider

# Conflicts:
#	flaky-tests/get-started/ci-providers/README.md
…d fix vale

- Switch the cloudbuild.yaml example from the trunk launcher
  (./trunk flakytests upload) to the direct binary download pattern
  (./trunk-analytics-cli upload) used by every other CI provider page
  and matched in the analytics-cli reference impl
- Reword the BUILD_ID env var description so vale stops flagging
  the repeated build word

Note: google-cloud-build.png icon for the CI providers grid card on
the README still needs to be added to .gitbook/assets/.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…roviders grid

Adds the missing google-cloud-build.png asset (1600x1000 white canvas
matching peer CI provider icons) and updates the CI providers card grid
on the README so the Google Cloud Build entry renders with a cover
image instead of an empty cell.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@claude
Copy link
Copy Markdown
Contributor

claude Bot commented May 7, 2026

Claude finished @samgutentag's task in 3m 2s —— View job


Review summary

Read all four changed files and compared against peer CI-provider pages (CircleCI, Buildkite, GitLab, Bamboo, etc.) for consistency. Posted six inline comments — the two on summary.md and the CLI-naming one are blocking; the others are polish/consistency.

Findings

  • Read changed files
  • Check for typos, grammar, and formatting
  • Check docs best practices and consistency with peer pages
  • Post inline comments for specific issues
  • Post final review summary

Blocking

  1. summary.md alphabetical orderingGoogle Cloud Build is placed before GitLab, but GitLab < Google alphabetically. The PR's own test plan calls this out ("Verify summary.md entry appears in correct alphabetical position"). The README card grid has it right; summary.md doesn't. (inline)
  2. CLI name inconsistency — line 7 calls the tool the "Trunk Uploader CLI". Every other CI-provider page and the CI Providers README.md use Trunk Analytics CLI. (inline)
  3. Raw-filename link text — two places where GitBook "mention" links render the literal .md filename in the prose:
    • line 97: "…in the frameworks docs" → should be "Test Frameworks". (inline)
    • line 203: "See the uploader.md for all available…" → should be a descriptive link. (inline)

Non-blocking polish

  1. Required env-vars table out of sync with the example — the table lists 6 vars, but the YAML examples pass 8 (COMMIT_SHA and REPO_FULL_NAME are extra). Pick one source of truth. (inline)
  2. Missing platform-binary hint — every peer page closes the examples with an info hint about the Linux x64 binary and a link to platform downloads; this page omits it. (inline)

Other observations (no inline)

  • Detection links use ../../detection.md#stable-branches and ../../detection.md. Most peers use ../../detection/ (directory form), but atlassian-bamboo.md already uses the .md form, so this is a minor inconsistency rather than a broken link.
  • Open-question ok #2 in the PR description says "this PR uses the ./trunk flakytests upload pattern consistent with all other CI provider docs" — the actual examples in this file use ./trunk-analytics-cli upload directly, which is consistent with peers (CircleCI, Buildkite, etc. all do the same). The PR description text is just stale; no doc change needed.
  • Per the existing triage comments, the google-cloud-build.png placeholder still needs to be replaced with the real icon, and merge conflicts with main need to be resolved before merging.
    Branch

@samgutentag samgutentag changed the title [TRUNK-17580] Add Google Cloud Build CI provider documentation [ready to merge] [TRUNK-17580] Add Google Cloud Build CI provider documentation May 7, 2026
Comment thread summary.md Outdated
Comment thread flaky-tests/get-started/ci-providers/google-cloud-build.md Outdated
Comment thread flaky-tests/get-started/ci-providers/google-cloud-build.md Outdated
Comment thread flaky-tests/get-started/ci-providers/google-cloud-build.md Outdated
Comment thread flaky-tests/get-started/ci-providers/google-cloud-build.md
Comment thread flaky-tests/get-started/ci-providers/google-cloud-build.md
Address all six unresolved review threads on the PR:

- summary.md: move Google Cloud Build below GitLab to match
  alphabetical ordering used by the README card grid
- google-cloud-build.md: rename Trunk Uploader CLI to Trunk Analytics
  CLI for consistency with peer CI provider pages
- google-cloud-build.md: replace raw filename link text with
  descriptive text (Test Frameworks, Trunk Analytics CLI)
- google-cloud-build.md: drop COMMIT_SHA and REPO_FULL_NAME from the
  YAML example so the env vars match the documented Required
  Environment Variables table
- google-cloud-build.md: add the standard platform-binary callout that
  every other CI provider page includes after the examples

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@claude
Copy link
Copy Markdown
Contributor

claude Bot commented May 7, 2026

Claude finished @samgutentag's task in 1m 26s —— View job


Review summary (re-review after 0de09ed)

Re-reviewed after the apply review thread fixes commit. Verified each of the six prior findings, plus the merge conflicts and missing icon called out in triage.

Verification of prior findings

  • summary.md alphabetical orderingsummary.md:92-93 now lists GitLab before Google Cloud Build. ✅
  • CLI name "Trunk Analytics CLI"google-cloud-build.md:7 no longer says "Trunk Uploader CLI". ✅
  • frameworks raw filename link textgoogle-cloud-build.md:97 reads "in the Test Frameworks docs". ✅
  • uploader.md raw filename link textgoogle-cloud-build.md:203 reads "See the Trunk Analytics CLI…". ✅
  • Required env-vars table vs. exampleCOMMIT_SHA and REPO_FULL_NAME removed from both YAML tabs (lines 126–132 and 167–173); now matches the 6-row table at line 84–91. ✅
  • Missing platform-binary callout — info hint added at lines 187–189, matching peer pages. ✅

Other resolved items

  • Icon asset.gitbook/assets/google-cloud-build.png is now committed (1600×1000 PNG, 58 KB). ✅
  • Merge conflicts with main — branch shows recent merge commits from origin/main; git diff against origin/main is clean. ✅

Other observations

  • Line 95's note ("you must either run trunk from the repo root…") uses the same phrasing as circleci.md:58, buildkite.md:54, atlassian-bamboo.md:54, jenkins.md:54. Matches peer pages exactly even though the example invokes ./trunk-analytics-cli, so I'd leave it as-is for consistency.
  • Detection links still use ../../detection.md (file form) where most peers use ../../detection/ (directory form), but atlassian-bamboo.md does the same — minor stylistic inconsistency, not a broken link, not blocking.

No remaining blocking issues. This PR looks ready to merge once the existing trunk-merge checkbox is checked.
Branch

Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

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

Auto-approved: Claude code review passed.

@trunk-staging-io trunk-staging-io Bot merged commit 5596c3f into main May 7, 2026
5 of 7 checks passed
@trunk-staging-io trunk-staging-io Bot deleted the sam-gutentag/google-cloud-build-ci-provider branch May 7, 2026 20:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant