-
Upon triggering of a CI job, the status of the check in your Pull Request should change to `pending` while awaiting an update from dbt. After the CI job run completes, dbt sends the status to ADO which will update to either `succeeded` or `failed`. If this does not update after run completion, ensure that there are no branch policies in place that is preventing ADO from receiving these updates. Relevant articles can be found here:
-
Azure DevOps Services Pull Request Stuck Waiting on Status Update
-
Pull request status
-
+
PR status for CI job stays in 'pending' in Azure DevOps after job run finishes
+
+ When you start a CI job, the pull request status should show as `pending` while it waits for an update from dbt. Once the CI job finishes, dbt sends the status to Azure DevOps (ADO), and the status will change to either `succeeded` or `failed`.
+
+ If the status doesn't get updated after the job runs, check if there are any git branch policies in place that's blocking ADO from receiving these updates. You can find relevant information here:
+
From 4564ac159335c2ffcda0733362ec38346f32e0ea Mon Sep 17 00:00:00 2001
From: mirnawong1
Date: Thu, 8 Feb 2024 21:48:32 +0000
Subject: [PATCH 3/3] update to toggles
---
website/docs/docs/deploy/ci-jobs.md | 128 +++++++++++++---------------
1 file changed, 58 insertions(+), 70 deletions(-)
diff --git a/website/docs/docs/deploy/ci-jobs.md b/website/docs/docs/deploy/ci-jobs.md
index 75644d6e781..fd0555736cd 100644
--- a/website/docs/docs/deploy/ci-jobs.md
+++ b/website/docs/docs/deploy/ci-jobs.md
@@ -50,7 +50,6 @@ To make CI job creation easier, many options on the **CI job** page are set to d
-
## Trigger a CI job with the API
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.
@@ -87,74 +86,63 @@ The green checkmark means the dbt build and tests were successful. Clicking on t
-
## Troubleshooting
-If you're experiencing any issues, review some of the common questions and answers below.
-
-
- Temporary schemas aren't dropping
-
-
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.
To resolve this, change your macro so that the temporary PR schema name contains the required prefix. For example:
-
- ✅ Temporary PR schema name contains the prefix dbt_cloud_pr_ (like dbt_cloud_pr_123_456_marketing).
- ❌ Temporary PR schema name doesn't contain the prefix dbt_cloud_pr_ (like marketing).
-
-
- -
- A macro is creating a schema but there are no dbt models writing to that schema. dbt Cloud doesn't drop temporary schemas that weren't written to as a result of running a dbt model.
-
-
-
-
-
- Error messages that refer to schemas from previous PRs
-
-
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.
-
- To fix this issue, select a production job run to defer to instead of self.
-
-
-
- Production job runs failing at the Clone Git Repository step
-
-
dbt Cloud can only check out commits that belong to the original repository. dbt Cloud cannot checkout commits that belong to a fork of that repository.
-
- If you receive the following error message at the Clone Git Repository step of your job run:
-
- Error message:
- Cloning into '/tmp/jobs/123456/target'...
- Successfully cloned repository.
- Checking out to e845be54e6dc72342d5a8f814c8b3316ee220312...
- Failed to checkout to specified revision.
- git checkout e845be54e6dc72342d5a8f814c8b3316ee220312
- fatal: reference is not a tree: e845be54e6dc72342d5a8f814c8b3316ee220312
-
-
- Double-check that your PR isn't trying to merge using a commit that belongs to a fork of the repository attached to your dbt project.
-
-
- CI job not triggering for Virtual Private dbt users
-
-
To trigger jobs on dbt Cloud using the
API, your Git provider needs to connect to your dbt Cloud account.
-
- If you're on a Virtual Private dbt Enterprise plan using security features like ingress PrivateLink or IP Allowlisting, registering CI hooks may not be available and can cause the job to fail silently.
-
-
-
- PR status for CI job stays in 'pending' in Azure DevOps after job run finishes
-
- When you start a CI job, the pull request status should show as `pending` while it waits for an update from dbt. Once the CI job finishes, dbt sends the status to Azure DevOps (ADO), and the status will change to either `succeeded` or `failed`.
-
- If the status doesn't get updated after the job runs, check if there are any git branch policies in place that's blocking ADO from receiving these updates. You can find relevant information here:
-
-
+If you're experiencing any issues, review some of the common questions and answers.
+
+
+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.
+
+To resolve this, change your macro so that the temporary PR schema name contains the required prefix. For example:
+
+- ✅ Temporary PR schema name contains the prefix dbt_cloud_pr_ (like dbt_cloud_pr_123_456_marketing).
+- ❌ Temporary PR schema name doesn't contain the prefix dbt_cloud_pr_ (like marketing).
+
+A macro is creating a schema but there are no dbt models writing to that schema. dbt Cloud doesn't drop temporary schemas that weren't written to as a result of running a dbt model.
+
+
+
+
+
+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.
+
+To fix this issue, select a production job run to defer to instead of self.
+
+
+
+
+
+dbt Cloud can only check out commits that belong to the original repository. dbt Cloud cannot checkout commits that belong to a fork of that repository.
+
+If you receive the following error message at the **Clone Git Repository** step of your job run:
+
+```
+Error message:
+Cloning into '/tmp/jobs/123456/target'...
+Successfully cloned repository.
+Checking out to e845be54e6dc72342d5a8f814c8b3316ee220312...>
+Failed to checkout to specified revision.
+git checkout e845be54e6dc72342d5a8f814c8b3316ee220312
+fatal: reference is not a tree: e845be54e6dc72342d5a8f814c8b3316ee220312
+```
+
+Double-check that your PR isn't trying to merge using a commit that belongs to a fork of the repository attached to your dbt project.
+
+
+
+
+To trigger jobs on dbt Cloud using the [API](https://docs.getdbt.com/docs/dbt-cloud-apis/admin-cloud-api), your Git provider needs to connect to your dbt Cloud account.
+
+If you're on a Virtual Private dbt Enterprise plan using security features like ingress PrivateLink or IP Allowlisting, registering CI hooks may not be available and can cause the job to fail silently.
+
+
+
+
+When you start a CI job, the pull request status should show as `pending` while it waits for an update from dbt. Once the CI job finishes, dbt sends the status to Azure DevOps (ADO), and the status will change to either `succeeded` or `failed`.
+
+If the status doesn't get updated after the job runs, check if there are any git branch policies in place that's blocking ADO from receiving these updates. You can find relevant information here:
+- [Azure DevOps Services Pull Request Stuck Waiting on Status Update](https://support.hashicorp.com/hc/en-us/articles/18670331556627-Azure-DevOps-Services-Pull-Request-Stuck-Waiting-on-Status-Update-from-Terraform-Cloud-Enterprise-Run)
+- [Pull request status](https://learn.microsoft.com/en-us/azure/devops/repos/git/pull-request-status?view=azure-devops#pull-request-status)
+
+