Deploy8 min readBeginner

Ship to dbt

Push your DataChonk project to Git and deploy to dbt Cloud in one seamless flow. Build with Chonk, ship to production.

How It Works

DataChonk generates complete dbt projects. To get them running in production, you need to push the code to a Git repository. dbt Cloud (or dbt Core with your own orchestration) then pulls from Git to run your transformations.

Understanding the flow

dbt Cloud is designed around Git-based workflows. There is no direct file upload API - all code must flow through a Git repository. DataChonk automates this entire process: build your models, push to Git, and trigger dbt Cloud runs - all in one click.

Build in Chonk

Push to Git

Trigger dbt Run

Live in Production

Supported Git Providers

DataChonk supports all major Git providers. Connect one or more and choose where to push each project.

GitHub

Push to public or private repositories. Create new repos or push to existing ones.

GitLab

Full GitLab.com support. Self-hosted GitLab coming soon.

Bitbucket

Atlassian Bitbucket Cloud support for teams using the Atlassian ecosystem.

Azure DevOps

Push to Azure Repos for enterprise teams on Microsoft Azure.

Quick Start

Get your first DataChonk project deployed in under 5 minutes.

Connect a Git provider

From any project, click Ship to dbt. If you haven't connected a Git provider yet, you'll see buttons to connect GitHub, GitLab, Bitbucket, or Azure DevOps.

OAuth will redirect you to authorize DataChonk. We request minimal permissions: read/write to repository contents only.

Choose repository

Create a new repository or push to an existing one:

New repository: Enter a name and choose public or private
Existing repository: Select from the dropdown and choose a branch

Push and deploy

Click Push to send your generated code to Git. DataChonk creates a commit with all your models, tests, and documentation.

Optionally, connect dbt Cloud to trigger a run immediately after pushing.

dbt Cloud Integration

After pushing to Git, you can optionally trigger a dbt Cloud run to validate your changes immediately.

Connecting dbt Cloud

You'll need your dbt Cloud API token and account ID. Find these in dbt Cloud:

Go to Account Settings in dbt Cloud
Navigate to API Access → Service Tokens
Create a token with 'Jobs' and 'Runs' permissions
Note your Account ID from the URL (e.g., cloud.getdbt.com/accounts/12345)

Triggering Runs

Once connected, you can:

Select a dbt Cloud project (must be connected to the same Git repo)
Choose a job to run (e.g., 'dbt build' or 'dbt test')
Monitor run status in real-time from DataChonk
Jump to dbt Cloud to view full run logs

No dbt Cloud?

dbt Cloud integration is optional. If you use dbt Core with Airflow, Dagster, or another orchestrator, just push to Git and let your existing CI/CD handle the rest.

CLI Usage

Prefer the command line? The DataChonk CLI supports all deploy features.

Terminal

# Push to default Git provider and branch
datachonk push

# Push to a specific provider
datachonk push --provider github

# Create a new repository
datachonk push --new-repo my-dbt-project --private

# Push to a specific branch
datachonk push --branch feature/new-models

# Trigger a dbt Cloud run after pushing
datachonk push --trigger-dbt-run --job-id 12345

# Dry run to see what would be pushed
datachonk push --dry-run

Configuration

Configure defaults in your datachonk.yaml:

datachonk.yaml

deploy:
  git_provider: github
  repository: myorg/dbt-warehouse
  branch: main
  
  dbt_cloud:
    account_id: 12345
    project_id: 67890
    job_id: 11111
    auto_trigger: true

Best Practices

Use feature branches

Push to a feature branch first, then create a pull request for review. This gives your team a chance to review generated code before it hits production.

Enable branch protection

Require pull request reviews and CI checks before merging to main. DataChonk can push to feature branches and your existing CI validates the code.

Use slim CI jobs

Create a dedicated dbt Cloud job with dbt build --select state:modified+ for quick validation of new models without running the entire project.

Ship to dbt

Push your DataChonk project to Git and deploy to dbt Cloud in one seamless flow. Build with Chonk, ship to production.

How It Works

Understanding the flow

Build in Chonk

Push to Git

Trigger dbt Run

Live in Production

Supported Git Providers

DataChonk supports all major Git providers. Connect one or more and choose where to push each project.

GitHub

Push to public or private repositories. Create new repos or push to existing ones.

GitLab

Full GitLab.com support. Self-hosted GitLab coming soon.

Bitbucket

Atlassian Bitbucket Cloud support for teams using the Atlassian ecosystem.

Azure DevOps

Push to Azure Repos for enterprise teams on Microsoft Azure.

Quick Start

Get your first DataChonk project deployed in under 5 minutes.

Connect a Git provider

From any project, click Ship to dbt. If you haven't connected a Git provider yet, you'll see buttons to connect GitHub, GitLab, Bitbucket, or Azure DevOps.

OAuth will redirect you to authorize DataChonk. We request minimal permissions: read/write to repository contents only.

Choose repository

Create a new repository or push to an existing one:

New repository: Enter a name and choose public or private
Existing repository: Select from the dropdown and choose a branch

Push and deploy

Click Push to send your generated code to Git. DataChonk creates a commit with all your models, tests, and documentation.

Optionally, connect dbt Cloud to trigger a run immediately after pushing.

dbt Cloud Integration

After pushing to Git, you can optionally trigger a dbt Cloud run to validate your changes immediately.

Connecting dbt Cloud

You'll need your dbt Cloud API token and account ID. Find these in dbt Cloud:

Go to Account Settings in dbt Cloud
Navigate to API Access → Service Tokens
Create a token with 'Jobs' and 'Runs' permissions
Note your Account ID from the URL (e.g., cloud.getdbt.com/accounts/12345)

Triggering Runs

Once connected, you can:

Select a dbt Cloud project (must be connected to the same Git repo)
Choose a job to run (e.g., 'dbt build' or 'dbt test')
Monitor run status in real-time from DataChonk
Jump to dbt Cloud to view full run logs

No dbt Cloud?

dbt Cloud integration is optional. If you use dbt Core with Airflow, Dagster, or another orchestrator, just push to Git and let your existing CI/CD handle the rest.

CLI Usage

Prefer the command line? The DataChonk CLI supports all deploy features.

Terminal

# Push to default Git provider and branch
datachonk push

# Push to a specific provider
datachonk push --provider github

# Create a new repository
datachonk push --new-repo my-dbt-project --private

# Push to a specific branch
datachonk push --branch feature/new-models

# Trigger a dbt Cloud run after pushing
datachonk push --trigger-dbt-run --job-id 12345

# Dry run to see what would be pushed
datachonk push --dry-run

Configuration

Configure defaults in your datachonk.yaml:

datachonk.yaml

deploy:
  git_provider: github
  repository: myorg/dbt-warehouse
  branch: main
  
  dbt_cloud:
    account_id: 12345
    project_id: 67890
    job_id: 11111
    auto_trigger: true

Best Practices

Use feature branches

Push to a feature branch first, then create a pull request for review. This gives your team a chance to review generated code before it hits production.

Enable branch protection

Require pull request reviews and CI checks before merging to main. DataChonk can push to feature branches and your existing CI validates the code.

Use slim CI jobs

Create a dedicated dbt Cloud job with dbt build --select state:modified+ for quick validation of new models without running the entire project.

How It Works

Supported Git Providers

Quick Start

Connect a Git provider

Choose repository

Push and deploy

dbt Cloud Integration

Connecting dbt Cloud

Triggering Runs

CLI Usage

Configuration

Best Practices

Use feature branches

Enable branch protection

Use slim CI jobs

Related Documentation

GitHub Integration

CI/CD Best Practices

CLI Reference

dbt Cloud Setup

How It Works

Supported Git Providers

Quick Start

Connect a Git provider

Choose repository

Push and deploy

dbt Cloud Integration

Connecting dbt Cloud

Triggering Runs

CLI Usage

Configuration

Best Practices

Use feature branches

Enable branch protection

Use slim CI jobs

Related Documentation

GitHub Integration

CI/CD Best Practices

CLI Reference

dbt Cloud Setup