Updating Login URL Examples (#4685)

## What are you changing in this pull request and why? The access URLs will be unique per client/region and embedded links of the `cloud.getdbt.com` URL in our docs need to be updated to the generic YOUR_ACCESS_URL. URLs that link to a page in the dbt Cloud product, will be redirected to the Regions & IP Address page that will include instructions on how to find a clients URL. This does not currently touch API pages, just /docs and /guides that link out to cloud.getdbt.com ## Checklist - [x] Review the [Content style guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md) so my content adheres to these guidelines. - [x] For [docs versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#about-versioning), review how to [version a whole page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version) and [version a block of content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content). - [x] Add a checklist item for anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch." --------- Co-authored-by: Mirna Wong <[email protected]>
dbt-labs · Aug 1, 2024 · 011f7ed · 011f7ed
1 parent d12105b
commit 011f7ed
Show file tree

Hide file tree

Showing 13 changed files with 28 additions and 22 deletions.
diff --git a/website/docs/docs/cloud/configure-cloud-cli.md b/website/docs/docs/cloud/configure-cloud-cli.md
@@ -40,6 +40,13 @@ Once you install the dbt Cloud CLI, you need to configure it to connect to a dbt
 
 2. Save the `dbt_cloud.yml` file in the `.dbt` directory, which stores your dbt Cloud CLI configuration. Store it in a safe place as it contains API keys. Check out the [FAQs](#faqs) to learn how to create a `.dbt` directory and move the `dbt_cloud.yml` file.
 
+    - North America: https://YOUR_ACCESS_URL/cloud-cli
+    - EMEA: https://emea.dbt.com/cloud-cli
+    - APAC: https://au.dbt.com/cloud-cli
+    - North American Cell 1: `https:/ACCOUNT_PREFIX.us1.dbt.com/cloud-cli`
+    - Single-tenant: `https://YOUR_ACCESS_URL/cloud-cli`
+
+3. Follow the banner instructions and download the config file to:
    - Mac or Linux:  `~/.dbt/dbt_cloud.yml`
    - Windows:  `C:\Users\yourusername\.dbt\dbt_cloud.yml`  
 
@@ -79,7 +86,7 @@ Once you install the dbt Cloud CLI, you need to configure it to connect to a dbt
         project-id: PROJECT_ID
     ```
 
-   - To find your project ID, select **Develop** in the dbt Cloud navigation menu. You can use the URL to find the project ID. For example, in `https://cloud.getdbt.com/develop/26228/projects/123456`, the project ID is `123456`.
+   - To find your project ID, select **Develop** in the dbt Cloud navigation menu. You can use the URL to find the project ID. For example, in `https://YOUR_ACCESS_URL/develop/26228/projects/123456`, the project ID is `123456`.
 
 5. You should now be able to [use the dbt Cloud CLI](#use-the-dbt-cloud-cli) and run [dbt commands](/reference/dbt-commands) like [`dbt environment show`](/reference/commands/dbt-environment) to view your dbt Cloud configuration details or `dbt compile` to compile models in your dbt project.
 

diff --git a/website/docs/docs/cloud/dbt-cloud-ide/develop-in-the-cloud.md b/website/docs/docs/cloud/dbt-cloud-ide/develop-in-the-cloud.md
@@ -39,7 +39,7 @@ To improve your experience using dbt Cloud, we suggest that you turn off ad bloc
 
 ## Prerequisites
 
-- A [dbt Cloud account](https://cloud.getdbt.com/) and [Developer seat license](/docs/cloud/manage-access/seats-and-users)
+- A [dbt Cloud account](https://www.getdbt.com/signup) and [Developer seat license](/docs/cloud/manage-access/seats-and-users)
 - A git repository set up and git provider must have `write` access enabled. See [Connecting your GitHub Account](/docs/cloud/git/connect-github) or [Importing a project by git URL](/docs/cloud/git/import-a-project-by-git-url) for detailed setup instructions
 - A dbt project connected to a [data platform](/docs/cloud/connect-data-platform/about-connections)
 - A [development environment and development credentials](#get-started-with-the-cloud-ide) set up

diff --git a/website/docs/docs/deploy/deployment-tools.md b/website/docs/docs/deploy/deployment-tools.md
@@ -53,7 +53,7 @@ To use the dbt API to trigger a job in dbt Cloud through ADF:
 2. You'll want to create a pipeline in ADF to trigger a dbt Cloud job.
 3. Securely fetch the dbt Cloud service token from a key vault in ADF, using a web call as the first step in the pipeline.
 4. Set the parameters in the pipeline, including the dbt Cloud account ID and  job ID, as well as the name of the key vault and secret that contains the service token. 
-    * You can find the dbt Cloud job and account id in the URL, for example, if your URL is `https://cloud.getdbt.com/deploy/88888/projects/678910/jobs/123456`, the account ID is 88888 and the job ID is 123456
+    * You can find the dbt Cloud job and account id in the URL, for example, if your URL is `https://YOUR_ACCESS_URL/deploy/88888/projects/678910/jobs/123456`, the account ID is 88888 and the job ID is 123456
 5. Trigger the pipeline in ADF to start the dbt Cloud job and monitor the status of the dbt Cloud job in ADF.
 6. In dbt Cloud, you can check the status of the job and how it was triggered in dbt Cloud.
 

diff --git a/website/docs/faqs/API/rotate-token.md b/website/docs/faqs/API/rotate-token.md
@@ -34,23 +34,21 @@ curl --location --request POST 'https://cloud.getdbt.com/api/v3/accounts/YOUR_AC
 * Find your `YOUR_CURRENT_TOKEN` by going to **Profile Settings** -> **API Access** and copying the API key.
 * Find [`YOUR_ACCESS_URL`](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan.
 
-
-For example, if `YOUR_ACCOUNT_ID` = `000`, `YOUR_USER_ID` = `123`, `YOUR_CURRENT_PAT_TOKEN` = `abcf9g`, and your `ACCESS_URL` = `cloud.getdbt.com`, then your curl request will be:
+If `YOUR_USER_ID` = `123`, `YOUR_CURRENT_TOKEN` = `abcf9g`, then your curl request will be:
 
 ```
-curl --location --request POST 'https://cloud.getdbt.com/api/v3/accounts/000/users/123/apikey/' \
+curl --location --request POST 'https://YOUR_ACCESS_URL/api/v2/users/123/apikey/' \
+
 --header 'Authorization: Token abcf9g'
 ```
 
-
 2. Find the new key in the API response or in dbt Cloud. 
 
 3. To find the new key in dbt Cloud, go to **Profile Settings** -> **API Access**.
 
-
 ### dbt Cloud deployments
 
-If your [dbt Cloud deployment](/docs/cloud/about-cloud/access-regions-ip-addresses) uses a different access URL, replace `cloud.getdbt.com` with the URL of your instance.
+If your [dbt Cloud deployment](/docs/cloud/about-cloud/access-regions-ip-addresses) uses a different access URL, replace `YOUR_ACCESS_URL` with the URL of your instance.
 
 For example, if your deployment is Virtual Private dbt: 
 

diff --git a/website/docs/faqs/Accounts/find-user-id.md b/website/docs/faqs/Accounts/find-user-id.md
@@ -14,4 +14,4 @@ To find your user ID in dbt Cloud, read the following steps:
 3. In the address bar, the number after `/users` is your user ID. 
 4. Copy that number or save it somewhere safe. <br />
 
-For example, if the URL is `https://cloud.getdbt.com/settings/accounts/12345/users/67891` &mdash; the user ID is `67891`<br /><br />
+For example, if the URL is `https://YOUR_ACCESS_URL/settings/accounts/12345/users/67891` &mdash; the user ID is `67891`<br /><br />
diff --git a/website/docs/guides/airflow-and-dbt-cloud.md b/website/docs/guides/airflow-and-dbt-cloud.md
@@ -117,7 +117,7 @@ cd airflow-dbt-cloud
 - Once you hit `save` on the job, make sure you copy the URL and save it for referencing later. The url will look similar to this:
 
 ```html
-https://cloud.getdbt.com/#/accounts/{account_id}/projects/{project_id}/jobs/{job_id}/
+https://YOUR_ACCESS_URL/#/accounts/{account_id}/projects/{project_id}/jobs/{job_id}/
 ```
 
 <WistiaVideo id="qiife5rzlp" paddingTweak="62.25%" />
@@ -134,7 +134,7 @@ Now you have all the working pieces to get up and running with Airflow + dbt Clo
 
     ![Connection type](/img/guides/orchestration/airflow-and-dbt-cloud/connection-type.png)
 
-3. Add in your connection details and your default dbt Cloud account id. This is found in your dbt Cloud URL after the accounts route section (`/accounts/{YOUR_ACCOUNT_ID}`), for example the account with id 16173 would see this in their URL: `https://cloud.getdbt.com/#/accounts/16173/projects/36467/jobs/65767/`
+3. Add in your connection details and your default dbt Cloud account id. This is found in your dbt Cloud URL after the accounts route section (`/accounts/{YOUR_ACCOUNT_ID}`), for example the account with id 16173 would see this in their URL: `https://YOUR_ACCESS_URL/#/accounts/16173/projects/36467/jobs/65767/`
 
     ![Connection type](/img/guides/orchestration/airflow-and-dbt-cloud/connection-type-configured.png)
 
@@ -145,15 +145,15 @@ Now you have all the working pieces to get up and running with Airflow + dbt Clo
 Both IDs are included inside of the dbt Cloud job URL as shown in the following snippets:
 
 ```python
-# For the dbt Cloud Job URL https://cloud.getdbt.com/#/accounts/16173/projects/36467/jobs/65767/
+# For the dbt Cloud Job URL https://YOUR_ACCESS_URL/#/accounts/16173/projects/36467/jobs/65767/
 # The account_id is 16173
 
 # Update line 28
 default_args={"dbt_cloud_conn_id": "dbt_cloud", "account_id": 16173},
 ```
 
 ```python
-# For the dbt Cloud Job URL https://cloud.getdbt.com/#/accounts/16173/projects/36467/jobs/65767/
+# For the dbt Cloud Job URL https://YOUR_ACCESS_URL/#/accounts/16173/projects/36467/jobs/65767/
 # The job_id is 65767
 
 # Update line 39

diff --git a/website/docs/guides/bigquery-qs.md b/website/docs/guides/bigquery-qs.md
@@ -85,7 +85,7 @@ In order to let dbt connect to your warehouse, you'll need to generate a keyfile
 3. Create a service account key for your new project from the [Service accounts page](https://console.cloud.google.com/iam-admin/serviceaccounts?walkthrough_id=iam--create-service-account-keys&start_index=1#step_index=1). For more information, refer to [Create a service account key](https://cloud.google.com/iam/docs/creating-managing-service-account-keys#creating) in the Google Cloud docs. When downloading the JSON file, make sure to use a filename you can easily remember. For example, `dbt-user-creds.json`. For security reasons, dbt Labs recommends that you protect this JSON file like you would your identity credentials; for example, don't check the JSON file into your version control software.
 
 ## Connect dbt Cloud to BigQuery
-1. Create a new project in [dbt Cloud](https://cloud.getdbt.com/). From **Account settings** (using the gear menu in the top right corner), click **+ New Project**.
+1. Create a new project in [dbt Cloud](/docs/cloud/about-cloud/access-regions-ip-addresses). From **Account settings** (using the gear menu in the top right corner), click **+ New Project**.
 2. Enter a project name and click **Continue**.
 3. For the warehouse, click **BigQuery** then **Next** to set up your connection.
 4. Click **Upload a Service Account JSON File** in settings.

diff --git a/website/docs/guides/how-to-use-databricks-workflows-to-run-dbt-cloud-jobs.md b/website/docs/guides/how-to-use-databricks-workflows-to-run-dbt-cloud-jobs.md
@@ -130,7 +130,7 @@ if __name__ == '__main__':
 
 4. Replace **`<YOUR_BASE_URL>`** and **`<YOUR_ACCOUNT_ID>`** with the correct values of your environment and [Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan.
 
-    * To find these values, navigate to **dbt Cloud**, select **Deploy -> Jobs**.  Select the Job you want to run and copy the URL. For example: `https://cloud.getdbt.com/deploy/000000/projects/111111/jobs/222222`
+    * To find these values, navigate to **dbt Cloud**, select **Deploy -> Jobs**.  Select the Job you want to run and copy the URL. For example: `https://YOUR_ACCESS_URL/deploy/000000/projects/111111/jobs/222222`
     and therefore valid code would be:
 
 Your URL is structured `https://<YOUR_BASE_URL>/deploy/<YOUR_ACCOUNT_ID>/projects/<YOUR_PROJECT_ID>/jobs/<YOUR_JOB_ID>`

diff --git a/website/docs/guides/redshift-qs.md b/website/docs/guides/redshift-qs.md
@@ -166,7 +166,7 @@ Now we are going to load our sample data into the S3 bucket that our Cloudformat
     select * from stripe.payment;
     ```
 ## Connect dbt Cloud to Redshift 
-1. Create a new project in [dbt Cloud](https://cloud.getdbt.com/). From **Account settings** (using the gear menu in the top right corner), click **+ New Project**.
+1. Create a new project in [dbt Cloud](/docs/cloud/about-cloud/access-regions-ip-addresses). From **Account settings** (using the gear menu in the top right corner), click **+ New Project**.
 2. Enter a project name and click **Continue**.
 3. For the warehouse, click **Redshift** then **Next** to set up your connection.
 4. Enter your Redshift settings. Reference your credentials you saved from the CloudFormation template.

diff --git a/website/docs/guides/starburst-galaxy-qs.md b/website/docs/guides/starburst-galaxy-qs.md
@@ -202,7 +202,7 @@ To query the Jaffle Shop data with Starburst Galaxy, you need to create tables u
     If this role is not listed for you, choose the role you selected in [Connect Starburst Galaxy to the Amazon S3 bucket](#connect-to-s3-bucket) when you added location privilege for your S3 bucket.
 3. Click **Clusters** on the left sidebar.
 4. Find your cluster in the **View clusters** table and click **Connection info**. Choose **dbt** from the **Select client** dropdown. Keep the **Connection information** modal open. You will use details from that modal in dbt Cloud.
-5. In another browser tab, log in to [dbt Cloud](https://cloud.getdbt.com/).
+5. In another browser tab, log in to [dbt Cloud](/docs/cloud/about-cloud/access-regions-ip-addresses).
 6. Create a new project in dbt Cloud. From Account settings (using the gear menu in the top right corner), click **+ New Project**.
 7. Enter a project name and click **Continue**.
 8. Choose **Starburst** as your connection and click **Next**.

diff --git a/website/docs/guides/zapier-ms-teams.md b/website/docs/guides/zapier-ms-teams.md
@@ -105,7 +105,7 @@ run_id = hook_data['runId']
 account_id = full_body['accountId']
 
 # Fetch run info from the dbt Cloud Admin API
-url = f'https://cloud.getdbt.com/api/v2/accounts/{account_id}/runs/{run_id}/?include_related=["run_steps"]'
+url = f'https://YOUR_ACCESS_URL/api/v2/accounts/{account_id}/runs/{run_id}/?include_related=["run_steps"]'
 headers = {'Authorization': f'Token {api_token}'}
 run_data_response = requests.get(url, headers=headers)
 run_data_response.raise_for_status()

diff --git a/website/docs/guides/zapier-slack.md b/website/docs/guides/zapier-slack.md
@@ -100,7 +100,7 @@ run_id = hook_data['runId']
 account_id = full_body['accountId']
 
 # Fetch run info from the dbt Cloud Admin API
-url = f'https://cloud.getdbt.com/api/v2/accounts/{account_id}/runs/{run_id}/?include_related=["run_steps"]'
+url = f'https://YOUR_ACCESS_URL/api/v2/accounts/{account_id}/runs/{run_id}/?include_related=["run_steps"]'
 headers = {'Authorization': f'Token {api_token}'}
 run_data_response = requests.get(url, headers=headers)
 run_data_response.raise_for_status()
@@ -260,7 +260,7 @@ api_token = secret_store.get('DBT_CLOUD_SERVICE_TOKEN')
 commands_to_skip_logs = ['dbt source', 'dbt docs']
 run_id = input_data['run_id']
 account_id = input_data['account_id']
-url = f'https://cloud.getdbt.com/api/v2/accounts/{account_id}/runs/{run_id}/?include_related=["run_steps"]'
+url = f'https://YOUR_ACCESS_URL/api/v2/accounts/{account_id}/runs/{run_id}/?include_related=["run_steps"]'
 headers = {'Authorization': f'Token {api_token}'}
 
 response = requests.get(url, headers=headers)

diff --git a/website/docs/reference/dbt_project.yml.md b/website/docs/reference/dbt_project.yml.md
@@ -5,7 +5,8 @@ Every [dbt project](/docs/build/projects) needs a `dbt_project.yml` file — thi
 
 - By default, dbt looks for the `dbt_project.yml` in your current working directory and its parents, but you can set a different directory using the `--project-dir` flag or the `DBT_PROJECT_DIR` environment variable.
 
-- Specify your dbt Cloud project ID in the `dbt_project.yml` file using `project-id` under the `dbt-cloud` config. Find your project ID in your dbt Cloud project URL: For example, in `https://cloud.getdbt.com/11/projects/123456`, the project ID is `123456`.
+- Specify your dbt Cloud project ID in the `dbt_project.yml` file using `project-id` under the `dbt-cloud` config. Find your project ID in your dbt Cloud project URL: For example, in `https://YOUR_ACCESS_URL/11/projects/123456`, the project ID is `123456`.
+
 
 - Note, you can't set up a "property" in the `dbt_project.yml` file if it's not a config (an example is [macros](/reference/macro-properties)). This applies to all types of resources. Refer to [Configs and properties](/reference/configs-and-properties) for more detail.