Skip to content

Add dbt Cloud setup guide#72

Open
ijac13 wants to merge 7 commits intodocs-v3from
pr2c-dbt-cloud-setup
Open

Add dbt Cloud setup guide#72
ijac13 wants to merge 7 commits intodocs-v3from
pr2c-dbt-cloud-setup

Conversation

@ijac13
Copy link
Contributor

@ijac13 ijac13 commented Feb 27, 2026

Summary

Create setup guide for using Recce Cloud with dbt Cloud CI/CD. Covers retrieving artifacts via dbt Cloud API instead of generating them locally.

Scope

Path Action Doc Type Notes
2-getting-started/dbt-cloud-setup.md Create Tutorial Setup guide for Recce Cloud + dbt Cloud CI/CD

Quality Checks

Check Issues Status
QA 2 minor: "pull request" terminology, recency signal ✅ Passed
AISEO 1 minor: recency signal ✅ Passed
Checklist All items verified ✅ Complete

Content Changes

Before → After

File Before After Review
dbt-cloud-setup.md Did not exist Tutorial: set up Recce with dbt Cloud, includes complete GitHub Actions workflow ✅ As planned

Review status:

  • ✅ As planned — Change matches migration plan exactly

Change Review

I reviewed all changes and confirm:

  • All CREATE files contain intended new content
  • All DELETE files have content preserved elsewhere or are intentionally removed
  • All UPDATE files have only intended modifications
  • Navigation updates match the intended structure
  • No unintended changes to other files

Review notes: QA and AISEO checks passed with minor issues. Line 7 uses "pull request" instead of "PR" (should fix). Missing recency signal is non-blocking.

Test plan

  • Verify navigation links work in local preview
  • Check all cross-references resolve correctly
  • Confirm images render properly

🤖 Generated with Claude Code

ijac13 and others added 3 commits February 27, 2026 21:31
Tutorial for setting up Recce Cloud when dbt runs on dbt Cloud,
covering artifact retrieval via dbt Cloud API and GitHub Actions
workflow configuration.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Restructure setup guidance into nested decision tree
- Question 1: Where dbt runs (self-hosted vs dbt Cloud)
  - If self-hosted: sub-options for GitHub Actions vs GitLab/CircleCI
- Question 2: Environment complexity (simple vs advanced)
- Link to dbt Cloud Setup for platform users
- Link to Environment Setup for advanced configurations
ijac13 and others added 3 commits February 27, 2026 22:32
- Add dbt Cloud Setup to mkdocs.yml navigation
- Update setup-cd and setup-ci links to new location (2-getting-started/)
- Add problem statement to dbt-cloud-setup opening
- Remove redundant content between intro and goal
- Spell out PR and CI/CD acronyms on first use
- Fix "bolded steps" references to explicit commands
- Improve image alt text for accessibility
- Rename "Related" to "Next steps" with descriptive links

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy link
Contributor

@even-wei even-wei left a comment

Choose a reason for hiding this comment

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

  1. Warehouse connection is not required here because it runs in Recce Cloud now. The CI job only need to download artifacts from dbt Cloud and upload to Recce Cloud.
  2. We don't need "Run Recce validation", "Generate Recce summary", and "Comment on pull request" steps. Use recce-cloud upload --type prod and recce-cloud upload.

…load

Based on review feedback:
- Remove warehouse connection requirement (runs in Recce Cloud)
- Remove "Run Recce validation", "Generate Recce summary", "Comment on PR" steps
- Split into two workflows: base (CD) and PR (CI)
- Use recce-cloud upload --type prod for base
- Use recce-cloud upload for PR

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy link
Contributor Author

@ijac13 ijac13 left a comment

Choose a reason for hiding this comment

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

@even-wei Thanks for the feedback! Updated in 3afff2f:

  1. ✅ Removed warehouse connection requirement - CI job only downloads artifacts from dbt Cloud and uploads to Recce Cloud
  2. ✅ Removed "Run Recce validation", "Generate Recce summary", and "Comment on pull request" steps
  3. ✅ Split into two workflows:
    • Base workflow (recce-base.yml): recce-cloud upload --type prod
    • PR workflow (recce-pr.yml): recce-cloud upload

Copy link
Contributor

@even-wei even-wei left a comment

Choose a reason for hiding this comment

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

LGTM on technical parts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants