Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Git providers supporting CI #6692

Open
wants to merge 29 commits into
base: current
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 9 commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
e1a18ca
Git providers supporting CI
nataliefiann Dec 19, 2024
3120581
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
ff38b47
Merge branch 'current' into nfiann-ci-and-git
nataliefiann Dec 20, 2024
d81eec1
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
c371c06
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
908affb
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
fe30c33
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
f314739
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
c55b519
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
ddd9dcc
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
36169d8
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
66608e2
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
720642e
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
5270096
Merge branch 'current' into nfiann-ci-and-git
nataliefiann Dec 20, 2024
1daea86
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
17fd9f0
Update website/docs/docs/deploy/continuous-integration.md
nataliefiann Dec 20, 2024
8fbc0de
Rolled in suggested feedback
nataliefiann Dec 20, 2024
f56a112
rolled in suggested feedback
nataliefiann Dec 20, 2024
ddc35e0
Merge branch 'nfiann-ci-and-git' of https://github.com/dbt-labs/docs.…
nataliefiann Dec 20, 2024
82f606e
updated snippet
nataliefiann Dec 20, 2024
cb329f2
updated snippet
nataliefiann Dec 20, 2024
d834ffb
deleted file
nataliefiann Dec 20, 2024
730926c
Added snippet to ci jobs page, import a project by git url and also u…
nataliefiann Dec 20, 2024
bb4d4e5
Merge branch 'current' into nfiann-ci-and-git
nataliefiann Dec 23, 2024
08e4e2e
Amended snippet to add info on non native integration
nataliefiann Dec 23, 2024
1aeccbf
Update website/snippets/_git-providers-supporting-ci.md
nataliefiann Dec 23, 2024
b03f900
Merge branch 'current' into nfiann-ci-and-git
nataliefiann Jan 9, 2025
2aae16d
Merge branch 'current' into nfiann-ci-and-git
nataliefiann Jan 9, 2025
e99c875
Update website/docs/docs/cloud/git/git-configuration-in-dbt-cloud.md
nataliefiann Jan 9, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -34,4 +34,10 @@ pagination_prev: null
link="/docs/cloud/git/connect-azure-devops"
icon="dbt-bit"/>

<Card
title="Git providers who support CI"
body="Learn which Git providers support CI"
Comment on lines +47 to +48
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
title="Git providers who support CI"
body="Learn which Git providers support CI"
title="Availability of CI features by Git provider"
body="Learn which Git providers have native support for Continuous Integration workflows"

Same comment as below - open to alternative phrasing on this though

link="/docs/deploy/continuous-integration#git-providers-who-support-ci"
icon="dbt-bit"/>

nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
</div>
21 changes: 21 additions & 0 deletions website/docs/docs/deploy/continuous-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,27 @@ When the CI run completes, you can view the run status directly from within the

dbt Cloud deletes the temporary schema from your <Term id="data-warehouse" /> when you close or merge the pull request. If your project has schema customization using the [generate_schema_name](/docs/build/custom-schemas#how-does-dbt-generate-a-models-schema-name) macro, dbt Cloud might not drop the temporary schema from your data warehouse. For more information, refer to [Troubleshooting](/docs/deploy/ci-jobs#troubleshooting).

## Git providers who support CI

nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
If your git provider has a native dbt Cloud integration, you can set up [continuous integration (CI) job](/docs/deploy/ci-jobs) within dbt Cloud. For providers without native integration, you can still use a Git URL. The following table explains the available integration options and their capabilities.

| **Git provider** | **Native dbt Cloud integration** |**Automated CI job** |**Git import with URL**| **Information**|
| -----------------| ---------------------------------| -------------------------------------------|-----------------------|---------|
|[Azure DevOps](/docs/cloud/git/setup-azure)<br /> <Lifecycle status="enterprise" />| ✅| ✅ | ✅ | Organizations on the Team Plan can connect to Azure DeveOps via deploy key. Note, you won’t get the automated CI jobs but you can still develop.|
|[GitHub](/docs/cloud/git/connect-github)<br /> <Lifecycle status="developer,team,enterprise" /> | ✅ | ✅ | ✅ |
|[GitLab](/docs/cloud/git/connect-gitlab)<br /> <Lifecycle status="developer,team,enterprise" /> | ✅ | ✅ | ✅ |
|All other git providers imported with a [git URL](/docs/cloud/git/import-a-project-by-git-url) ([BitBucket](/docs/cloud/git/import-a-project-by-git-url#bitbucket), [AWS CodeCommit](/docs/cloud/git/import-a-project-by-git-url#aws-codecommit), and others)| ❌ | ❌ | ✅ | Refer to the [Customizing CI/CD with custom pipelines](/guides/custom-cicd-pipelines?step=1) guide to set up CI/CD.|


nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
### No native integration
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved

import TiggeraCIJob from '/snippets/_trigger-a-ci-job.md';
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved

<TiggeraCIJob />
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved




## Differences between CI jobs and other deployment jobs

The [dbt Cloud scheduler](/docs/deploy/job-scheduler) executes CI jobs differently from other deployment jobs in these important ways:
Expand Down
8 changes: 8 additions & 0 deletions website/snippets/_git-providers-supporting-ci.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
If your git provider has a native dbt Cloud integration, you can set up continuous integration (CI) jobs within dbt Cloud.

| **Git provider** | **Native dbt Cloud integration** |[**Automated CI job**](/docs/deploy/ci-jobs)|**Git import with URL**| **Information**|
| -----------------| ---------------------------------| -------------------------------------------|-----------------------|---------|
|[Azure DevOps](/docs/cloud/git/setup-azure) <Lifecycle status="enterprise" />| ✅| ✅ | ✅ | Organizations on the Team Plan can connect to Azure DeveOps via deploy key. Note, you won’t get the automated CI jobs but you can still develop.|
|[GitHub](/docs/cloud/git/connect-github) <Lifecycle status="developer,team,enterprise" /> | ✅ | ✅ | ✅ |
|[GitLab](/docs/cloud/git/connect-gitlab) <Lifecycle status="developer,team,enterprise" /> | ✅ | ✅ | ✅ |
|All other git providers imported with a [git URL](/docs/cloud/git/import-a-project-by-git-url) ([BitBucket](/docs/cloud/git/import-a-project-by-git-url#bitbucket), [AWS CodeCommit](/docs/cloud/git/import-a-project-by-git-url#aws-codecommit), and others)| ❌ | ❌ | ✅ | Bitbucket doesn’t have a native dbt Cloud integration, refer to the [Customizing CI/CD with custom pipelines](/guides/custom-cicd-pipelines?step=1) guide to set up continuous integration and continuous deployment (CI/CD). |
2 changes: 2 additions & 0 deletions website/snippets/_trigger-a-ci-job.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
If you're not using dbt Cloud’s native Git integration with [GitHub](/docs/cloud/git/connect-github), [GitLab](/docs/cloud/git/connect-gitlab), or [Azure DevOps](/docs/cloud/git/connect-azure-devops), you can use the [Administrative API](/docs/dbt-cloud-apis/admin-cloud-api) to trigger a CI job to run. However, dbt Cloud will not automatically delete the temporary schema for you. This is because automatic deletion relies on incoming webhooks from Git providers, which is only available through the native integrations.
nataliefiann marked this conversation as resolved.
Show resolved Hide resolved

Loading