From a18165507060952a5c4ef07d03531496bc61494a Mon Sep 17 00:00:00 2001 From: shreddedbacon Date: Wed, 17 Jul 2024 09:50:00 +1000 Subject: [PATCH 1/2] docs: add notes about removal of harbor from api and warning about upgrading --- docs/releases/2.17.0.md | 1 + docs/releases/2.20.0.md | 16 +++++++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/releases/2.17.0.md b/docs/releases/2.17.0.md index a74a2dd184..792e0c57c0 100644 --- a/docs/releases/2.17.0.md +++ b/docs/releases/2.17.0.md @@ -15,5 +15,6 @@ There are no required actions or considerations with this release. As always, we * This release introduces a new active/standby task image that does not require the use of the [dioscuri controller](https://github.com/amazeeio/dioscuri). Dioscuri is deprecated and will eventually be removed from the `lagoon-remote` helm chart. If you use active/standby functionality in your clusters, you should upgrade to lagoon v2.17.0 and update your remote clusters to the version of the `lagoon-remote` helm chart the v2.17.0 release says to use (see release notes for v2.17.0) ### API Harbor support * Support for Harbor in the API will be removed in a future release. If you currently have your core installation with Harbor support, you should move to using the integration within lagoon-remote instead. See the documentation [here](https://docs.lagoon.sh/installing-lagoon/install-lagoon-remote) and read the section about Harbor. +* Removed in [v2.20.0](https://docs.lagoon.sh/releases/2.20.0) ### Harbor 2.1 and earlier support * Support for Harbor 2.1.x (chart version 1.5.x) and older in `lagoon-remote` will be removed in a future release. You should consider upgrading Harbor to a newer version (currently Lagoon supports up to v2.9.x (chart version 1.13.x)), following any recommended upgrade paths from Harbor. diff --git a/docs/releases/2.20.0.md b/docs/releases/2.20.0.md index 9d679251f5..10d4fd442c 100644 --- a/docs/releases/2.20.0.md +++ b/docs/releases/2.20.0.md @@ -4,9 +4,23 @@ This version has not been released yet ## Upgrades -There are no required actions or considerations with this release. As always, we suggest upgrading all minor versions. + +This release contains changes that you may need to be aware of. Read carefully before you upgrade. + +### Harbor 2.1.x and earlier +* This release removes the support for Harbor from the Lagoon API. If you're still using the Harbor support in the API, you should NOT upgrade until you have configured your `lagoon-remote` installations to use Harbor instead. See the documentation [here](https://docs.lagoon.sh/installing-lagoon/install-lagoon-remote) and read the section about Harbor. +* We also recommend that if you're using Harbor version 2.1.x and earlier, that you upgrade this as soon as possible. Follow any instructions that Harbor recommend for upgrading. As of this release, `lagoon-remote` works with Harbor version 2.10.0 (helm chart version 1.14.0). [Lagoon will stop supporting Harbor 2.1.x and earlier in a future release](https://docs.lagoon.sh/releases/2.17.0/#harbor-21-and-earlier-support). ## Deprecations ### Deleted Backups * When a backup is deleted via the webhook, it will now actually removed from the API rather than being flagged as deleted. The `Backup` type field `deleted` is deprecated, and will be removed in a future release. Additionally, `includeDeleted` if requested when querying backups will not change the result as there will be no deleted backups to include. + +### API Harbor support +* In [v2.17.0](https://docs.lagoon.sh/releases/2.17.0/#api-harbor-support) we announced that Harbor support in the API was deprecated. This release of Lagoon removes all support for Harbor from the API. See upgrade notes above. + +### DeleteAll/RemoveAll mutations removed +* This release removes all `DeleteAllX` and `RemoveAllX` from the API. These were only ever meant for local development and are no longer relevant. + +### Error handling on deployment triggers +* In the past, if triggering a deployment using any of the `DeployEnvironmentX` mutations and an error was encountered, the API would not return an actual error, just a string that contained the error. This was changed in this release to actually return an error now. As this is a change in behaviour, it may impact any users that may have previously been capturing the string error text and parsing it to check for errors. \ No newline at end of file From be2e364d820142802e2dc1423e0bd621b57ca81e Mon Sep 17 00:00:00 2001 From: Ben Jackson Date: Fri, 19 Jul 2024 11:05:48 +1000 Subject: [PATCH 2/2] docs: update wording around harbor version testing Co-authored-by: Toby Bellwood --- docs/releases/2.20.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/releases/2.20.0.md b/docs/releases/2.20.0.md index 10d4fd442c..3f42115713 100644 --- a/docs/releases/2.20.0.md +++ b/docs/releases/2.20.0.md @@ -9,7 +9,7 @@ This release contains changes that you may need to be aware of. Read carefully b ### Harbor 2.1.x and earlier * This release removes the support for Harbor from the Lagoon API. If you're still using the Harbor support in the API, you should NOT upgrade until you have configured your `lagoon-remote` installations to use Harbor instead. See the documentation [here](https://docs.lagoon.sh/installing-lagoon/install-lagoon-remote) and read the section about Harbor. -* We also recommend that if you're using Harbor version 2.1.x and earlier, that you upgrade this as soon as possible. Follow any instructions that Harbor recommend for upgrading. As of this release, `lagoon-remote` works with Harbor version 2.10.0 (helm chart version 1.14.0). [Lagoon will stop supporting Harbor 2.1.x and earlier in a future release](https://docs.lagoon.sh/releases/2.17.0/#harbor-21-and-earlier-support). +* We also recommend that if you're using Harbor version 2.1.x and earlier, that you upgrade this as soon as possible. Follow any instructions that Harbor recommend for upgrading. As of this release, `lagoon-remote` has been tested up to Harbor version 2.10.0 (helm chart version 1.14.0). [Lagoon will stop supporting Harbor 2.1.x and earlier in a future release](https://docs.lagoon.sh/releases/2.17.0/#harbor-21-and-earlier-support). ## Deprecations