From fb9abf96bcfeeb91810991c4bd015d0df8c7334b Mon Sep 17 00:00:00 2001 From: Nick Roscarel <169005170+nick-roscarel-octo@users.noreply.github.com> Date: Mon, 10 Mar 2025 13:28:19 +1000 Subject: [PATCH 1/5] add events api deprecation --- src/pages/docs/deprecations/index.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index 82a8a8236b..13f22562e9 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -23,6 +23,11 @@ Deprecations are subject to change in detail or time frame. If you need help ass ## Planned Deprecations +### System and Space Level `/events` API Endpoint in 2025.4 +The `GET /events` and `GET /{spaceId}/events` API endpoints will be replaced by new versions that don't return pagination properties. Events are created constantly, minimising the value of providing individual page numbers, and calculating the total number of results can be very expensive on instances with larger data sets. + +The `GET /events/v2` and `GET /{spaceId}/events/v2` endpoints will be available to retrieve events in JSON format. CSV exporting will be available with the `GET /events/export` and `GET /events/{spaceId}/export` endpoints. + ### Dropping capability for Windows Server 2008 Workers and Targets in 2025.1 Microsoft [dropped extended support](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2008) for the Windows Server 2008 family in January 2020. This operating system is also the last Windows OS that does not support .NET Core, one of the languages used to build Octopus Deploy. The complexity required to support this legacy platform outweighs the value to our customers. From 547ffcfb795c27a8a1465dd3c06dd645f7bd4b9d Mon Sep 17 00:00:00 2001 From: Nick Roscarel <169005170+nick-roscarel-octo@users.noreply.github.com> Date: Tue, 11 Mar 2025 12:16:57 +1000 Subject: [PATCH 2/5] modDate bump --- src/pages/docs/deprecations/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index 13f22562e9..13308e9f62 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2023-01-01 -modDate: 2024-05-10 +modDate: 2025-03-11 title: Deprecations description: Upcoming and past deprecations by version for Octopus Server navOrder: 300 From 0592a9cdf9528a3eac7aafedeb4a4a9799fe5d0e Mon Sep 17 00:00:00 2001 From: Nick Roscarel <169005170+nick-roscarel-octo@users.noreply.github.com> Date: Tue, 11 Mar 2025 12:31:20 +1000 Subject: [PATCH 3/5] move to dedicated section --- src/pages/docs/deprecations/index.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index 13308e9f62..7358be8993 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -23,11 +23,6 @@ Deprecations are subject to change in detail or time frame. If you need help ass ## Planned Deprecations -### System and Space Level `/events` API Endpoint in 2025.4 -The `GET /events` and `GET /{spaceId}/events` API endpoints will be replaced by new versions that don't return pagination properties. Events are created constantly, minimising the value of providing individual page numbers, and calculating the total number of results can be very expensive on instances with larger data sets. - -The `GET /events/v2` and `GET /{spaceId}/events/v2` endpoints will be available to retrieve events in JSON format. CSV exporting will be available with the `GET /events/export` and `GET /events/{spaceId}/export` endpoints. - ### Dropping capability for Windows Server 2008 Workers and Targets in 2025.1 Microsoft [dropped extended support](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2008) for the Windows Server 2008 family in January 2020. This operating system is also the last Windows OS that does not support .NET Core, one of the languages used to build Octopus Deploy. The complexity required to support this legacy platform outweighs the value to our customers. @@ -37,6 +32,13 @@ To provide ample time to act, from Octopus Server `2024.1`, workloads that run o Further notes about this pending change can be found in the [2024.1 deprecation blog post](https://octopus.com/blog/2024-deprecated-features#windows-server-2008) +## Deprecations for 2025.1 + +### System and Space Level `/events` API Endpoint +The `GET /events` and `GET /{spaceId}/events` API endpoints will be replaced by new versions that don't return pagination properties. Events are created constantly, minimising the value of providing individual page numbers, and calculating the total number of results can be very expensive on instances with larger data sets. + +For similar functionality without pagination, use the `GET /events/v2` and `GET /{spaceId}/events/v2` endpoints. To export events in CSV format, use the `GET /events/export` or `GET /events/{spaceId}/export` endpoints. + ## Deprecations for 2024.3 ### Azure Resource Manager Powershell Module From dde4c3c66374eeba97796faadcb941b507bbc4b6 Mon Sep 17 00:00:00 2001 From: Nick Roscarel <169005170+nick-roscarel-octo@users.noreply.github.com> Date: Tue, 11 Mar 2025 12:35:43 +1000 Subject: [PATCH 4/5] spellcheck --- src/pages/docs/deprecations/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index 7358be8993..15ee90f7ad 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -35,7 +35,7 @@ Further notes about this pending change can be found in the [2024.1 deprecation ## Deprecations for 2025.1 ### System and Space Level `/events` API Endpoint -The `GET /events` and `GET /{spaceId}/events` API endpoints will be replaced by new versions that don't return pagination properties. Events are created constantly, minimising the value of providing individual page numbers, and calculating the total number of results can be very expensive on instances with larger data sets. +The `GET /events` and `GET /{spaceId}/events` API endpoints will be replaced by new versions that don't return pagination properties. Events are created constantly, minimizing the value of providing individual page numbers, and calculating the total number of results can be very expensive on instances with larger data sets. For similar functionality without pagination, use the `GET /events/v2` and `GET /{spaceId}/events/v2` endpoints. To export events in CSV format, use the `GET /events/export` or `GET /events/{spaceId}/export` endpoints. From 8ea492839d19e84eaa67ba76f7979635c6177771 Mon Sep 17 00:00:00 2001 From: Nick Roscarel <169005170+nick-roscarel-octo@users.noreply.github.com> Date: Tue, 11 Mar 2025 12:44:33 +1000 Subject: [PATCH 5/5] use the correct LTS version --- src/pages/docs/deprecations/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index 15ee90f7ad..aebd5cc5c1 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -32,7 +32,7 @@ To provide ample time to act, from Octopus Server `2024.1`, workloads that run o Further notes about this pending change can be found in the [2024.1 deprecation blog post](https://octopus.com/blog/2024-deprecated-features#windows-server-2008) -## Deprecations for 2025.1 +## Deprecations for 2025.2 ### System and Space Level `/events` API Endpoint The `GET /events` and `GET /{spaceId}/events` API endpoints will be replaced by new versions that don't return pagination properties. Events are created constantly, minimizing the value of providing individual page numbers, and calculating the total number of results can be very expensive on instances with larger data sets.