-
Notifications
You must be signed in to change notification settings - Fork 976
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
consolidates git provider options (#6691)
- Loading branch information
Showing
14 changed files
with
76 additions
and
52 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
35 changes: 22 additions & 13 deletions
35
website/docs/docs/cloud/git/git-configuration-in-dbt-cloud.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,37 +1,46 @@ | ||
--- | ||
title: "Git configuration in dbt Cloud" | ||
title: "Configure Git in dbt Cloud" | ||
description: "Learn about the Git providers supported in dbt Cloud" | ||
pagination_next: "docs/cloud/git/import-a-project-by-git-url" | ||
pagination_prev: null | ||
hide_table_of_contents: true | ||
pagination_next: "docs/cloud/git/managed-repository" | ||
--- | ||
|
||
<div className="grid--2-col"> | ||
[Version control](/docs/collaborate/git/version-control-basics) — a system that allows you and your teammates to work safely and simultaneously on a single project — is an essential part of the dbt workflow. It enables teams to collaborate effectively and maintain a history of changes to their dbt projects. | ||
|
||
In dbt Cloud, you can configure Git integrations to manage your dbt project code with ease. dbt Cloud offers multiple ways to integrate with you Git provider, catering to diverse team needs and preferences. | ||
|
||
Whether you use a Git integration that natively connects with dbt Cloud or prefer to work with a managed or cloned repository, dbt Cloud supports flexible options to streamline your workflow. | ||
|
||
<div className="grid--3-col"> | ||
|
||
<Card | ||
title="Managed repository" | ||
body="Learn how to quickly set up a project with a managed repository." | ||
link="/docs/cloud/git/managed-repository" | ||
icon="dbt-bit"/> | ||
|
||
<Card | ||
title="Import a project by git URL" | ||
body="Learn how to import a project by using a git URL." | ||
title="Git clone" | ||
body="Learn how to connect to a git repository using a git URL and deploy keys." | ||
link="/docs/cloud/git/import-a-project-by-git-url" | ||
icon="dbt-bit"/> | ||
|
||
<Card | ||
title="Connect to GitHub" | ||
body="Learn how to connect to GitHub." | ||
body="Learn how to connect to GitHub using dbt Cloud's native integration." | ||
link="/docs/cloud/git/connect-github" | ||
icon="dbt-bit"/> | ||
|
||
</div> | ||
<br /> | ||
<div className="grid--2-col"> | ||
<Card | ||
title="Connect to GitLab" | ||
body="Learn how to connect to GitLab." | ||
body="Learn how to connect to GitLab using dbt Cloud's native integration." | ||
link="/docs/cloud/git/connect-gitlab" | ||
icon="dbt-bit"/> | ||
|
||
<Card | ||
title="Connect to Azure DevOps" | ||
body="Learn how to connect to Azure DevOps." | ||
body="Learn how to connect to Azure DevOps using dbt Cloud's native integration. <br /><br />Available on dbt Cloud Enterprise plans." | ||
link="/docs/cloud/git/connect-azure-devops" | ||
icon="dbt-bit"/> | ||
|
||
</div> | ||
</div> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
--- | ||
title: "Connect with managed repository" | ||
id: "managed-repository" | ||
description: "Learn how to set up a project with a managed repository." | ||
pagination_next: "docs/cloud/git/import-a-project-by-git-url" | ||
pagination_prev: "docs/cloud/git/git-configuration-in-dbt-cloud" | ||
--- | ||
|
||
Managed repositories are a great way to trial dbt without needing to create a new repository. If you don't already have a Git repository for your dbt project, you can let dbt Cloud host and manage a repository for you. | ||
|
||
If in the future you choose to host this repository elsewhere, you can export the information from dbt Cloud at any time. Refer to [Move from a managed repository to a self-hosted repository](/faqs/Git/managed-repo) for more information on how to do that. | ||
|
||
|
||
:::info | ||
dbt Labs recommends against using a managed repository in a production environment. You can't use Git features like pull requests, which are part of our recommended version control best practices. | ||
::: | ||
|
||
To set up a project with a managed repository: | ||
|
||
1. From your **Account settings** in dbt Cloud, select the project you want to set up with a managed repository. If the project already has a repository set up, you need to edit the repository settings and disconnect the existing repository. | ||
2. Click **Edit** for the project. | ||
3. Under Repository, click **Configure repository**. | ||
4. Select **Managed**. | ||
5. Enter a name for the repository. For example, "analytics" or "dbt-models." | ||
6. Click **Create**. | ||
<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/managed-repo.png" title="Adding a managed repository"/> | ||
|
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -13,7 +13,7 @@ Your IDE session experienced an unknown error and was terminated. Please contact | |
|
||
``` | ||
|
||
You can try to resolve this by adding a repository like a [managed repository](/docs/collaborate/git/managed-repository) or your preferred Git account. To add your Git account, navigate to **Project** > **Repository** and select your repository. | ||
You can try to resolve this by adding a repository like a [managed repository](/docs/cloud/git/managed-repository) or your preferred Git account. To add your Git account, navigate to **Project** > **Repository** and select your repository. | ||
|
||
|
||
If you're still running into this error, please contact the Support team at [email protected] for help. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,3 @@ | ||
When you develop in dbt Cloud, you can leverage [Git](/docs/collaborate/git-version-control) to version control your code. | ||
|
||
To connect to a repository, you can either set up a dbt Cloud-hosted [managed repository](/docs/collaborate/git/managed-repository) or directly connect to a [supported git provider](/docs/cloud/git/connect-github). Managed repositories are a great way to trial dbt without needing to create a new repository. In the long run, it's better to connect to a supported git provider to use features like automation and [continuous integration](/docs/deploy/continuous-integration). | ||
To connect to a repository, you can either set up a dbt Cloud-hosted [managed repository](/docs/cloud/git/managed-repository) or directly connect to a [supported git provider](/docs/cloud/git/connect-github). Managed repositories are a great way to trial dbt without needing to create a new repository. In the long run, it's better to connect to a supported git provider to use features like automation and [continuous integration](/docs/deploy/continuous-integration). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters