From 01e126bf8e892c2eb792b61a9df43e39becacc00 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Tue, 10 Dec 2024 11:41:45 +0000 Subject: [PATCH 1/4] add two new faqs --- website/docs/docs/cloud/git/connect-gitlab.md | 15 +++------------ website/docs/docs/deploy/ci-jobs.md | 3 +++ .../Troubleshooting/error-importing-repo.md | 14 ++++++++++++++ .../faqs/Troubleshooting/gitlab-webhook.md | 19 +++++++++++++++++++ 4 files changed, 39 insertions(+), 12 deletions(-) create mode 100644 website/docs/faqs/Troubleshooting/error-importing-repo.md create mode 100644 website/docs/faqs/Troubleshooting/gitlab-webhook.md diff --git a/website/docs/docs/cloud/git/connect-gitlab.md b/website/docs/docs/cloud/git/connect-gitlab.md index 40d84f7d164..d1b0d5071fc 100644 --- a/website/docs/docs/cloud/git/connect-gitlab.md +++ b/website/docs/docs/cloud/git/connect-gitlab.md @@ -10,6 +10,7 @@ Connecting your GitLab account to dbt Cloud provides convenience and another lay - Clone repos using HTTPS rather than SSH. - Carry GitLab user permissions through to dbt Cloud or dbt Cloud CLI's git actions. - Trigger [Continuous integration](/docs/deploy/continuous-integration) builds when merge requests are opened in GitLab. + - GitLab automatically registers a webhook in your GitLab repository to enable seamless integration with dbt Cloud. The steps to integrate GitLab in dbt Cloud depend on your plan. If you are on: - the Developer or Team plan, read these [instructions](#for-dbt-cloud-developer-and-team-tiers). @@ -114,20 +115,10 @@ If your GitLab account is not connected, you’ll see "No connected account". Se Once you approve authorization, you will be redirected to dbt Cloud, and you should see your connected account. You're now ready to start developing in the dbt Cloud IDE or dbt Cloud CLI. - -## Troubleshooting - -### Errors when importing a repository on dbt Cloud project set up -If you do not see your repository listed, double-check that: -- Your repository is in a Gitlab group you have access to. dbt Cloud will not read repos associated with a user. - -If you do see your repository listed, but are unable to import the repository successfully, double-check that: -- You are a maintainer of that repository. Only users with maintainer permissions can set up repository connections. - -If you imported a repository using the dbt Cloud native integration with GitLab, you should be able to see the clone strategy is using a `deploy_token`. If it's relying on an SSH key, this means the repository was not set up using the native GitLab integration, but rather using the generic git clone option. The repository must be reconnected in order to get the benefits described above. - ## FAQs + + diff --git a/website/docs/docs/deploy/ci-jobs.md b/website/docs/docs/deploy/ci-jobs.md index 1128dfd7abc..0f9b6ba377a 100644 --- a/website/docs/docs/deploy/ci-jobs.md +++ b/website/docs/docs/deploy/ci-jobs.md @@ -188,6 +188,8 @@ To validate _all_ semantic nodes in your project, add the following command to d ## Troubleshooting + + If your temporary schemas aren't dropping after a PR merges or closes, this typically indicates one of these issues: - You have overridden the generate_schema_name macro and it isn't using dbt_cloud_pr_ as the prefix. @@ -201,6 +203,7 @@ A macro is creating a schema but there are no dbt models writing to that schema. + If you receive a schema-related error message referencing a previous PR, this is usually an indicator that you are not using a production job for your deferral and are instead using self. If the prior PR has already been merged, the prior PR's schema may have been dropped by the time the CI job for the current PR is kicked off. diff --git a/website/docs/faqs/Troubleshooting/error-importing-repo.md b/website/docs/faqs/Troubleshooting/error-importing-repo.md new file mode 100644 index 00000000000..5f00517e23a --- /dev/null +++ b/website/docs/faqs/Troubleshooting/error-importing-repo.md @@ -0,0 +1,14 @@ +--- +title: Errors importing a repository on dbt Cloud project set up +description: "Errors importing a repository on dbt Cloud project set up" +sidebar_label: 'Errors importing a repository on dbt Cloud project set up' +id: error-importing-repo +--- + +If you don't see your repository listed, double-check that: +- Your repository is in a Gitlab group you have access to. dbt Cloud will not read repos associated with a user. + +If you do see your repository listed, but are unable to import the repository successfully, double-check that: +- You are a maintainer of that repository. Only users with maintainer permissions can set up repository connections. + +If you imported a repository using the dbt Cloud native integration with GitLab, you should be able to see the clone strategy is using a `deploy_token`. If it's relying on an SSH key, this means the repository was not set up using the native GitLab integration, but rather using the generic git clone option. The repository must be reconnected in order to get the benefits described above. diff --git a/website/docs/faqs/Troubleshooting/gitlab-webhook.md b/website/docs/faqs/Troubleshooting/gitlab-webhook.md new file mode 100644 index 00000000000..644a9a1714a --- /dev/null +++ b/website/docs/faqs/Troubleshooting/gitlab-webhook.md @@ -0,0 +1,19 @@ +--- +title: Unable to trigger a CI job with GitLab +description: "Unable to trigger a CI job" +sidebar_label: 'Unable to trigger a CI job' +id: gitlab-webhook +--- + +When you connect dbt Cloud to a GitLab repository, GitLab automatically registers a webhook in the background, viewable under the repository settings. This webhook is also used to trigger [CI jobs](/docs/deploy/ci-jobs) when you push to the repository. + +If you're unable to trigger a CI job, this usually indicates that the webhook registration is missing or incorrect. + +To resolve this issue, navigate to the repository settings in GitLab and view webhook registrations by navigating to GitLab --> **Settings** --> **Webhooks**. + +Some things to check: + +- The webhook registration is enabled in GitLab. +- The webhook registration is configured with the correct URL and secret. + +If you're still experiencing this issue, reach out to the Support team at support@getdbt.com and we'll be happy to help! From 0154a1afc85dae0db26fefd8fad95f14d1f92bcd Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Tue, 10 Dec 2024 11:47:13 +0000 Subject: [PATCH 2/4] change header --- website/docs/docs/cloud/git/connect-gitlab.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/cloud/git/connect-gitlab.md b/website/docs/docs/cloud/git/connect-gitlab.md index d1b0d5071fc..d16cdb15b8e 100644 --- a/website/docs/docs/cloud/git/connect-gitlab.md +++ b/website/docs/docs/cloud/git/connect-gitlab.md @@ -115,7 +115,7 @@ If your GitLab account is not connected, you’ll see "No connected account". Se Once you approve authorization, you will be redirected to dbt Cloud, and you should see your connected account. You're now ready to start developing in the dbt Cloud IDE or dbt Cloud CLI. -## FAQs +## Troubleshooting From 93ed8665ebc806240697fbeb8b0729b8e56e5fa6 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 10 Dec 2024 12:18:02 +0000 Subject: [PATCH 3/4] Update website/docs/faqs/Troubleshooting/error-importing-repo.md Co-authored-by: nataliefiann <120089939+nataliefiann@users.noreply.github.com> --- website/docs/faqs/Troubleshooting/error-importing-repo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/faqs/Troubleshooting/error-importing-repo.md b/website/docs/faqs/Troubleshooting/error-importing-repo.md index 5f00517e23a..85c9ffb0745 100644 --- a/website/docs/faqs/Troubleshooting/error-importing-repo.md +++ b/website/docs/faqs/Troubleshooting/error-importing-repo.md @@ -11,4 +11,4 @@ If you don't see your repository listed, double-check that: If you do see your repository listed, but are unable to import the repository successfully, double-check that: - You are a maintainer of that repository. Only users with maintainer permissions can set up repository connections. -If you imported a repository using the dbt Cloud native integration with GitLab, you should be able to see the clone strategy is using a `deploy_token`. If it's relying on an SSH key, this means the repository was not set up using the native GitLab integration, but rather using the generic git clone option. The repository must be reconnected in order to get the benefits described above. +If you imported a repository using the dbt Cloud native integration with GitLab, you should be able to see if the clone strategy is using a `deploy_token`. If it's relying on an SSH key, this means the repository was not set up using the native GitLab integration, but rather using the generic git clone option. The repository must be reconnected in order to get the benefits described above. From 113906b3cbb200b32f92a5057def237e89c9c48d Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 10 Dec 2024 12:18:10 +0000 Subject: [PATCH 4/4] Update website/docs/faqs/Troubleshooting/gitlab-webhook.md Co-authored-by: nataliefiann <120089939+nataliefiann@users.noreply.github.com> --- website/docs/faqs/Troubleshooting/gitlab-webhook.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/faqs/Troubleshooting/gitlab-webhook.md b/website/docs/faqs/Troubleshooting/gitlab-webhook.md index 644a9a1714a..450796db83e 100644 --- a/website/docs/faqs/Troubleshooting/gitlab-webhook.md +++ b/website/docs/faqs/Troubleshooting/gitlab-webhook.md @@ -9,7 +9,7 @@ When you connect dbt Cloud to a GitLab repository, GitLab automatically register If you're unable to trigger a CI job, this usually indicates that the webhook registration is missing or incorrect. -To resolve this issue, navigate to the repository settings in GitLab and view webhook registrations by navigating to GitLab --> **Settings** --> **Webhooks**. +To resolve this issue, navigate to the repository settings in GitLab and view the webhook registrations by navigating to GitLab --> **Settings** --> **Webhooks**. Some things to check: