From 62a23893f17bec6eeadd934420f65f5ba711ee67 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 28 May 2025 16:59:48 +0300 Subject: [PATCH 1/8] updated with notes and banner Added to banner and other chapters notes for the user to NOT upgrade RC to GA, do a fresh install for GA, and added more important notes regarding the fact that this is an RC build that should NOT be used in prod env. --- .../pg_tde/documentation/_resource/overrides/main.html | 8 ++++++-- contrib/pg_tde/documentation/docs/index.md | 3 +-- .../pg_tde/documentation/docs/index/tde-limitations.md | 3 +++ contrib/pg_tde/documentation/docs/install.md | 4 ++++ 4 files changed, 14 insertions(+), 4 deletions(-) diff --git a/contrib/pg_tde/documentation/_resource/overrides/main.html b/contrib/pg_tde/documentation/_resource/overrides/main.html index f9282a9e30d3a..81fc70d8cd3c5 100644 --- a/contrib/pg_tde/documentation/_resource/overrides/main.html +++ b/contrib/pg_tde/documentation/_resource/overrides/main.html @@ -4,8 +4,12 @@ {% extends "base.html" %} {% block announce %} - This is the Release Candidate 2 of Percona Transparent Data Encryption (TDE) extension. It is - not recommended for production environments at this stage. We encourage you to test it and give your feedback. + This is the Release Candidate 2 of Percona Transparent Data Encryption (TDE) extension. +

It is not recommended for production environments at this stage.

