-
Notifications
You must be signed in to change notification settings - Fork 969
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
Changes from all commits
bcd1b1b
30d404f
0418939
fd758a1
a4b54e9
20af173
56ac0e9
0ecb064
59db5c0
d6df6cb
a5c03a4
97e93c1
2d8ce6f
74782da
4d314af
aa2b255
84a5be0
f8772ec
82b117b
4afbda6
c408b82
3df434a
a4dda95
8e9576f
14ca454
ae647b8
04fd270
eacf21f
aacebb9
2d6d46b
dcae369
7d3fe79
3fa03f1
8bab8c5
7cb873d
497c2b0
2d0576a
6258398
7c741f1
a07a488
b903b20
f773d8d
a30f022
b97693a
baa6fd7
a7434f1
ed51386
c033191
68bd63c
601325c
1e30ee3
708783d
5f9d656
f5620b2
0571564
9beb724
0c1fc09
b97b461
93e91af
f7a56e9
efa7133
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
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 — 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 |
---|---|---|
@@ -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: | ||
<expandable alt_header="Installing dbt packages" > | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. used new MD component to help reduce the callout size There was a problem hiding this comment. Choose a reason for hiding this commentThe 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 There was a problem hiding this comment. Choose a reason for hiding this commentThe 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 |
||
|
||
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"> | ||
|
||
|
@@ -21,3 +27,5 @@ dbt Labs is committed to zero breaking changes for code in dbt projects, with on | |
``` | ||
|
||
</File> | ||
|
||
</expandable> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nice!