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.

Sign up for GitHub

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

Update Compatible release track #6666

Merged
merged 14 commits into from
Dec 13, 2024
Merged

Update Compatible release track #6666

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
f1d7402
Update Compatible release track
jtcohen6 Dec 13, 2024
1cce290
Add customDisplay for 1.9 (Compatible) in dropdown
jtcohen6 Dec 13, 2024
ccb9f8c
Merge branch 'current' into jerco/update-compatible-release-track
mirnawong1 Dec 13, 2024
37cc6e8
Update website/docs/docs/dbt-versions/cloud-release-tracks.md
mirnawong1 Dec 13, 2024
2ba6c9e
Update website/docs/docs/dbt-versions/compatible-track-changelog.md
mirnawong1 Dec 13, 2024
c52cd9e
Update website/docs/docs/dbt-versions/cloud-release-tracks.md
mirnawong1 Dec 13, 2024
97cc22f
Format table. Small tweaks
jtcohen6 Dec 13, 2024
cf1389c
More tweaks
jtcohen6 Dec 13, 2024
e5d3ed1
Merge branch 'current' into jerco/update-compatible-release-track
mirnawong1 Dec 13, 2024
764c74d
Update cloud-release-tracks.md
mirnawong1 Dec 13, 2024
903d132
Update website/docs/docs/dbt-versions/cloud-release-tracks.md
mirnawong1 Dec 13, 2024
c9559ee
Update website/docs/docs/dbt-versions/cloud-release-tracks.md
mirnawong1 Dec 13, 2024
4967e63
Update cloud-release-tracks.md
mirnawong1 Dec 13, 2024
cae91c6
Update cloud-release-tracks.md
mirnawong1 Dec 13, 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
1 change: 1 addition & 0 deletions website/dbt-versions.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ exports.versions = [
},
{
version: "1.9",
customDisplay: "1.9 (Compatible)",
EOLDate: "2025-12-08",
},
{
Expand Down
14 changes: 6 additions & 8 deletions website/docs/docs/dbt-versions/cloud-release-tracks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@
## Which release tracks are available?

- **"Latest"** (available to all plans, formerly called "Versionless"): Provides a continuous release of the latest functionality in dbt Cloud. Includes early access to new features of the dbt framework before they're available in open source releases of dbt Core.
Copy link
Contributor

Choose a reason for hiding this comment

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

might benefit having this turn into tables so it's easier to read - happy to do that for you @jtcohen6 if you have no issues with that?

Copy link
Contributor

@mirnawong1 mirnawong1 Dec 13, 2024 •
edited
Loading

Choose a reason for hiding this comment

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

so like this:

Release track Description Availability
"Latest" Formerly called "Versionless". Provides a continuous release of the latest functionality in dbt Cloud. Includes early access to new features of the dbt framework before they're available in open source releases of dbt Core. Available to all plans.
"Compatible" <Lifecycle status="preview"/> Provides a monthly release aligned with the most recent open source versions of dbt Core and adapters, plus functionality exclusively available in dbt Cloud. Available to Team + Enterprise
"Extended" <Lifecycle status="preview"/> The previous month's "Compatible" release. Available to Enterprise

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I'll take a crack at this!

Copy link
Contributor

Choose a reason for hiding this comment

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

No probs and this is the markdown to help:


| Release track | Description | Availability | 
| ------------- | ------------ | ---------- | 
| **"Latest"** |  Formerly called "Versionless". Provides a continuous release of the latest functionality in dbt Cloud. Includes early access to new features of the dbt framework before they're available in open source releases of dbt Core. | Available to all plans. |
| **"Compatible"** `<Lifecycle status="preview"/>`  | Provides a monthly release aligned with the most recent open source versions of dbt Core and adapters, plus functionality exclusively available in dbt Cloud. |  Available to Team + Enterprise |
| **"Extended"** `<Lifecycle status="preview"/>` | The previous month's "Compatible" release. | Available to Enterprise |

Copy link
Contributor

Choose a reason for hiding this comment

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

No probs and this is the markdown to help:


| Release track | Description | Availability | 
| ------------- | ------------ | ---------- | 
| **"Latest"** |  Formerly called "Versionless". Provides a continuous release of the latest functionality in dbt Cloud. Includes early access to new features of the dbt framework before they're available in open source releases of dbt Core. | Available to all plans. |
| **"Compatible"** `<Lifecycle status="preview"/>`  | Provides a monthly release aligned with the most recent open source versions of dbt Core and adapters, plus functionality exclusively available in dbt Cloud. |  Available to Team + Enterprise |
| **"Extended"** `<Lifecycle status="preview"/>` | The previous month's "Compatible" release. | Available to Enterprise |

- <Lifecycle status="coming soon"/> **"Compatible"** (available to Team + Enterprise): Provides a monthly release aligned with the most recent open source versions of dbt Core and adapters, plus functionality exclusively available in dbt Cloud.
- <Lifecycle status="coming soon"/> **"Extended"** (available to Enterprise): Provides a delayed release of the previous month's "Compatible" release.
- <Lifecycle status="preview"/> **"Compatible"** (available to Team + Enterprise): Provides a monthly release aligned with the most recent open source versions of dbt Core and adapters, plus functionality exclusively available in dbt Cloud.
- <Lifecycle status="preview"/> **"Extended"** (available to Enterprise): The previous month's "Compatible" release.

The first "Compatible" release will be in December 2024, after the final release of dbt Core v1.9.0. For December 2024 only, the "Extended" release is the same as "Compatible." Starting in January 2025, "Extended" will be one month behind "Compatible."
The first "Compatible" release was on December 12, 2024, after the final release of dbt Core v1.9.0. For December 2024 only, the "Extended" release is the same as "Compatible." Starting in January 2025, "Extended" will be one month behind "Compatible."

Check warning on line 21 in website/docs/docs/dbt-versions/cloud-release-tracks.md

View workflow job for this annotation

GitHub Actions / vale

[vale] website/docs/docs/dbt-versions/cloud-release-tracks.md#L21 

[custom.Typos] Oops there's a typo -- did you really mean 'v1.9.0'?
Raw output 
{"message": "[custom.Typos] Oops there's a typo -- did you really mean 'v1.9.0'? ", "location": {"path": "website/docs/docs/dbt-versions/cloud-release-tracks.md", "range": {"start": {"line": 21, "column": 94}}}, "severity": "WARNING"}

To configure an environment in the [dbt Cloud Admin API](/docs/dbt-cloud-apis/admin-cloud-api) or [Terraform](https://registry.terraform.io/providers/dbt-labs/dbtcloud/latest) to use a release track, set `dbt_version` to the release track name:
- `latest` (formerly called `versionless`; the old name is still supported)
Expand Down Expand Up @@ -69,17 +69,15 @@

If you're running dbt version 1.6 or older, please know that your version of dbt Core has reached [end-of-life (EOL)](/docs/dbt-versions/core#eol-version-support) and is no longer supported. We strongly recommend that you update to a newer version as soon as reasonably possible.

dbt Labs has extended the critical support period of dbt Core v1.7 for dbt Cloud Enterprise customers to January 31, 2024. At that point, we will be asking all customers to select a Release Track for receiving ongoing updates to dbt in dbt Cloud.
dbt Labs has extended the critical support period of dbt Core v1.7 for dbt Cloud Enterprise customers to March 2025. At that point, we will be encouraging all customers to select a Release Track for ongoing updates in dbt Cloud.

Check warning on line 72 in website/docs/docs/dbt-versions/cloud-release-tracks.md

View workflow job for this annotation

GitHub Actions / vale

[vale] website/docs/docs/dbt-versions/cloud-release-tracks.md#L72 

[custom.Typos] Oops there's a typo -- did you really mean 'v1.7'?
Raw output 
{"message": "[custom.Typos] Oops there's a typo -- did you really mean 'v1.7'? ", "location": {"path": "website/docs/docs/dbt-versions/cloud-release-tracks.md", "range": {"start": {"line": 72, "column": 63}}}, "severity": "WARNING"}

<Expandable alt_header="I'm using an older version of dbt in dbt Cloud. What should I do? What happens if I do nothing?" >

If you're running dbt version v1.6 or older, please know that your version of dbt Core has reached [end-of-life (EOL)](/docs/dbt-versions/core#eol-version-support) and is no longer supported. We strongly recommend that you update to a newer version as soon as reasonably possible.

dbt Labs has extended the "Critical Support" period of dbt Core v1.7 for dbt Cloud Enterprise customers while we work through the migration with those customers to Release Tracks. In the meantime, this means that v1.7 will continue to be accessible in dbt Cloud for Enteprise customers, jobs and environments on v1.7 for those customers will not be automatically migrated to "Latest," and dbt Labs will continue to fix critical bugs and security issues.

dbt Cloud accounts on the Developer and Team plans will be migrated to the "Latest" release track after November 1, 2024. If you know that your project will not be compatible with the upgrade, for one of the reasons described here, or a different reason in your own testing, you should [contact dbt Cloud support](https://docs.getdbt.com/docs/dbt-support#dbt-cloud-support) to request an extension.

If your account has been migrated to the "Latest" release track, and you are seeing net-new failures in your scheduled dbt jobs, you should also [contact dbt Cloud support](https://docs.getdbt.com/docs/dbt-support#dbt-cloud-support) to request an extension.
Starting in October 2024, dbt Cloud accounts on the Developer and Team plans have been migrated off very old dbt Core versions and onto release tracks. If your account has been migrated to the "Latest" release track, and you are seeing net-new failures in your scheduled dbt jobs, please [contact dbt Cloud support](https://docs.getdbt.com/docs/dbt-support#dbt-cloud-support) to report the problem or request an extension.
mirnawong1 marked this conversation as resolved.
Show resolved Hide resolved

</Expandable>

Expand Down Expand Up @@ -134,7 +132,7 @@

Opting into a release cadence with automated upgrades is required for accessing any new functionality that we've released in 2024, and going forward.

We continue to release new minor versions of dbt Core (OSS), including v1.9 which will be available later this year. When we do, it will be a subset of the functionality that's already available to dbt Cloud customers, and always after the functionality has been available in dbt Cloud.
We continue to release new minor versions of dbt Core (OSS). We most recently released dbt Core v1.9 on December 9, 2024. These releases always include a subset of the functionality that's already available to dbt Cloud customers, and always after the functionality has been available in dbt Cloud.

Check warning on line 135 in website/docs/docs/dbt-versions/cloud-release-tracks.md

View workflow job for this annotation

GitHub Actions / vale

[vale] website/docs/docs/dbt-versions/cloud-release-tracks.md#L135 

[custom.Typos] Oops there's a typo -- did you really mean 'v1.9'?
Raw output 
{"message": "[custom.Typos] Oops there's a typo -- did you really mean 'v1.9'? ", "location": {"path": "website/docs/docs/dbt-versions/cloud-release-tracks.md", "range": {"start": {"line": 135, "column": 97}}}, "severity": "WARNING"}

</Expandable>

Expand Down
48 changes: 41 additions & 7 deletions website/docs/docs/dbt-versions/compatible-track-changelog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ sidebar_label: "Compatible Track Changelog"
description: "The Compatible release track updates once per month, and it includes up-to-date open source versions as of the monthly release."
---

:::info Coming soon
:::info Preview

The "Compatible" and "Extended" release tracks will be available in Preview to eligible dbt Cloud accounts in December 2024.
The "Compatible" and "Extended" release tracks are available in Preview. Access will be rolling out to eligible dbt Cloud accounts during the week of December 16-20, 2024.
mirnawong1 marked this conversation as resolved.
Show resolved Hide resolved

:::

Expand All @@ -20,8 +20,42 @@ For more information, see [release tracks](/docs/dbt-versions/cloud-release-trac

## December 2024

Planned release: December 11-13

This release will include functionality from `dbt-core==1.9.0` and the most recent versions of all adapters supported in dbt Cloud. After the Compatible release is cut, we will update with:
- exact versions of open source dbt packages
- changelog notes concerning functionality specific to dbt Cloud
Release date: December 12, 2024

This release includes functionality from the following versions of dbt Core OSS:
```
dbt-core==1.9.0

# shared interfaces
dbt-adapters==1.10.4
dbt-common==1.14.0
dbt-semantic-interfaces==0.7.4

# adapters
dbt-athena==1.9.0
dbt-bigquery==1.9.0
dbt-databricks==1.9.0
dbt-fabric==1.8.8
dbt-postgres==1.9.0
dbt-redshift==1.9.0
dbt-snowflake==1.9.0
dbt-spark==1.9.0
dbt-synapse==1.8.2
dbt-teradata==1.8.2
dbt-trino==1.8.5
```

Changelogs:
- [dbt-core 1.9.0](https://github.com/dbt-labs/dbt-core/blob/1.9.latest/CHANGELOG.md#dbt-core-190---december-09-2024)
- [dbt-adapters 1.10.4](https://github.com/dbt-labs/dbt-adapters/blob/main/CHANGELOG.md#dbt-adapters-1104---november-11-2024)
- [dbt-common 1.14.0](https://github.com/dbt-labs/dbt-common/blob/main/CHANGELOG.md)
- [dbt-bigquery 1.9.0](https://github.com/dbt-labs/dbt-bigquery/blob/1.9.latest/CHANGELOG.md#dbt-bigquery-190---december-09-2024)
- [dbt-databricks 1.9.0](https://github.com/databricks/dbt-databricks/blob/main/CHANGELOG.md#dbt-databricks-190-december-9-2024)
- [dbt-fabric 1.8.8](https://github.com/microsoft/dbt-fabric/blob/v1.8.latest/CHANGELOG.md)
- [dbt-postgres 1.9.0](https://github.com/dbt-labs/dbt-postgres/blob/main/CHANGELOG.md#dbt-postgres-190---december-09-2024)
- [dbt-redshift 1.9.0](https://github.com/dbt-labs/dbt-redshift/blob/1.9.latest/CHANGELOG.md#dbt-redshift-190---december-09-2024)
- [dbt-snowflake 1.9.0](https://github.com/dbt-labs/dbt-snowflake/blob/1.9.latest/CHANGELOG.md#dbt-snowflake-190---december-09-2024)
- [dbt-spark 1.9.0](https://github.com/dbt-labs/dbt-spark/blob/1.9.latest/CHANGELOG.md#dbt-spark-190---december-10-2024)
- [dbt-synapse 1.8.2](https://github.com/microsoft/dbt-synapse/blob/v1.8.latest/CHANGELOG.md)
- [dbt-teradata 1.8.2](https://github.com/Teradata/dbt-teradata/releases/tag/v1.8.2)
- [dbt-trino 1.8.5](https://github.com/starburstdata/dbt-trino/blob/master/CHANGELOG.md#dbt-trino-185---december-11-2024)
Loading