Add deprecation warning to Server docs (#4144)

IanMadd · web-flow · commit 87bc76fcab7a · 2026-02-04T20:39:24.000+05:30
* Add Server deprecation warning

Signed-off-by: Ian Maddaus &lt;ian.maddaus@progress.com&gt;

* Remove aliases we don't need

Signed-off-by: Ian Maddaus &lt;ian.maddaus@progress.com&gt;

* Fix go version in docs Makefile

Signed-off-by: Ian Maddaus &lt;ian.maddaus@progress.com&gt;

* Update text

Signed-off-by: Ian Maddaus &lt;ian.maddaus@progress.com&gt;

---------

Signed-off-by: Ian Maddaus &lt;ian.maddaus@progress.com&gt;
diff --git a/docs-chef-io/Makefile b/docs-chef-io/Makefile
@@ -15,7 +15,7 @@ preview_netlify: chef_web_docs
 	pushd chef-web-docs && bash ./scripts/netlify-deploy-preview.sh && popd
 
 serve: chef_web_docs
-	printf "go 1.22\n\nuse .\nuse ../" > chef-web-docs/hugo.work
+	printf "go 1.23\n\nuse .\nuse ../" > chef-web-docs/hugo.work
 	pushd chef-web-docs && make bundle && HUGO_MODULE_WORKSPACE=hugo.work hugo server --buildDrafts --buildFuture --noHTTPCache --ignoreVendorPaths "github.com/chef/chef-server/docs-chef-io" && popd
 
 chef_web_docs:
diff --git a/docs-chef-io/content/server/_index.md b/docs-chef-io/content/server/_index.md
@@ -2,7 +2,6 @@
 title = "Chef Infra Server Overview"
 draft = false
 gh_repo = "chef-server"
-aliases = ["/server_overview.html", "/server_components.html", "/server_overview/", "/server/runbook/", "/runbook/"]
 
 [cascade]
   product = ["server"]
@@ -15,6 +14,12 @@ aliases = ["/server_overview.html", "/server_components.html", "/server_overview
     weight = 10
 +++
 
+{{< warning >}}
+
+{{< readfile file="content/server/reusable/md/deprecate_server.md" >}}
+
+{{< /warning >}}
+
 {{< readfile file="content/server/reusable/md/chef_server.md" >}}
 
 The Chef Infra Server API is written in [Erlang](http://www.erlang.org/), which is an excellent language for critical enterprise concerns like concurrency, fault-tolerance, and distributed environments. The Chef Infra Server can scale to the size of any enterprise.
diff --git a/docs-chef-io/content/server/api_chef_server.md b/docs-chef-io/content/server/api_chef_server.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/api_chef_server.html", "/api_chef_server/"]
-
 [menu]
   [menu.server]
     title = "Chef Infra Server API"
diff --git a/docs-chef-io/content/server/backend_failure_recovery.md b/docs-chef-io/content/server/backend_failure_recovery.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/backend_failure_recovery.html", "/backend_failure_recovery/"]
-
 [menu]
   [menu.server]
     title = "Backend Failure Recovery"
diff --git a/docs-chef-io/content/server/config_rb_backend.md b/docs-chef-io/content/server/config_rb_backend.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/config_rb_backend.html", "/config_rb_backend/"]
-
 [menu]
   [menu.server]
     title = "chef-backend.rb Settings"
diff --git a/docs-chef-io/content/server/config_rb_server.md b/docs-chef-io/content/server/config_rb_server.md
@@ -3,8 +3,6 @@ title = "chef-server.rb Settings"
 draft = false
 gh_repo = "chef-server"
 
-aliases = ["/config_rb_server.html", "/config_rb_server_14/", "/config_rb_server/"]
-
 [menu]
   [menu.server]
     title = "chef-server.rb Settings"
diff --git a/docs-chef-io/content/server/ctl_chef_backend.md b/docs-chef-io/content/server/ctl_chef_backend.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/ctl_chef_backend.html"]
-
 [menu]
   [menu.server]
     title = "chef-backend-ctl"
diff --git a/docs-chef-io/content/server/ctl_chef_server.md b/docs-chef-io/content/server/ctl_chef_server.md
@@ -1,11 +1,8 @@
 +++
 title = "chef-server-ctl (executable)"
 draft = false
-
 gh_repo = "chef-server"
 
-aliases = ["/ctl_chef_server.html", "/ctl_chef_server/"]
-
 [menu]
   [menu.server]
     title = "chef-server-ctl"
diff --git a/docs-chef-io/content/server/install_server.md b/docs-chef-io/content/server/install_server.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/install_server.html", "/install_server/"]
-
 [menu]
   [menu.server]
     title = "Install Chef Infra Server"
@@ -14,6 +12,12 @@ aliases = ["/install_server.html", "/install_server/"]
     weight = 10
 +++
 
+{{< warning >}}
+
+{{< readfile file="content/server/reusable/md/deprecate_server.md" >}}
+
+{{< /warning >}}
+
 There are three configuration scenarios for the Chef Infra Server:
 
 - [Standalone]({{< relref "#standalone" >}}) (everything on a single machine)
diff --git a/docs-chef-io/content/server/install_server_ha.md b/docs-chef-io/content/server/install_server_ha.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/install_server_ha.html"]
-
 [menu]
   [menu.server]
     title = "Install High Availability"
diff --git a/docs-chef-io/content/server/install_server_pre.md b/docs-chef-io/content/server/install_server_pre.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/install_server_pre.html", "/install_server_pre/"]
-
 [menu]
   [menu.server]
     title = "Chef Infra Server Prerequisites"
@@ -14,6 +12,12 @@ aliases = ["/install_server_pre.html", "/install_server_pre/"]
     weight = 10
 +++
 
+{{< warning >}}
+
+{{< readfile file="content/server/reusable/md/deprecate_server.md" >}}
+
+{{< /warning >}}
+
 The following is a detailed discussion of the prerequisites for every
 installation of the Chef Infra Server. See [Install Chef Infra Server]({{< relref "install_server" >}})
 for installation instructions.
diff --git a/docs-chef-io/content/server/install_server_tiered.md b/docs-chef-io/content/server/install_server_tiered.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/install_server_tiered.html", "/install_server_tiered/"]
-
 [menu]
   [menu.server]
     title = "Tiered Installation"
diff --git a/docs-chef-io/content/server/reusable/md/deprecate_server.md b/docs-chef-io/content/server/reusable/md/deprecate_server.md
@@ -0,0 +1 @@
+Chef Infra Server is [deprecated](/versions/#deprecated-products-and-versions) and will be end-of-life in November 2026. Contact your Chef account representative for information about upgrading to Chef Declarative State Management (DSM) on Chef 360 Platform.
diff --git a/docs-chef-io/content/server/server_backup_restore.md b/docs-chef-io/content/server/server_backup_restore.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_backup_restore.html", "/runbook/server_backup_restore/"]
-
 [menu]
   [menu.server]
     title = "Backup and Restore"
diff --git a/docs-chef-io/content/server/server_firewalls_and_ports.md b/docs-chef-io/content/server/server_firewalls_and_ports.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_firewalls_and_ports.html", "/runbook/server_firewalls_and_ports/"]
-
 [menu]
   [menu.server]
     title = "Firewalls & Ports"
diff --git a/docs-chef-io/content/server/server_logs.md b/docs-chef-io/content/server/server_logs.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_logs.html", "/runbook/server_logs/"]
-
 [menu]
   [menu.server]
     title = "Log Files"
diff --git a/docs-chef-io/content/server/server_monitor.md b/docs-chef-io/content/server/server_monitor.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_monitor.html", "/runbook/server_monitor/"]
-
 [menu]
   [menu.server]
     title = "Monitor"
diff --git a/docs-chef-io/content/server/server_orgs.md b/docs-chef-io/content/server/server_orgs.md
@@ -2,8 +2,6 @@
 title = "RBAC: Organizations and Groups"
 draft = false
 gh_repo = "chef-server"
-aliases = ["/server_orgs.html", "/auth_authorization.html"]
-product = ["client", "server"]
 
 [menu]
   [menu.server]
diff --git a/docs-chef-io/content/server/server_security.md b/docs-chef-io/content/server/server_security.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_security.html", "/server_security/"]
-
 [menu]
   [menu.server]
     title = "Security"
diff --git a/docs-chef-io/content/server/server_services.md b/docs-chef-io/content/server/server_services.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_services.html", "/runbook/server_services/"]
-
 [menu]
   [menu.server]
     title = "Services"
diff --git a/docs-chef-io/content/server/server_tuning.md b/docs-chef-io/content/server/server_tuning.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_tuning.html", "/runbook/server_tuning/"]
-
 [menu]
   [menu.server]
     title = "Tuning"
diff --git a/docs-chef-io/content/server/server_users.md b/docs-chef-io/content/server/server_users.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/server_users.html", "/server_users/"]
-
 [menu]
   [menu.server]
     title = "Server Users"
diff --git a/docs-chef-io/content/server/upgrade_server_ha_v2.md b/docs-chef-io/content/server/upgrade_server_ha_v2.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/upgrade_server_ha_v2.html", "/upgrade_server_ha_v2/"]
-
 [menu]
   [menu.server]
     title = "Upgrade HA Cluster"
diff --git a/docs-chef-io/content/server/upgrades.md b/docs-chef-io/content/server/upgrades.md
@@ -4,8 +4,6 @@ draft = false
 
 gh_repo = "chef-server"
 
-aliases = ["/upgrade_server.html", "/upgrade_server/", "/upgrades/"]
-
 [menu]
   [menu.server]
     title = "Upgrades"
@@ -14,6 +12,12 @@ aliases = ["/upgrade_server.html", "/upgrade_server/", "/upgrades/"]
     weight = 60
 +++
 
+{{< warning >}}
+
+{{< readfile file="content/server/reusable/md/deprecate_server.md" >}}
+
+{{< /warning >}}
+
 Each new release of Chef Infra Server improves reliability and updates 3rd party components to ensure the security of the server. It is important to keep Chef Infra Server up to date to ensure the secure and reliable operation of Chef Infra in your organization.
 
 {{< warning >}}
