diff --git a/content/client/19/overview/platforms.md b/content/client/19/overview/platforms.md new file mode 100644 index 0000000000..7ade79ee14 --- /dev/null +++ b/content/client/19/overview/platforms.md @@ -0,0 +1,138 @@ ++++ +title = "Supported platforms" +draft = false + +[menu] + [menu.client_19] + title = "Supported platforms" + identifier = "overview/chef_infra_client_platforms.md Supported Platforms" + parent = "overview" + weight = 30 ++++ + +This page lists the operating system platforms supported by Chef Infra Client 19. + +## Support definitions + +### Certification tiers + +**Validated & Supported** +: These platforms are fully tested on every release. These platforms run through the complete Chef automated test suite in CI/CD before each release. + +**Supported (Untested)** +: These platforms are fully supported, but not tested in our CI/CD pipelines. Chef stands behind these platforms and will address any reported bugs. + +**User Reported** +: These platforms are validated by users. Support is provided on a best-effort basis. + +### Installer types + +**Native** +: Chef is installed using the platform's native package manager—MSI on Windows, DEB on Debian/Ubuntu, RPM on RHEL/SUSE, PKG on macOS. + +**Habitat** +: Chef is installed and run using [Chef Habitat](https://www.habitat.sh/) commands (`hab pkg install`) or by extracting a Habitat artifact (`.hart` or `.tar.gz`). Used for platforms where a native package isn't available or where a self-contained runtime is preferred. + +### Agent and agentless modes + +**Agent** +: Agent-based mode includes all software that runs directly on the managed node: + +- Chef Infra Client +- Chef InSpec +- Chef Habitat supervisor +- Chef 360 skills running in agent mode, including Courier job execution and Node Management + +**Agentless** +: Agentless mode includes all software that manages a node remotely without an agent present on the node: + +- Chef Infra Client agentless mode (formerly Target Mode)—connects using SSH (Linux) or WinRM/SSH (Windows) +- Chef InSpec (remote scanning) +- Chef 360 Courier agentless job execution + +## RHEL / Enterprise Linux family + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| Red Hat Enterprise Linux | `x86_64`, `aarch64` | `7.x`, `8.x`, `9.x`, `10.x` | Validated & Supported | Yes | Yes | Native, Habitat | +| Red Hat Enterprise Linux | `s390x`, `ppc64le`, `ppc64` | `7.x`, `8.x` | Validated & Supported | No | Yes | Habitat | +| CentOS | `x86_64`, `aarch64` | `7.x` | Validated & Supported | Yes | Yes | Native, Habitat | +| CentOS | `ppc64le`, `ppc64` | `7.x` | Validated & Supported | No | Yes | Habitat | +| Oracle Enterprise Linux | `x86_64`, `aarch64` | `7.x`, `8.x` | Validated & Supported | Yes | Yes | Native, Habitat | +| Amazon Linux | `x86_64`, `aarch64` | `2.x`, `2023` | Validated & Supported | Yes | Yes | Native, Habitat | +| Rocky Linux | `x86_64`, `aarch64` | `8.x`, `9.x` | Supported (Untested) | Yes | Yes | Habitat | +| AlmaLinux | `x86_64`, `aarch64` | `8.x`, `9.x`, `10.x` | Supported (Untested) | Yes | Yes | Habitat | +| CentOS Stream | `x86_64`, `aarch64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| Fedora | `x86_64`, `aarch64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | + +## Debian / Ubuntu family + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| Debian | `x86_64`, `aarch64` | `10`, `11` | Validated & Supported | Yes | Yes | Native, Habitat | +| Ubuntu (LTS releases) | `x86_64`, `aarch64` | `18.04`, `20.04`, `22.04`, `24.04` | Validated & Supported | Yes | Yes | Native, Habitat | +| Kali Linux | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| Linux Mint | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| Pop!_OS | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| Raspberry Pi OS | `aarch64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| Ubuntu (non-LTS) | `x86_64`, `aarch64` | current non-LTS releases | User Reported | Yes | Yes | Habitat | + +## SUSE family + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| SUSE Linux Enterprise Server | `x86_64`, `aarch64` | `12`, `15` | Validated & Supported | Yes | Yes | Native, Habitat | +| SUSE Linux Enterprise Server | `s390x` | `12`, `15` | Validated & Supported | No | Yes | Habitat | +| openSUSE | `x86_64`, `aarch64` | `15.x` | User Reported | Yes | Yes | Habitat | +| SUSE Linux Enterprise Desktop | `x86_64`, `aarch64` | `12.x`, `15.x` | User Reported | Yes | Yes | Habitat | + +## Windows + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| Windows | `x86_64` | `10`, `11`, Server `2016`, `2019` (LTSC), `2022`, `2025` | Validated & Supported | Yes | Yes | Native (MSI) | +| Windows Server, Semi-annual channel (SAC) | `x64` | Server Core only | User Reported | Yes | Yes | Habitat | + +## macOS + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| macOS | `aarch64` | `13.x`, `14.x` | Validated & Supported | Yes | Yes | Native | + +## IBM AIX + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| IBM AIX | `powerpc` | `7.1` (TL5 SP2 or higher), `7.2`, `7.3` | Validated & Supported | No | Yes | Habitat | + +## Oracle Solaris + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| Oracle Solaris | `i86pc` | `11.3` (16.17.4 and later only), `11.4` | Validated & Supported | Yes | Yes | Habitat | +| Oracle Solaris | `sparc` | `11.3` (16.17.4 and later only), `11.4` | Validated & Supported | No | Yes | Habitat | + +## FreeBSD + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| FreeBSD | `amd64` | `13.x` | Validated & Supported | Yes | Yes | Habitat | + +## Specialized and network Linux + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| Arista EOS | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| Cumulus Linux | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| XCP-ng | `x86_64` | `8.x` | User Reported | Yes | Yes | Habitat | + +## Other community platforms + +| Platform | Architecture | Version | Tier | Agent | Agentless | Installer | +| --- | --- | --- | --- | --- | --- | --- | +| Alibaba Cloud Linux | `x86_64` | `2.x` | User Reported | Yes | Yes | Habitat | +| Arch Linux | `x86_64` | current version | User Reported | Yes | Yes | Habitat | +| Clear Linux | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| OpenIndiana Hipster | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| SmartOS | `x86_64` | current non-EOL releases | User Reported | Yes | Yes | Habitat | +| Virtuozzo | `x86_64` | current non-LTS releases | User Reported | Yes | Yes | Habitat | diff --git a/content/platforms.md b/content/platforms.md index 510e647b85..e0f4c8e6f1 100644 --- a/content/platforms.md +++ b/content/platforms.md @@ -13,29 +13,46 @@ swiftype_search_products = ["automate", "client", "server", "habitat", "inspec", weight = 20 +++ -Chef software is supported on the operating systems (platforms) -listed below. To see which versions of our software we currently -support, see the [Supported Versions](/versions/) page. +## Support definitions -## Support +### Certification tiers -We offer two levels of support for platforms (operating systems), [Commercial Support]({{< relref "#commercial-support">}}) and [Community Support]({{< relref "#community-support" >}}). +**Validated & Supported** +: These platforms are fully tested on every release. These platforms run through the complete Chef automated test suite in CI/CD before each release. -### Commercial support +**Supported (Untested)** +: These platforms are fully supported, but not tested in our CI/CD pipelines. Chef stands behind these platforms and will address any reported bugs. -Commercial support for platforms is part of paid maintenance contracts with Chef Software. Support contracts allow you to open tickets and receive service level agreement (SLA) assistance from our support desk. Commercially supported platforms are extensively tested as part of Chef's development and release process. Commercial support follows the lifecycle of the underlying operating system vendor. +**User Reported** +: These platforms are validated by users. Support is provided on a best-effort basis. -Commercial support is limited to the platforms listed in the "Commercial Support" tables--platforms not listed in these tables are unsupported. +### Installer types -### Community support +**Native** +: Chef is installed using the platform's native package manager—MSI on Windows, DEB on Debian/Ubuntu, RPM on RHEL/SUSE, PKG on macOS. -Community support for platforms means that members of the Chef community have contributed to these platforms and Chef doesn't actively work to maintain this functionality. Chef doesn't explicitly test community supported platforms as part of the development and release process. +**Habitat** +: Chef is installed and run using [Chef Habitat](https://www.habitat.sh/) commands (`hab pkg install`) or by extracting a Habitat artifact (`.hart` or `.tar.gz`). Used for platforms where a native package isn't available or where a self-contained runtime is preferred. -Many of these platforms are forks, clones, or otherwise derivative of platforms that Chef commercially supports. Continued functionality for these platforms is likely, but not guaranteed. Unsupported platforms may have missing or non-operative functionality. As always, we welcome community contributions from anyone looking to expand community support for platforms in Chef products. +### Agent and agentless modes -### Support for derived platforms +**Agent** +: Agent-based mode includes all software that runs directly on the managed node: -Chef doesn't explicitly test or provide builds for derived distributions other than those in our supported platform list. However, if the derived distribution is a direct rebuild of the originating distribution and hasn't diverged in functionality or packaged dependencies, Chef will support our customers through our normal channels. +- Chef Infra Client +- Chef InSpec +- Chef Habitat supervisor +- Chef 360 skills running in agent mode, including Courier job execution and Node Management + +**Agentless** +: Agentless mode includes all software that manages a node remotely without an agent present on the node: + +- Chef Infra Client agentless mode (formerly Target Mode)—connects using SSH (Linux) or WinRM/SSH (Windows) +- Chef InSpec (remote scanning) +- Chef 360 Courier agentless job execution + +Chef software is supported on the operating systems (platforms) listed below. +To see which versions of our software we currently support, see the [Supported Versions](/versions/) page. ## Platforms @@ -65,82 +82,24 @@ documentation for a list of supported platforms for Chef Automate HA. The following table lists the commercially supported platforms for Chef Backend, which is the high-availability solution for Chef Infra Server. -| Platform | Architecture | Version | +| Platform | Version | Architecture | | --- | --- | --- | -| CentOS | `x86_64` | `6.x`, `7.x`, `8.x` | -| Oracle Enterprise Linux | `x86_64` | `7.x`, `8.x` | -| Red Hat Enterprise Linux | `x86_64` | `6.x`, `7.x`, `8.x` | -| SUSE Linux Enterprise Server | `x86_64` | `12.x` | -| Ubuntu (LTS releases) | `x86_64` | `16.04`, `18.04` | +| CentOS | `6.x`, `7.x`, `8.x` | `x86_64` | +| Oracle Enterprise Linux | `7.x`, `8.x` | `x86_64` | +| Red Hat Enterprise Linux | `6.x`, `7.x`, `8.x` | `x86_64` | +| SUSE Linux Enterprise Server | `12.x` | `x86_64` | +| Ubuntu (LTS releases) | `16.04`, `18.04` | `x86_64` | #### Derived platforms -The following table lists supported derived platforms and versions for Chef Infra Server. - -See our policy on [support for derived platforms](#support-for-derived-platforms) for more information. - -| Platform | Architecture | Version | Parent platform | +| Platform | Version | Architecture | Parent platform | | --- | --- | --- | --- | -| AlmaLinux | `x86_64` | `8.x` | CentOS | -| Rocky Linux | `x86_64` | `8.x` | CentOS | +| AlmaLinux | `8.x` | `x86_64` | CentOS | +| Rocky Linux | `8.x` | `x86_64` | CentOS | ### Chef Infra Client -#### Commercial support - -The following table lists the commercially supported platforms and versions for Chef Infra Client. - -| Platform | Architecture | Version | -| --- | --- | --- | -| AIX | `powerpc` | `7.1` (TL5 SP2 or higher, recommended), `7.2`, `7.3` | -| Amazon Linux | `x86_64`, `aarch64` | `2.x`, `2023` | -| CentOS | `x86_64`, `ppc64le`, `ppc64`, `aarch64` | `7.x` | -| Debian | `x86_64`, `aarch64` | `10`, `11`, `13` | -| FreeBSD | `amd64` | `13.x` | -| macOS | `aarch64` | `13.x`, `14.x` | -| Oracle Enterprise Linux | `x86_64`, `aarch64` | `7.x`, `8.x` | -| Red Hat Enterprise Linux | `x86_64`, `ppc64le` (7.x only), `ppc64` (7.x only), `aarch64`, `s390x` (7.x / 8.x only) | `7.x`, `8.x`, `9.x`, `10.x` | -| Rocky Linux | `x86_64`, `aarch64` | `8.x`, `9.x` | -| Solaris | `sparc`, `i86pc` | `11.3` (16.17.4 and later only), `11.4` | -| SUSE Linux Enterprise Server | `x86_64`, `aarch64` (15.x only), `s390x` | `12`, `15` | -| Ubuntu (LTS releases) | `x86_64`,`aarch64` (18.x and above) | `18.04`, `20.04`, `22.04`, `24.04`, `26.04` | -| Windows | `x86_64` | `2016`, `10` (all channels except "insider" builds), `2019` (Long-term servicing channel (LTSC), both Desktop Experience and Server Core), `11`, `2022`, `2025` | - -#### Derived platforms - -The following table lists supported derived platforms and versions for Chef Infra Client. - -See our policy on [support for derived platforms](#support-for-derived-platforms) for more information. - -| Platform | Architecture | Version | Parent platform | -| --- | --- | --- | --- | -| AlmaLinux | `x86_64`, `aarch64` | `8.x`, `9.x`, `10.x` | CentOS | - -#### Community support - -The following platforms are supported only using the community. - -| Platform | Architecture | Version | -| --- | --- | --- | -| Alibaba Cloud Linux | `x86_64` | 2.x | -| Arch Linux | `x86_64` | current version | -| Arista EOS | `x86_64` | current non-EOL releases | -| CentOS Stream | `x86_64`, `aarch64` | current non-EOL releases | -| Clear Linux | `x86_64` | current non-EOL releases | -| Cumulus Linux | `x86_64` | current non-EOL releases | -| Fedora | `x86_64`, `aarch64` | current non-EOL releases | -| Kali Linux | `x86_64` | current non-EOL releases | -| Linux Mint | `x86_64` | current non-EOL releases | -| OpenIndiana Hipster | `x86_64` | current non-EOL releases | -| openSUSE | `x86_64`, `aarch64` | `15.x` | -| Pop!_OS | `x86_64` | current non-EOL releases | -| Raspberry Pi OS | `aarch64` | current non-EOL releases | -| SmartOS | `x86_64` | current non-EOL releases | -| SUSE Linux Enterprise Desktop | `x86_64`, `aarch64` (15.x only) | `12.x`, `15.x` | -| Ubuntu | `x86_64`, `aarch64` | Current non-LTS releases | -| Virtuozzo | `x86_64` | Current non-LTS releases | -| Windows | `x64` | `Windows Server, Semi-annual channel (SAC) (Server Core only)` | -| XCP-ng | `x86_64` | 8.x | +See the [Chef Infra Client supported platforms](/client/19/overview/platforms/) documentation for the full list of supported platforms, certification tiers, and installer types. ### Chef Infra Server @@ -185,16 +144,15 @@ Chef Workstation 26.0 is supported on: {{< foundation_tabs_panel panel-id="chef-workstation-commercial-support-v25" >}} -Chef Workstation 25.x is supported on: - -| Platform | Architecture | Version | -|-----------------------------------| ----------------------------| ---------------------------------------------------------------------------| -| Amazon Linux | x86_64, arch64 (2023 only) | 2.x, 2023 | -| macOS | aarch64 | 13.x, 14.x | -| Debian | x86_64 | 10.x, 11.x | -| Red Hat Enterprise Linux / CentOS | x86_64 | 7.x, 8.x, 9.x | -| Ubuntu | x86_64 | 18.04, 20.04, 22.04 | -| Windows | x64 | 10, 11, Server 2016, Server 2019, Server 2022 | +| Platform | Version | Architecture | +|-----------------------------------| ----------------------------------------------| ----------------------------| +| Amazon Linux | 2.x | x86_64 | +| Amazon Linux | 2023 | x86_64, aarch64 | +| macOS | 13.x, 14.x | aarch64 | +| Debian | 10.x, 11.x | x86_64 | +| Red Hat Enterprise Linux / CentOS | 7.x, 8.x, 9.x | x86_64 | +| Ubuntu | 18.04, 20.04, 22.04 | x86_64 | +| Windows | 10, 11, Server 2016, Server 2019, Server 2022 | x64 | {{< /foundation_tabs_panel >}} @@ -204,12 +162,10 @@ Chef Workstation 25.x is supported on: Chef Workstation 25 supports the following derived platforms and versions. -| Platform | Architecture | Version | Parent platform | +| Platform | Version | Architecture | Parent platform | | --- | --- | --- | --- | -| AlmaLinux | `x86_64` | `8.x` | CentOS | -| Rocky Linux | `x86_64` | `8.x` | CentOS | - -See our policy on [support for derived platforms](#support-for-derived-platforms) for more information. +| AlmaLinux | `8.x` | `x86_64` | CentOS | +| Rocky Linux | `8.x` | `x86_64` | CentOS | ## Platform end-of-life policy