Skip to content

Commit 7feed51

Browse files
authored
consolidates git provider options (#6691)
2 parents a5ff11c + 62a6439 commit 7feed51

14 files changed

+76
-52
lines changed

website/docs/docs/cloud/dbt-cloud-ide/ide-user-interface.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ The IDE features some delightful tools and layouts to make it easier for you to
6464
<Lightbox src="/img/docs/dbt-cloud/cloud-ide/version-control-options-menu.png" width="30%" title="Right-click edited files to access Version Control Options menu"/>
6565

6666

67-
- Use the **Prune branches** option to remove local branches that have already been deleted from the remote repository. Selecting this triggers a [pop-up modal](#prune-branches-modal), where you can confirm the deletion of the specific local branches, keeping your branch management tidy. Note that this won't delete the branch you're currently on. Pruning branches isn't available for [managed repositories](/docs/collaborate/git/managed-repository) because they don't have a typical remote setup, which prevents remote branch deletion.
67+
- Use the **Prune branches** option to remove local branches that have already been deleted from the remote repository. Selecting this triggers a [pop-up modal](#prune-branches-modal), where you can confirm the deletion of the specific local branches, keeping your branch management tidy. Note that this won't delete the branch you're currently on. Pruning branches isn't available for [managed repositories](/docs/cloud/git/managed-repository) because they don't have a typical remote setup, which prevents remote branch deletion.
6868

6969
## Additional editing features
7070

Lines changed: 22 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,46 @@
11
---
2-
title: "Git configuration in dbt Cloud"
2+
title: "Configure Git in dbt Cloud"
33
description: "Learn about the Git providers supported in dbt Cloud"
4-
pagination_next: "docs/cloud/git/import-a-project-by-git-url"
5-
pagination_prev: null
4+
hide_table_of_contents: true
5+
pagination_next: "docs/cloud/git/managed-repository"
66
---
77

8-
<div className="grid--2-col">
8+
[Version control](/docs/collaborate/git/version-control-basics) &mdash; a system that allows you and your teammates to work safely and simultaneously on a single project &mdash; is an essential part of the dbt workflow. It enables teams to collaborate effectively and maintain a history of changes to their dbt projects.
9+
10+
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.
11+
12+
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.
13+
14+
<div className="grid--3-col">
15+
16+
<Card
17+
title="Managed repository"
18+
body="Learn how to quickly set up a project with a managed repository."
19+
link="/docs/cloud/git/managed-repository"
20+
icon="dbt-bit"/>
921

1022
<Card
11-
title="Import a project by git URL"
12-
body="Learn how to import a project by using a git URL."
23+
title="Git clone"
24+
body="Learn how to connect to a git repository using a git URL and deploy keys."
1325
link="/docs/cloud/git/import-a-project-by-git-url"
1426
icon="dbt-bit"/>
1527

1628
<Card
1729
title="Connect to GitHub"
18-
body="Learn how to connect to GitHub."
30+
body="Learn how to connect to GitHub using dbt Cloud's native integration."
1931
link="/docs/cloud/git/connect-github"
2032
icon="dbt-bit"/>
2133

22-
</div>
23-
<br />
24-
<div className="grid--2-col">
2534
<Card
2635
title="Connect to GitLab"
27-
body="Learn how to connect to GitLab."
36+
body="Learn how to connect to GitLab using dbt Cloud's native integration."
2837
link="/docs/cloud/git/connect-gitlab"
2938
icon="dbt-bit"/>
3039

3140
<Card
3241
title="Connect to Azure DevOps"
33-
body="Learn how to connect to Azure DevOps."
42+
body="Learn how to connect to Azure DevOps using dbt Cloud's native integration. <br /><br />Available on dbt Cloud Enterprise plans."
3443
link="/docs/cloud/git/connect-azure-devops"
3544
icon="dbt-bit"/>
3645

37-
</div>
46+
</div>

website/docs/docs/cloud/git/import-a-project-by-git-url.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,14 @@
11
---
2-
title: "Import a project by git URL"
3-
id: "import-a-project-by-git-url"
4-
pagination_next: "docs/cloud/git/connect-github"
5-
pagination_prev: null
2+
title: "Connect with Git clone"
3+
description: "Learn how to connect to a git repository using a git URL."
64
---
75

86
In dbt Cloud, you can import a git repository from any valid git URL that points to a dbt project. There are some important considerations to keep in mind when doing this.
97

108
## Git protocols
119
You must use the `git@...` or `ssh:..`. version of your git URL, not the `https://...` version. dbt Cloud uses the SSH protocol to clone repositories, so dbt Cloud will be unable to clone repos supplied with the HTTP protocol.
1210

13-
## Managing Deploy Keys
11+
## Managing deploy keys
1412

1513
After importing a project by Git URL, dbt Cloud will generate a Deploy Key for your repository. To find the deploy key in dbt Cloud:
1614

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
title: "Connect with managed repository"
3+
id: "managed-repository"
4+
description: "Learn how to set up a project with a managed repository."
5+
pagination_next: "docs/cloud/git/import-a-project-by-git-url"
6+
pagination_prev: "docs/cloud/git/git-configuration-in-dbt-cloud"
7+
---
8+
9+
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.
10+
11+
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.
12+
13+
14+
:::info
15+
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.
16+
:::
17+
18+
To set up a project with a managed repository:
19+
20+
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.
21+
2. Click **Edit** for the project.
22+
3. Under Repository, click **Configure repository**.
23+
4. Select **Managed**.
24+
5. Enter a name for the repository. For example, "analytics" or "dbt-models."
25+
6. Click **Create**.
26+
<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/managed-repo.png" title="Adding a managed repository"/>
27+

website/docs/docs/collaborate/git/managed-repository.md

Lines changed: 0 additions & 20 deletions
This file was deleted.

website/docs/docs/collaborate/git/pr-template.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ The PR Template URL setting will be automatically set for most repositories, dep
1414

1515
- If you connect to your repository via in-app integrations with your git provider or the "Git Clone" method via SSH, this URL setting will be auto-populated and editable.
1616
- For AWS CodeCommit, this URL setting isn't auto-populated and must be [manually configured](/docs/cloud/git/import-a-project-by-git-url#step-5-configure-pull-request-template-urls-optional).
17-
- If you connect via a dbt Cloud [Managed repository](/docs/collaborate/git/managed-repository), this URL will not be set, and the IDE will prompt users to merge the changes directly into their default branch.
17+
- If you connect via a dbt Cloud [Managed repository](/docs/cloud/git/managed-repository), this URL will not be set, and the IDE will prompt users to merge the changes directly into their default branch.
1818

1919
The PR template URL supports two variables that can be used to build a URL string.
2020
These variables, `{{source}}` and `{{destination}}` return branch names based on the

website/docs/faqs/Git/gitignore.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,11 @@ id: gitignore
77

88
A `.gitignore` file specifies which files git should intentionally ignore or 'untrack'. dbt Cloud indicates untracked files in the project file explorer pane by putting the file or folder name in *italics*.
99

10-
If you encounter issues like problems reverting changes, checking out or creating a new branch, or not being prompted to open a pull request after a commit in the dbt Cloud IDE &mdash; this usually indicates a problem with the [.gitignore](https://github.com/dbt-labs/dbt-starter-project/blob/main/.gitignore) file. The file may be missing or lacks the required entries for dbt Cloud to work correctly.
10+
If you encounter issues like problems reverting changes, checking out or creating a new branch, or not being prompted to open a pull request after a commit in the dbt Cloud IDE &mdash; this usually indicates a problem with the [.gitignore](https://github.com/dbt-labs/dbt-starter-project/blob/main/.gitignore) file. The file may be missing or lacks the required entries for dbt Cloud to work correctly.
1111

12-
### Fix in the dbt Cloud IDE
12+
The following sections describe how to fix the `.gitignore` file in:
13+
14+
<Expandable alt_header="Fix in the dbt Cloud IDE">
1315

1416
To resolve issues with your `gitignore` file, adding the correct entries won't automatically remove (or 'untrack') files or folders that have already been tracked by git. The updated `gitignore` will only prevent new files or folders from being tracked. So you'll need to first fix the `gitignore` file, then perform some additional git operations to untrack any incorrect files or folders.
1517

@@ -51,7 +53,9 @@ For more info on `gitignore` syntax, refer to the [Git docs](https://git-scm.com
5153

5254
<Lightbox src="/img/docs/dbt-cloud/cloud-ide/gitignore-italics.png" width="50%" title="A dbt project on the main branch that has properly configured gitignore folders (highlighted in italics)."/>
5355

54-
### Fix in the git provider
56+
</Expandable>
57+
58+
<Expandable alt_header="Fix in the Git provider">
5559

5660
Sometimes it's necessary to use the git providers web interface to fix a broken `.gitignore` file. Although the specific steps may vary across providers, the general process remains the same.
5761

@@ -121,3 +125,4 @@ dbt_modules/
121125
</Tabs>
122126

123127
For more info, refer to this [detailed video](https://www.loom.com/share/9b3b8e2b617f41a8bad76ec7e42dd014) for additional guidance.
128+
</Expandable>

website/docs/faqs/Troubleshooting/ide-session-unknown-error.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Your IDE session experienced an unknown error and was terminated. Please contact
1313

1414
```
1515

16-
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.
16+
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.
1717

1818

1919
If you're still running into this error, please contact the Support team at [email protected] for help.

website/docs/guides/dbt-python-snowpark.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -262,7 +262,7 @@ We need to obtain our data source by copying our Formula 1 data into Snowflake t
262262
263263
## Configure dbt Cloud
264264
265-
1. We are going to be using [Snowflake Partner Connect](https://docs.snowflake.com/en/user-guide/ecosystem-partner-connect.html) to set up a dbt Cloud account. Using this method will allow you to spin up a fully fledged dbt account with your [Snowflake connection](/docs/cloud/connect-data-platform/connect-snowflake), [managed repository](/docs/collaborate/git/managed-repository), environments, and credentials already established.
265+
1. We are going to be using [Snowflake Partner Connect](https://docs.snowflake.com/en/user-guide/ecosystem-partner-connect.html) to set up a dbt Cloud account. Using this method will allow you to spin up a fully fledged dbt account with your [Snowflake connection](/docs/cloud/connect-data-platform/connect-snowflake), [managed repository](/docs/cloud/git/managed-repository), environments, and credentials already established.
266266
2. Navigate out of your worksheet back by selecting **home**.
267267
3. In Snowsight, confirm that you are using the **ACCOUNTADMIN** role.
268268
4. Navigate to the **Data Products** **> Partner Connect**. Find **dbt** either by using the search bar or navigating the **Data Integration**. Select the **dbt** tile.
@@ -282,7 +282,7 @@ We need to obtain our data source by copying our Formula 1 data into Snowflake t
282282
283283
9. Select **Complete Registration**. You should now be redirected to your dbt Cloud account, complete with a connection to your Snowflake account, a deployment and a development environment, and a sample job.
284284
285-
10. To help you version control your dbt project, we have connected it to a [managed repository](/docs/collaborate/git/managed-repository), which means that dbt Labs will be hosting your repository for you. This will give you access to a Git workflow without you having to create and host the repository yourself. You will not need to know Git for this workshop; dbt Cloud will help guide you through the workflow. In the future, when you’re developing your own project, [feel free to use your own repository](/docs/cloud/git/connect-github). This will allow you to learn more about features like [Slim CI](/docs/deploy/continuous-integration) builds after this workshop.
285+
10. To help you version control your dbt project, we have connected it to a [managed repository](/docs/cloud/git/managed-repository), which means that dbt Labs will be hosting your repository for you. This will give you access to a Git workflow without you having to create and host the repository yourself. You will not need to know Git for this workshop; dbt Cloud will help guide you through the workflow. In the future, when you’re developing your own project, [feel free to use your own repository](/docs/cloud/git/connect-github). This will allow you to learn more about features like [Slim CI](/docs/deploy/continuous-integration) builds after this workshop.
286286
287287
## Change development schema name navigate the IDE
288288

website/docs/guides/sl-snowflake-qs.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -262,7 +262,7 @@ There are two ways to connect dbt Cloud to Snowflake. The first option is Partne
262262
<Tabs>
263263
<TabItem value="partner-connect" label="Use Partner Connect" default>
264264

265-
Using Partner Connect allows you to create a complete dbt account with your [Snowflake connection](/docs/cloud/connect-data-platform/connect-snowflake), [a managed repository](/docs/collaborate/git/managed-repository), [environments](/docs/build/custom-schemas#managing-environments), and credentials.
265+
Using Partner Connect allows you to create a complete dbt account with your [Snowflake connection](/docs/cloud/connect-data-platform/connect-snowflake), [a managed repository](/docs/cloud/git/managed-repository), [environments](/docs/build/custom-schemas#managing-environments), and credentials.
266266

267267
1. In the Snowflake UI, click on the home icon in the upper left corner. In the left sidebar, select **Data Products**. Then, select **Partner Connect**. Find the dbt tile by scrolling or by searching for dbt in the search bar. Click the tile to connect to dbt.
268268

@@ -333,7 +333,7 @@ Using Partner Connect allows you to create a complete dbt account with your [Sno
333333
</Tabs>
334334

335335
## Set up a dbt Cloud managed repository
336-
If you used Partner Connect, you can skip to [initializing your dbt project](#initialize-your-dbt-project-and-start-developing) as Partner Connect provides you with a [managed repository](/docs/collaborate/git/managed-repository). Otherwise, you will need to create your repository connection.
336+
If you used Partner Connect, you can skip to [initializing your dbt project](#initialize-your-dbt-project-and-start-developing) as Partner Connect provides you with a [managed repository](/docs/cloud/git/managed-repository). Otherwise, you will need to create your repository connection.
337337

338338
<Snippet path="tutorial-managed-repo" />
339339

website/docs/guides/snowflake-qs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ There are two ways to connect dbt Cloud to Snowflake. The first option is Partne
142142
<Tabs>
143143
<TabItem value="partner-connect" label="Use Partner Connect" default>
144144

145-
Using Partner Connect allows you to create a complete dbt account with your [Snowflake connection](/docs/cloud/connect-data-platform/connect-snowflake), [a managed repository](/docs/collaborate/git/managed-repository), [environments](/docs/build/custom-schemas#managing-environments), and credentials.
145+
Using Partner Connect allows you to create a complete dbt account with your [Snowflake connection](/docs/cloud/connect-data-platform/connect-snowflake), [a managed repository](/docs/cloud/git/managed-repository), [environments](/docs/build/custom-schemas#managing-environments), and credentials.
146146

147147
1. In the Snowflake UI, click on the home icon in the upper left corner. In the left sidebar, select **Data Products**. Then, select **Partner Connect**. Find the dbt tile by scrolling or by searching for dbt in the search bar. Click the tile to connect to dbt.
148148

website/sidebars.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,7 @@ const sidebarSettings = {
142142
},
143143
items: [
144144
"docs/cloud/git/git-configuration-in-dbt-cloud",
145+
"docs/cloud/git/managed-repository",
145146
"docs/cloud/git/import-a-project-by-git-url",
146147
"docs/cloud/git/connect-github",
147148
"docs/cloud/git/connect-gitlab",
@@ -552,7 +553,6 @@ const sidebarSettings = {
552553
items: [
553554
"docs/collaborate/git-version-control",
554555
"docs/collaborate/git/version-control-basics",
555-
"docs/collaborate/git/managed-repository",
556556
"docs/collaborate/git/pr-template",
557557
"docs/collaborate/git/merge-conflicts",
558558
],
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
When you develop in dbt Cloud, you can leverage [Git](/docs/collaborate/git-version-control) to version control your code.
22

3-
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).
3+
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).

website/vercel.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,11 @@
22
"cleanUrls": true,
33
"trailingSlash": false,
44
"redirects": [
5+
{
6+
"source": "/docs/collaborate/git/managed-repository",
7+
"destination": "/docs/cloud/git/managed-repository",
8+
"permanent": true
9+
},
510
{
611
"source": "/faqs/API/rotate-token",
712
"destination": "/docs/dbt-cloud-apis/service-tokens#service-token-update",
@@ -1372,7 +1377,7 @@
13721377
},
13731378
{
13741379
"source": "/docs/dbt-cloud/cloud-configuring-dbt-cloud/cloud-using-a-managed-repository",
1375-
"destination": "/docs/collaborate/git/managed-repository",
1380+
"destination": "/docs/cloud/git/managed-repository",
13761381
"permanent": true
13771382
},
13781383
{

0 commit comments

Comments
 (0)