+ There is no safe upgrade path from the Release Candidate (RC) to the General Availability (GA) version of pg_tde. + We recommend starting with a clean installation for GA deployments. + + We encourage you to test it and give your feedback. This will help us improve the product and make it production-ready faster. {% endblock %} diff --git a/contrib/pg_tde/documentation/docs/index.md b/contrib/pg_tde/documentation/docs/index.md index a2702fd6df4c7..13512dd28cb75 100644 --- a/contrib/pg_tde/documentation/docs/index.md +++ b/contrib/pg_tde/documentation/docs/index.md @@ -3,8 +3,7 @@ `pg_tde` is the open source, community driven and futureproof PostgreSQL extension that provides Transparent Data Encryption (TDE) to protect data at rest. `pg_tde` ensures that the data stored on disk is encrypted, and that no one can read it without the proper encryption keys, even if they gain access to the physical storage media. !!! important - - This is the {{release}} version of the extension and it is not meant for production use yet. We encourage you to use it in testing environments and [provide your feedback](https://forums.percona.com/c/postgresql/pg-tde-transparent-data-encryption-tde/82). + This is the {{release}} version of the extension and **it is not meant for production use yet**. We encourage you to use it in testing environments and [provide your feedback](https://forums.percona.com/c/postgresql/pg-tde-transparent-data-encryption-tde/82). [Overview](index/index.md){.md-button} [Get Started](install.md){.md-button} diff --git a/contrib/pg_tde/documentation/docs/index/tde-limitations.md b/contrib/pg_tde/documentation/docs/index/tde-limitations.md index 393167e651123..cc10f80519b22 100644 --- a/contrib/pg_tde/documentation/docs/index/tde-limitations.md +++ b/contrib/pg_tde/documentation/docs/index/tde-limitations.md @@ -6,4 +6,7 @@ * `pg_rewind` doesn't work with encrypted WAL for now. We plan to fix it in future releases. * `pg_tde` Release candidate is incompatible with `pg_tde`Beta2 due to significant changes in code. There is no direct upgrade flow from one version to another. You must [uninstall](../how-to/uninstall.md) `pg_tde` Beta2 first and then [install](../install.md) and configure the new Release Candidate version. +!!! important + This is the {{release}} version of the extension and **it is not meant for production use yet**. We encourage you to use it in testing environments and [provide your feedback](https://forums.percona.com/c/postgresql/pg-tde-transparent-data-encryption-tde/82). + [Versions and Supported PostgreSQL Deployments](supported-versions.md){.md-button} diff --git a/contrib/pg_tde/documentation/docs/install.md b/contrib/pg_tde/documentation/docs/install.md index 01ada03b178a1..9627a71b4b331 100644 --- a/contrib/pg_tde/documentation/docs/install.md +++ b/contrib/pg_tde/documentation/docs/install.md @@ -1,5 +1,9 @@ # Install pg_tde +!!! warning "No upgrade path from RC to GA" + There is no safe upgrade path from the Release Candidate (RC 2) to the General Availability (GA) version of `pg_tde`. + We recommend starting with a **clean installation** for GA deployments. Avoid using RC environments in production. + To install `pg_tde`, use one of the following methods: === ":octicons-terminal-16: Package manager" From 534653e163facd2f488e275e4fb86e432eff153b Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 28 May 2025 17:14:24 +0300 Subject: [PATCH 2/8] Update main.html small fix --- .../documentation/_resource/overrides/main.html | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/contrib/pg_tde/documentation/_resource/overrides/main.html b/contrib/pg_tde/documentation/_resource/overrides/main.html index 81fc70d8cd3c5..f4a95bfafdaac 100644 --- a/contrib/pg_tde/documentation/_resource/overrides/main.html +++ b/contrib/pg_tde/documentation/_resource/overrides/main.html @@ -4,13 +4,12 @@ {% extends "base.html" %} {% block announce %} - This is the Release Candidate 2 of Percona Transparent Data Encryption (TDE) extension. -

It is not recommended for production environments at this stage.

- There is no safe upgrade path from the Release Candidate (RC) to the General Availability (GA) version of pg_tde. - We recommend starting with a clean installation for GA deployments. - - We encourage you to test it and give your feedback. - This will help us improve the product and make it production-ready faster. + This is the Release Candidate 2 (RC2) of Percona Transparent Data Encryption (TDE) extension. + It is not recommended for production environments at this stage. +

There is no safe upgrade path from the Release Candidate 2 (RC2) to the General Availability (GA) version of pg_tde. + We recommend starting with a clean installation for GA deployments.

+

We encourage you to test it and give your feedback. + This will help us improve the product and make it production-ready faster.

{% endblock %} {% block scripts %} From 70a0362574249869e0f48d8af2f05f83b0fbe929 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 28 May 2025 17:19:20 +0300 Subject: [PATCH 3/8] Update install.md updated RC version to 2 --- contrib/pg_tde/documentation/docs/install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contrib/pg_tde/documentation/docs/install.md b/contrib/pg_tde/documentation/docs/install.md index 9627a71b4b331..a2f561e475b7e 100644 --- a/contrib/pg_tde/documentation/docs/install.md +++ b/contrib/pg_tde/documentation/docs/install.md @@ -1,7 +1,7 @@ # Install pg_tde !!! warning "No upgrade path from RC to GA" - There is no safe upgrade path from the Release Candidate (RC 2) to the General Availability (GA) version of `pg_tde`. + There is no safe upgrade path from the Release Candidate 2 (RC2) to the General Availability (GA) version of `pg_tde`. We recommend starting with a **clean installation** for GA deployments. Avoid using RC environments in production. To install `pg_tde`, use one of the following methods: From bd8c5d1d3edc2f9fe936bc9e39634a8c509a42e5 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 28 May 2025 17:24:43 +0300 Subject: [PATCH 4/8] Update main.html removed the upgrade from the banner as it will be deleted for GA release, no need for it. --- contrib/pg_tde/documentation/_resource/overrides/main.html | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/contrib/pg_tde/documentation/_resource/overrides/main.html b/contrib/pg_tde/documentation/_resource/overrides/main.html index f4a95bfafdaac..1fca8c3d06631 100644 --- a/contrib/pg_tde/documentation/_resource/overrides/main.html +++ b/contrib/pg_tde/documentation/_resource/overrides/main.html @@ -5,9 +5,7 @@ {% block announce %} This is the Release Candidate 2 (RC2) of Percona Transparent Data Encryption (TDE) extension. - It is not recommended for production environments at this stage. -

There is no safe upgrade path from the Release Candidate 2 (RC2) to the General Availability (GA) version of pg_tde. - We recommend starting with a clean installation for GA deployments.

+

It is not recommended for production environments at this stage.

We encourage you to test it and give your feedback. This will help us improve the product and make it production-ready faster.

{% endblock %} From 3a8706796c71f82553b3039854ef6a929b6b92fb Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 28 May 2025 17:33:24 +0300 Subject: [PATCH 5/8] Update install.md hidden note about upgrade path from RC to GA for the RC2 post-release, will enable it for GA --- contrib/pg_tde/documentation/docs/install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contrib/pg_tde/documentation/docs/install.md b/contrib/pg_tde/documentation/docs/install.md index a2f561e475b7e..11cc03623c32d 100644 --- a/contrib/pg_tde/documentation/docs/install.md +++ b/contrib/pg_tde/documentation/docs/install.md @@ -1,8 +1,8 @@ # Install pg_tde -!!! warning "No upgrade path from RC to GA" + To install `pg_tde`, use one of the following methods: From 45c4b2ec9a4788186feaeeee333ccd486226722f Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 28 May 2025 19:00:19 +0300 Subject: [PATCH 6/8] Update install.md --- contrib/pg_tde/documentation/docs/install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contrib/pg_tde/documentation/docs/install.md b/contrib/pg_tde/documentation/docs/install.md index 11cc03623c32d..a2f561e475b7e 100644 --- a/contrib/pg_tde/documentation/docs/install.md +++ b/contrib/pg_tde/documentation/docs/install.md @@ -1,8 +1,8 @@ # Install pg_tde - + We recommend starting with a **clean installation** for GA deployments. Avoid using RC environments in production. To install `pg_tde`, use one of the following methods: From 1a6973994de423fbf5ee768f7264bd3cf67e47b1 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Thu, 29 May 2025 10:53:26 +0300 Subject: [PATCH 7/8] updated correct dates fixed dates --- .../pg_tde/documentation/docs/release-notes/release-notes.md | 2 +- contrib/pg_tde/documentation/variables.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/contrib/pg_tde/documentation/docs/release-notes/release-notes.md b/contrib/pg_tde/documentation/docs/release-notes/release-notes.md index 8a5cc02020cfe..f5306753eaa77 100644 --- a/contrib/pg_tde/documentation/docs/release-notes/release-notes.md +++ b/contrib/pg_tde/documentation/docs/release-notes/release-notes.md @@ -2,7 +2,7 @@ `pg_tde` extension brings in [Transparent Data Encryption (TDE)](../index/index.md) to PostgreSQL and enables you to keep sensitive data safe and secure. -* [pg_tde Release Candidate 2 ({{date.RC}})](rc2.md) +* [pg_tde Release Candidate 2 (RC2) ({{date.RC2}})](rc2.md) * [pg_tde Release Candidate ({{date.RC}})](rc.md) * [pg_tde Beta2 (2024-12-16)](beta2.md) * [pg_tde Beta (2024-06-30)](beta.md) diff --git a/contrib/pg_tde/documentation/variables.yml b/contrib/pg_tde/documentation/variables.yml index 365412e50b1a3..c39754704fe0a 100644 --- a/contrib/pg_tde/documentation/variables.yml +++ b/contrib/pg_tde/documentation/variables.yml @@ -5,5 +5,5 @@ pgversion17: '17.5.1' tdebranch: TDE_REL_17_STABLE date: - RC2: '2025-05-21' + RC2: '2025-05-29' RC: '2025-03-27' From f29a2cab46ec856b36fb81c078ea22938cc95712 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Thu, 29 May 2025 13:28:30 +0300 Subject: [PATCH 8/8] Update install.md commented out the warning for RC to GA upgrade in install pg_tde --- contrib/pg_tde/documentation/docs/install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contrib/pg_tde/documentation/docs/install.md b/contrib/pg_tde/documentation/docs/install.md index a2f561e475b7e..11cc03623c32d 100644 --- a/contrib/pg_tde/documentation/docs/install.md +++ b/contrib/pg_tde/documentation/docs/install.md @@ -1,8 +1,8 @@ # Install pg_tde -!!! warning "No upgrade path from RC to GA" + To install `pg_tde`, use one of the following methods: