Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

GA of Keep on latest version #5214

Merged
merged 61 commits into from
May 2, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
61 commits
Select commit Hold shift + click to select a range
bcd1b1b
GA of Keep on latest version
nghi-ly Apr 2, 2024
30d404f
Merge branch 'current' into ly-docs-keep-latest-ga
nghi-ly Apr 3, 2024
0418939
This branch was auto-updated!
github-actions[bot] Apr 3, 2024
fd758a1
Feedback -- remove callout
nghi-ly Apr 3, 2024
a4b54e9
This branch was auto-updated!
github-actions[bot] Apr 3, 2024
20af173
This branch was auto-updated!
github-actions[bot] Apr 3, 2024
56ac0e9
This branch was auto-updated!
github-actions[bot] Apr 3, 2024
0ecb064
This branch was auto-updated!
github-actions[bot] Apr 4, 2024
59db5c0
This branch was auto-updated!
github-actions[bot] Apr 4, 2024
d6df6cb
This branch was auto-updated!
github-actions[bot] Apr 4, 2024
a5c03a4
This branch was auto-updated!
github-actions[bot] Apr 4, 2024
97e93c1
This branch was auto-updated!
github-actions[bot] Apr 4, 2024
2d8ce6f
This branch was auto-updated!
github-actions[bot] Apr 5, 2024
74782da
This branch was auto-updated!
github-actions[bot] Apr 5, 2024
4d314af
This branch was auto-updated!
github-actions[bot] Apr 5, 2024
aa2b255
This branch was auto-updated!
github-actions[bot] Apr 5, 2024
84a5be0
This branch was auto-updated!
github-actions[bot] Apr 8, 2024
f8772ec
This branch was auto-updated!
github-actions[bot] Apr 8, 2024
82b117b
This branch was auto-updated!
github-actions[bot] Apr 8, 2024
4afbda6
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
c408b82
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
3df434a
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
a4dda95
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
8e9576f
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
14ca454
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
ae647b8
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
04fd270
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
eacf21f
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
aacebb9
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
2d6d46b
This branch was auto-updated!
github-actions[bot] Apr 9, 2024
dcae369
This branch was auto-updated!
github-actions[bot] Apr 10, 2024
7d3fe79
This branch was auto-updated!
github-actions[bot] Apr 10, 2024
3fa03f1
This branch was auto-updated!
github-actions[bot] Apr 10, 2024
8bab8c5
This branch was auto-updated!
github-actions[bot] Apr 11, 2024
7cb873d
This branch was auto-updated!
github-actions[bot] Apr 11, 2024
497c2b0
This branch was auto-updated!
github-actions[bot] Apr 11, 2024
2d0576a
This branch was auto-updated!
github-actions[bot] Apr 11, 2024
6258398
This branch was auto-updated!
github-actions[bot] Apr 11, 2024
7c741f1
This branch was auto-updated!
github-actions[bot] Apr 12, 2024
a07a488
This branch was auto-updated!
github-actions[bot] Apr 12, 2024
b903b20
This branch was auto-updated!
github-actions[bot] Apr 12, 2024
f773d8d
This branch was auto-updated!
github-actions[bot] Apr 12, 2024
a30f022
This branch was auto-updated!
github-actions[bot] Apr 15, 2024
b97693a
This branch was auto-updated!
github-actions[bot] Apr 15, 2024
baa6fd7
This branch was auto-updated!
github-actions[bot] Apr 16, 2024
a7434f1
This branch was auto-updated!
github-actions[bot] Apr 16, 2024
ed51386
This branch was auto-updated!
github-actions[bot] Apr 16, 2024
c033191
This branch was auto-updated!
github-actions[bot] Apr 16, 2024
68bd63c
This branch was auto-updated!
github-actions[bot] Apr 16, 2024
601325c
Fix merge conflict
nghi-ly May 1, 2024
1e30ee3
Merge branch 'current' into ly-docs-keep-latest-ga
nghi-ly May 2, 2024
708783d
Use new rn format and arch
nghi-ly May 2, 2024
5f9d656
Merge branch 'current' into ly-docs-keep-latest-ga
mirnawong1 May 2, 2024
f5620b2
This branch was auto-updated!
github-actions[bot] May 2, 2024
0571564
Update website/docs/docs/dbt-versions/2024-release-notes.md
nghi-ly May 2, 2024
9beb724
Fix build error
nghi-ly May 2, 2024
0c1fc09
Merge branch 'current' into ly-docs-keep-latest-ga
nghi-ly May 2, 2024
b97b461
Remove straggling callout
nghi-ly May 2, 2024
93e91af
Merge branch 'ly-docs-keep-latest-ga' of github.com:dbt-labs/docs.get…
nghi-ly May 2, 2024
f7a56e9
Fix link
nghi-ly May 2, 2024
efa7133
Merge branch 'current' into ly-docs-keep-latest-ga
nghi-ly May 2, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions website/docs/docs/dbt-versions/2024-release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,18 @@ dbt Cloud release notes for 2024.

## May 2024

- <expandable alt_header="Update: Keep on latest version" >

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 &mdash; 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.

<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/choosing-dbt-version/example-environment-settings.png" width="90%" title="Example of the Keep on latest version setting"/>

</expandable>

- **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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,13 +17,9 @@ 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 <Lifecycle status='public preview' />
## 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.

:::note Availability
[Microsoft Fabric support](/docs/cloud/connect-data-platform/connect-microsoft-fabric) will be coming in late March. All other connections are supported.
:::
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

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: "Update: GA release of Keep on latest version"
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: [May-2024]
date: 2024-05-02
---

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 &mdash; 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.

<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/choosing-dbt-version/example-environment-settings.png" width="90%" title="Example of the Keep on latest version setting"/>

Original file line number Diff line number Diff line change
Expand Up @@ -11,18 +11,12 @@ Navigate to the settings page of an environment, then click **Edit**. Click the

<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/choosing-dbt-version/example-environment-settings.png" width="90%" title="Example environment settings in dbt Cloud"/>

### Keep on latest version <Lifecycle status='public preview' />
### 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.

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.
Expand Down
4 changes: 2 additions & 2 deletions website/docs/guides/core-to-cloud-1.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ The most common data environments are production, staging, and development. The
1. **Set up development environment** &mdash; 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** &mdash; 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.
- When using dbt Core, you need to think about which version you’re using and manage your own upgrades. When using dbt Cloud, leverage [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version-) so you don’t have to.
- When using dbt Core, you need to think about which version you’re using and manage your own upgrades. When using dbt Cloud, leverage [Keep on latest version](/docs/dbt-versions/upgrade-dbt-version-in-cloud#keep-on-latest-version) so you don’t have to.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice!


3. **Connect to your data platform** &mdash; 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.
Expand Down Expand Up @@ -206,7 +206,7 @@ To use the [dbt Cloud's job scheduler](/docs/deploy/job-scheduler), set up one e

### Initial setup steps
1. **dbt Core version** &mdash; 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** &mdash; [Create jobs](/docs/deploy/deploy-jobs#create-and-schedule-jobs) for scheduled or event-driven dbt jobs. You can use cron execution, manual, pull requests, or trigger on the completion of another job.
- 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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 <Lifecycle status='public preview' />
:::info Keep on latest version
<Snippet path="_config-dbt-version-check" />

:::
Original file line number Diff line number Diff line change
Expand Up @@ -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 <Lifecycle status='public preview' />
:::info Keep on latest version

<Snippet path="_config-dbt-version-check" />

Expand Down
14 changes: 11 additions & 3 deletions website/snippets/_config-dbt-version-check.md
Original file line number Diff line number Diff line change
@@ -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** &mdash; 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** &mdash; 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:
<expandable alt_header="Installing dbt packages" >
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

used new MD component to help reduce the callout size

Copy link
Contributor

@mirnawong1 mirnawong1 May 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fyi @nghi-ly i think the expandable isn't liking the callout. its hard to read in dark mode (maybe detailsToggle might work?):

Screenshot 2024-05-02 at 17 29 46

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah, great catch!

per our chat, i'll go ahead and leave this as is since it sounds like the expandable update will get merged tomorrow.


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

</expandable>
<expandable alt_header="Maintaining dbt packages" >

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:

<File name="models/some_days.sql">

Expand All @@ -21,3 +27,5 @@ dbt Labs is committed to zero breaking changes for code in dbt projects, with on
```

</File>

</expandable>
Loading