diff --git a/data/deprecations/17-9-psql-16-min.yml b/data/deprecations/17-9-psql-16-min.yml new file mode 100644 index 0000000000000000000000000000000000000000..cfac5eb09b349d12d7e58e2610c1879379352d08 --- /dev/null +++ b/data/deprecations/17-9-psql-16-min.yml @@ -0,0 +1,22 @@ +- title: "PostgreSQL 14 and 15 no longer supported" + removal_milestone: "18.0" + announcement_milestone: "17.9" + breaking_change: true + reporter: clemensbeck + impact: medium + scope: instance + resolution_role: Admin + manual_task: true + stage: systems + issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/521663 + body: | + GitLab follows an [annual upgrade cadence for PostgreSQL](https://handbook.gitlab.com/handbook/engineering/infrastructure-platforms/data-access/database-framework/postgresql-upgrade-cadence/). + + Support for PostgreSQL 14 and 15 is scheduled for removal in GitLab 18.0. + In GitLab 18.0, PostgreSQL 16 becomes the minimum required PostgreSQL version. + + PostgreSQL 14 and 15 will be supported for the full GitLab 17 release cycle. + PostgreSQL 16 will also be supported for instances that want to upgrade prior to GitLab 18.0. + + If you are running a single PostgreSQL instance you installed by using an Omnibus Linux package, an automatic upgrade may be attempted with 17.11. + Make sure you have enough disk space to accommodate the upgrade. For more information, see the [Omnibus database documentation](https://docs.gitlab.com/omnibus/settings/database/#upgrade-packaged-postgresql-server). diff --git a/doc/update/deprecations.md b/doc/update/deprecations.md index d47f03bafcce91ca34ee733d38bbaf7848a76db4..98f0049938f6aa89d016061bea37ff1935df216d 100644 --- a/doc/update/deprecations.md +++ b/doc/update/deprecations.md @@ -1407,6 +1407,31 @@ Update your API integration to handle the `422` status code when making pipeline </div> +<div class="deprecation breaking-change" data-milestone="18.0"> + +### PostgreSQL 14 and 15 no longer supported + +<div class="deprecation-notes"> + +- Announced in GitLab <span class="milestone">17.9</span> +- Removal in GitLab <span class="milestone">18.0</span> ([breaking change](https://docs.gitlab.com/update/terminology/#breaking-change)) +- To discuss this change or learn more, see the [deprecation issue](https://gitlab.com/gitlab-org/gitlab/-/issues/521663). + +</div> + +GitLab follows an [annual upgrade cadence for PostgreSQL](https://handbook.gitlab.com/handbook/engineering/infrastructure-platforms/data-access/database-framework/postgresql-upgrade-cadence/). + +Support for PostgreSQL 14 and 15 is scheduled for removal in GitLab 18.0. +In GitLab 18.0, PostgreSQL 16 becomes the minimum required PostgreSQL version. + +PostgreSQL 14 and 15 will be supported for the full GitLab 17 release cycle. +PostgreSQL 16 will also be supported for instances that want to upgrade prior to GitLab 18.0. + +If you are running a single PostgreSQL instance you installed by using an Omnibus Linux package, an automatic upgrade may be attempted with 17.11. +Make sure you have enough disk space to accommodate the upgrade. For more information, see the [Omnibus database documentation](https://docs.gitlab.com/omnibus/settings/database/#upgrade-packaged-postgresql-server). + +</div> + <div class="deprecation " data-milestone="18.0"> ### Project page in group settings is deprecated