From bcd1b1b467164dc860e9e13105afaf11a9bba306 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Tue, 2 Apr 2024 14:56:39 -0700 Subject: [PATCH 1/7] GA of Keep on latest version --- .../core-upgrade/01-upgrading-to-v1.8.md | 2 +- .../70-Apr-2024/keep-on-latest-version.md | 18 ++++++++++++++++++ .../upgrade-dbt-version-in-cloud.md | 2 +- website/docs/guides/core-to-cloud-1.md | 4 ++-- .../global-configs/version-compatibility.md | 2 +- .../project-configs/require-dbt-version.md | 2 +- website/snippets/_config-dbt-version-check.md | 14 +++++++++++--- 7 files changed, 35 insertions(+), 9 deletions(-) create mode 100644 website/docs/docs/dbt-versions/release-notes/70-Apr-2024/keep-on-latest-version.md diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md index e7004e893a0..7472c7543cc 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md @@ -17,7 +17,7 @@ dbt Labs is committed to providing backward compatibility for all versions 1.x, dbt Labs plans to release dbt Core v1.8.0-b1 and dbt Labs-maintained adapters on February 28th, 2024. -## Keep on latest version +## Keep on latest version With dbt Cloud, you can get early access to many new features and functionality before they're in the Generally Available (GA) release of dbt Core v1.8 without the need to manage version upgrades. Refer to the [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud) setting for more details. diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/keep-on-latest-version.md b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/keep-on-latest-version.md new file mode 100644 index 00000000000..4a79d436162 --- /dev/null +++ b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/keep-on-latest-version.md @@ -0,0 +1,18 @@ +--- +title: "Update: GA release of Keep on latest version" +description: "April 2024: The new Keep on latest version setting is now GA, no longer in Public Preview. It allows dbt Labs to handle version upgrades for you." +sidebar_label: "Update: Keep on latest version" +sidebar_position: 10 +tags: [Apr-2024] +date: 2024-04-03 +--- + + +_Now available in the dbt version dropdown in dbt Cloud — starting with select customers, rolling out to wider availability through February and March._ + +When the new **Keep on latest version** setting is enabled, you always get the latest fixes and early access to new functionality for your dbt project. dbt Labs will handle upgrades behind-the-scenes, as part of testing and redeploying the dbt Cloud application — just like other dbt Cloud capabilities and other SaaS tools that you're using. No more manual upgrades and no more need for _a second sandbox project_ just to try out new features in development. + +To learn more about the new setting, refer to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) for details. + + + diff --git a/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md b/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md index ecfd3338ab3..fd4acace039 100644 --- a/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md +++ b/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md @@ -11,7 +11,7 @@ Navigate to the settings page of an environment, then click **Edit**. Click the -### Keep on latest version +### Keep on latest version By choosing to **Keep on latest version**, you always get the latest fixes and early access to new functionality for your dbt project. dbt Labs will handle upgrades for you, as part of testing and redeploying the dbt Cloud SaaS application. diff --git a/website/docs/guides/core-to-cloud-1.md b/website/docs/guides/core-to-cloud-1.md index f2ee7b016e2..beb2f550e5d 100644 --- a/website/docs/guides/core-to-cloud-1.md +++ b/website/docs/guides/core-to-cloud-1.md @@ -129,7 +129,7 @@ This difference streamlines the process of switching between development, stagin 1. **Set up development environment** — Set up your [development](/docs/dbt-cloud-environments#create-a-development-environment) environment and [development credentials](/docs/cloud/dbt-cloud-ide/develop-in-the-cloud#access-the-cloud-ide). You’ll need this to access your dbt project and start developing. 2. **dbt Core version** — In your dbt Cloud environment and credentials, use the same dbt Core version you use locally. You can run `dbt --version` in the command line to find out which version of dbt Core you’re using. - - Once your full migration is complete, consider upgrading your environments to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version-) to always get the latest features and more. + - Once your full migration is complete, consider upgrading your environments to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) to always get the latest features and more. 3. **Connect to your data platform** — When using dbt Cloud, you can [connect to your data platform](/docs/cloud/connect-data-platform/about-connections) directly in the UI. - Each environment is roughly equivalent to an entry in your `profiles.yml` file. This means you don't need a `profiles.yml` file in your project. @@ -187,7 +187,7 @@ To use the [dbt Cloud's job scheduler](/docs/deploy/job-scheduler), set up one e ### Initial setup steps 1. **dbt Core version** — In your environment settings, configure dbt Cloud with the same dbt Core version. - - Once your full migration is complete, we recommend upgrading your environments to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version-) to always get the latest features and more. You only need to do this once. + - Once your full migration is complete, we recommend upgrading your environments to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) to always get the latest features and more. You only need to do this once. 2. **Configure your jobs** — [Create jobs](/docs/deploy/deploy-jobs#create-and-schedule-jobs) for automated or event-driven dbt jobs. You can use cron execution, manual, pull requests, or API triggers. - Note that alongside [jobs in dbt Cloud](/docs/deploy/jobs), discover other ways to schedule and run your dbt jobs with the help of other tools. Refer to [Integrate with other tools](/docs/deploy/deployment-tools) for more information. diff --git a/website/docs/reference/global-configs/version-compatibility.md b/website/docs/reference/global-configs/version-compatibility.md index 71bc70b3912..756147745a1 100644 --- a/website/docs/reference/global-configs/version-compatibility.md +++ b/website/docs/reference/global-configs/version-compatibility.md @@ -14,7 +14,7 @@ Running with dbt=1.0.0 Found 13 models, 2 tests, 1 archives, 0 analyses, 204 macros, 2 operations.... ``` -:::info Keep on latest version +:::info Keep on latest version ::: diff --git a/website/docs/reference/project-configs/require-dbt-version.md b/website/docs/reference/project-configs/require-dbt-version.md index 1de850efe94..5fb08927f0f 100644 --- a/website/docs/reference/project-configs/require-dbt-version.md +++ b/website/docs/reference/project-configs/require-dbt-version.md @@ -22,7 +22,7 @@ When you set this configuration, dbt sends a helpful error message for any user If this configuration is not specified, no version check will occur. -:::info Keep on latest version +:::info Keep on latest version diff --git a/website/snippets/_config-dbt-version-check.md b/website/snippets/_config-dbt-version-check.md index 231143407ce..01ad895f6e2 100644 --- a/website/snippets/_config-dbt-version-check.md +++ b/website/snippets/_config-dbt-version-check.md @@ -1,10 +1,16 @@ -Starting in 2024, when you select **Keep on latest version** in dbt Cloud, dbt will ignore the `require-dbt-version` config. Refer to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) (available in beta) for more details. +Starting in 2024, when you select **Keep on latest version** in dbt Cloud, dbt will ignore the `require-dbt-version` config. Refer to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) for more details. dbt Labs is committed to zero breaking changes for code in dbt projects, with ongoing releases to dbt Cloud and new versions of dbt Core. We also recommend these best practices: -- **If you install dbt packages** — for use in your project, whether the package is maintained by your colleagues or a member of the open source dbt community, we recommend pinning the package to a specific revision or `version` boundary. Since v1.7, dbt manages this out-of-the-box by _locking_ the version/revision of packages in development in order to guarantee predictable builds in production. To learn more, refer to [Predictable package installs](/reference/commands/deps#predictable-package-installs). -- **If you maintain dbt packages** — whether on behalf of your colleagues or members of the open source community, we recommend writing defensive code that checks to verify that other required packages and global macros are available. For example, if your package depends on the availability of a `date_spine` macro in the global `dbt` namespace, you can write: + + +If you install dbt packages for use in your project, whether the package is maintained by your colleagues or a member of the open source dbt community, we recommend pinning the package to a specific revision or `version` boundary. Since v1.7, dbt manages this out-of-the-box by _locking_ the version/revision of packages in development in order to guarantee predictable builds in production. To learn more, refer to [Predictable package installs](/reference/commands/deps#predictable-package-installs). + + + + +If you maintain dbt packages, whether on behalf of your colleagues or members of the open source community, we recommend writing defensive code that checks to verify that other required packages and global macros are available. For example, if your package depends on the availability of a `date_spine` macro in the global `dbt` namespace, you can write: @@ -21,3 +27,5 @@ dbt Labs is committed to zero breaking changes for code in dbt projects, with on ``` + + \ No newline at end of file From fd758a15081e44916552311e870f45d9f8b8adba Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 3 Apr 2024 10:27:31 -0700 Subject: [PATCH 2/7] Feedback -- remove callout --- .../docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md index 7472c7543cc..d619eb874f2 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md @@ -21,10 +21,6 @@ dbt Labs plans to release dbt Core v1.8.0-b1 and dbt Labs-maintained adapters on With dbt Cloud, you can get early access to many new features and functionality before they're in the Generally Available (GA) release of dbt Core v1.8 without the need to manage version upgrades. Refer to the [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud) setting for more details. -:::note Availability -[Microsoft Fabric support](/docs/cloud/connect-data-platform/connect-microsoft-fabric) will be coming in late March. All other connections are supported. -::: - ## New and changed features and functionality Features and functionality new in dbt v1.8. From 708783d2cfe7d624d730473500575cc22b8ee651 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Thu, 2 May 2024 08:58:52 -0700 Subject: [PATCH 3/7] Use new rn format and arch --- website/docs/docs/dbt-versions/2024-release-notes.md | 12 ++++++++++++ .../keep-on-latest-version.md | 9 +++------ 2 files changed, 15 insertions(+), 6 deletions(-) rename website/docs/docs/dbt-versions/release-notes/{70-Apr-2024 => 69-May-2024}/keep-on-latest-version.md (72%) diff --git a/website/docs/docs/dbt-versions/2024-release-notes.md b/website/docs/docs/dbt-versions/2024-release-notes.md index 31130cee886..3299baffb06 100644 --- a/website/docs/docs/dbt-versions/2024-release-notes.md +++ b/website/docs/docs/dbt-versions/2024-release-notes.md @@ -11,6 +11,18 @@ dbt Cloud release notes for 2024. ## May 2024 +- + + The new **Keep on latest version** setting is now GA, no longer in Public Preview. It allows dbt Labs to handle version upgrades for you. + + When the new **Keep on latest version** setting is enabled, you always get the latest fixes and early access to new functionality for your dbt project. dbt Labs will handle upgrades behind-the-scenes, as part of testing and redeploying the dbt Cloud application — just like other dbt Cloud capabilities and other SaaS tools that you're using. No more manual upgrades and no more need for _a second sandbox project_ just to try out new features in development. + + To learn more about the new setting, refer to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) for details. + + + + + - **Behavior change:** Introduced the `require_resource_names_without_spaces` flag, opt-in and disabled by default. If set to `True`, dbt will raise an exception if it finds a resource name containing a space in your project or an installed package. This will become the default in a future version of dbt. Read [No spaces in resource names](/reference/global-configs/legacy-behaviors#no-spaces-in-resource-names) for more information. ## April 2024 diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/keep-on-latest-version.md b/website/docs/docs/dbt-versions/release-notes/69-May-2024/keep-on-latest-version.md similarity index 72% rename from website/docs/docs/dbt-versions/release-notes/70-Apr-2024/keep-on-latest-version.md rename to website/docs/docs/dbt-versions/release-notes/69-May-2024/keep-on-latest-version.md index 4a79d436162..4886b2f0961 100644 --- a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/keep-on-latest-version.md +++ b/website/docs/docs/dbt-versions/release-notes/69-May-2024/keep-on-latest-version.md @@ -1,15 +1,12 @@ --- title: "Update: GA release of Keep on latest version" -description: "April 2024: The new Keep on latest version setting is now GA, no longer in Public Preview. It allows dbt Labs to handle version upgrades for you." +description: "May 2024: The new Keep on latest version setting is now GA, no longer in Public Preview. It allows dbt Labs to handle version upgrades for you." sidebar_label: "Update: Keep on latest version" sidebar_position: 10 -tags: [Apr-2024] -date: 2024-04-03 +tags: [May-2024] +date: 2024-05-02 --- - -_Now available in the dbt version dropdown in dbt Cloud — starting with select customers, rolling out to wider availability through February and March._ - When the new **Keep on latest version** setting is enabled, you always get the latest fixes and early access to new functionality for your dbt project. dbt Labs will handle upgrades behind-the-scenes, as part of testing and redeploying the dbt Cloud application — just like other dbt Cloud capabilities and other SaaS tools that you're using. No more manual upgrades and no more need for _a second sandbox project_ just to try out new features in development. To learn more about the new setting, refer to [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) for details. From 0571564e193f5565fab7baff7a9f4182258667cd Mon Sep 17 00:00:00 2001 From: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> Date: Thu, 2 May 2024 12:00:57 -0700 Subject: [PATCH 4/7] Update website/docs/docs/dbt-versions/2024-release-notes.md Co-authored-by: Jeremy Cohen --- website/docs/docs/dbt-versions/2024-release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/2024-release-notes.md b/website/docs/docs/dbt-versions/2024-release-notes.md index 3299baffb06..036762ba258 100644 --- a/website/docs/docs/dbt-versions/2024-release-notes.md +++ b/website/docs/docs/dbt-versions/2024-release-notes.md @@ -13,7 +13,7 @@ dbt Cloud release notes for 2024. - - The new **Keep on latest version** setting is now GA, no longer in Public Preview. It allows dbt Labs to handle version upgrades for you. +The **Keep on latest version** setting is now Generally Available (previously Public Preview). When the new **Keep on latest version** setting is enabled, you always get the latest fixes and early access to new functionality for your dbt project. dbt Labs will handle upgrades behind-the-scenes, as part of testing and redeploying the dbt Cloud application — just like other dbt Cloud capabilities and other SaaS tools that you're using. No more manual upgrades and no more need for _a second sandbox project_ just to try out new features in development. From 9beb724d142d0fe20c6ca1e39c70e49235ad2b9b Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Thu, 2 May 2024 12:07:12 -0700 Subject: [PATCH 5/7] Fix build error --- website/docs/docs/dbt-versions/2024-release-notes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/docs/docs/dbt-versions/2024-release-notes.md b/website/docs/docs/dbt-versions/2024-release-notes.md index 036762ba258..038798a6205 100644 --- a/website/docs/docs/dbt-versions/2024-release-notes.md +++ b/website/docs/docs/dbt-versions/2024-release-notes.md @@ -13,7 +13,7 @@ dbt Cloud release notes for 2024. - -The **Keep on latest version** setting is now Generally Available (previously Public Preview). + The **Keep on latest version** setting is now Generally Available (previously Public Preview). When the new **Keep on latest version** setting is enabled, you always get the latest fixes and early access to new functionality for your dbt project. dbt Labs will handle upgrades behind-the-scenes, as part of testing and redeploying the dbt Cloud application — just like other dbt Cloud capabilities and other SaaS tools that you're using. No more manual upgrades and no more need for _a second sandbox project_ just to try out new features in development. @@ -22,7 +22,7 @@ The **Keep on latest version** setting is now Generally Available (previously Pu - + - **Behavior change:** Introduced the `require_resource_names_without_spaces` flag, opt-in and disabled by default. If set to `True`, dbt will raise an exception if it finds a resource name containing a space in your project or an installed package. This will become the default in a future version of dbt. Read [No spaces in resource names](/reference/global-configs/legacy-behaviors#no-spaces-in-resource-names) for more information. ## April 2024 From b97b4616f89a32de796ee12f422e51d29a11042a Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Thu, 2 May 2024 14:10:23 -0700 Subject: [PATCH 6/7] Remove straggling callout --- .../docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md b/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md index fd4acace039..c8ef0845eaa 100644 --- a/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md +++ b/website/docs/docs/dbt-versions/upgrade-dbt-version-in-cloud.md @@ -17,12 +17,6 @@ By choosing to **Keep on latest version**, you always get the latest fixes and e You can upgrade to **Keep on latest version** no matter which version of dbt you currently have selected. As a best practice, dbt Labs recommends that you test the upgrade in development first; use the [Override dbt version](#override-dbt-version) setting to test _your_ project on the latest dbt version before upgrading your deployment environments and the default development environment for all your colleagues. -:::note Availability - -[Microsoft Fabric support](/docs/cloud/connect-data-platform/connect-microsoft-fabric) will be coming in late March. All other connections are supported. - -::: - ### Override dbt version Configure your project to use a different dbt Core version than what's configured in your [development environment](/docs/dbt-cloud-environments#types-of-environments). This _override_ only affects your user account, no one else's. Use this to safely test new dbt features before upgrading the dbt version for your projects. From f7a56e94ca6df0e16d7043be8400df93a3ba5e5d Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Thu, 2 May 2024 14:23:02 -0700 Subject: [PATCH 7/7] Fix link --- .../docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md index e7a2e0e6b50..330de6648e0 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md @@ -19,7 +19,7 @@ dbt Labs plans to release dbt Core v1.8.0-b1 and dbt Labs-maintained adapters on ## Keep on latest version -With dbt Cloud, you can get early access to many new features and functionality before they're in the Generally Available (GA) release of dbt Core v1.8 without the need to manage version upgrades. Refer to the [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud) setting for more details. +With dbt Cloud, you can get early access to many new features and functionality before they're in the Generally Available (GA) release of dbt Core v1.8 without the need to manage version upgrades. Refer to the [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) setting for more details. ## New and changed features and functionality