initial commit to remove old packaging versions and create a symlink to new file
This commit is contained in:
parent
44ae8f6204
commit
6899c62671
|
@ -1,196 +0,0 @@
|
|||
<!--
|
||||
title: "Platform support policy"
|
||||
sidebar_label: "Platform support policy"
|
||||
custom_edit_url: "https://github.com/netdata/netdata/edit/master/packaging/PLATFORM_SUPPORT.md"
|
||||
learn_status: "Published"
|
||||
sidebar_position: "1"
|
||||
learn_topic_type: "Tasks"
|
||||
learn_rel_path: "Installation"
|
||||
learn_docs_purpose: "Present all the supported platform in the Netdata solution"
|
||||
-->
|
||||
|
||||
# Platform support policy
|
||||
|
||||
Netdata defines three tiers of official support:
|
||||
|
||||
- [Core](#core)
|
||||
- [Intermediate](#intermediate)
|
||||
- [Community](#community)
|
||||
|
||||
Each tier defines different guarantees for platforms in that tier, described below in the section about that tier.
|
||||
|
||||
Additionally, we define two categories for special cases that we do not support:
|
||||
|
||||
- [Third-party supported platforms](#third-party-supported-platforms)
|
||||
- [Previously supported platforms](#previously-supported-platforms)
|
||||
|
||||
These two categories are explained further below.
|
||||
|
||||
Any platforms not listed in any of these categories may or may not work.
|
||||
|
||||
The following table shows a general outline of the various support tiers and categories.
|
||||
|
||||
| | Bug Support | Guaranteed Configurations | CI Coverage | Native Packages | Static Build Support |
|
||||
| - | ----------- | ------------------------- | ----------- | --------------- | -------------------- |
|
||||
| Core | High priority | Everything but rare edge cases | Full | Yes, if we can provide them | Full |
|
||||
| Intermediate | Normal priority | Common cases | Partial (CI mostly equivalent to **Core**, but possibly with some gaps, and not required to pass) | Possibly | Full |
|
||||
| Community | Best Effort | Default only | None | No | Best Effort |
|
||||
| Third-party Supported | Users directed to platform maintainers | None | None | No | Best Effort |
|
||||
| Previously Supported | Users asked to upgrade | None | None | Yes, but only already published versions | Best Effort |
|
||||
|
||||
- ‘Bug Support’: How we handle of platform-specific bugs.
|
||||
- ‘Guaranteed Configurations’: Which runtime configurations for the agent we try to guarantee will work with minimal
|
||||
effort from users.
|
||||
- ‘CI Coverage’: What level of coverage we provide for the platform in CI.
|
||||
- ‘Native Packages’: Whether we provide native packages for the system package manager for the platform.
|
||||
- ‘Static Build Support’: How well our static builds are expected to work on the platform.
|
||||
|
||||
## Currently supported platforms
|
||||
|
||||
### Core
|
||||
|
||||
Platforms in the core support tier are our top priority. They are covered rigorously in our CI, usually
|
||||
include official binary packages, and any platform-specific bugs receive a high priority. From the perspective
|
||||
of our developers, platforms in the core support tier _must_ work, with almost no exceptions.
|
||||
Our [static builds](#static-builds) are expected to work on these platforms if available. Source-based installs are
|
||||
expected
|
||||
to work on these platforms with minimal user effort.
|
||||
|
||||
| Platform | Version | Official Native Packages | Notes |
|
||||
|--------------------------|----------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| Alpine Linux | 3.18 | No | The latest release of Alpine Linux is guaranteed to remain at **Core** tier due to usage for our Docker images |
|
||||
| Alma Linux | 9.x | x86\_64, AArch64 | Also includes support for Rocky Linux and other ABI compatible RHEL derivatives |
|
||||
| Alma Linux | 8.x | x86\_64, AArch64 | Also includes support for Rocky Linux and other ABI compatible RHEL derivatives |
|
||||
| Amazon Linux | 2023 | x86\_64, AArch64 | |
|
||||
| Amazon Linux | 2 | x86\_64, AArch64 | |
|
||||
| CentOS | 7.x | x86\_64 | |
|
||||
| Docker | 19.03 or newer | x86\_64, i386, ARMv7, AArch64, POWER8+ | See our [Docker documentation](https://github.com/netdata/netdata/blob/master/packaging/docker/README.md) for more info on using Netdata on Docker |
|
||||
| Debian | 12.x | x86\_64, i386, ARMv7, AArch64 | |
|
||||
| Debian | 11.x | x86\_64, i386, ARMv7, AArch64 | |
|
||||
| Debian | 10.x | x86\_64, i386, ARMv7, AArch64 | |
|
||||
| Fedora | 39 | x86\_64, AArch64 | |
|
||||
| Fedora | 38 | x86\_64, AArch64 | |
|
||||
| Fedora | 37 | x86\_64, AArch64 | |
|
||||
| openSUSE | Leap 15.5 | x86\_64, AArch64 | |
|
||||
| openSUSE | Leap 15.4 | x86\_64, AArch64 | |
|
||||
| Oracle Linux | 9.x | x86\_64, AArch64 | |
|
||||
| Oracle Linux | 8.x | x86\_64, AArch64 | |
|
||||
| Red Hat Enterprise Linux | 9.x | x86\_64, AArch64 | |
|
||||
| Red Hat Enterprise Linux | 8.x | x86\_64, AArch64 | |
|
||||
| Red Hat Enterprise Linux | 7.x | x86\_64 | |
|
||||
| Ubuntu | 23.10 | x86\_64, AArch64, ARMv7 | |
|
||||
| Ubuntu | 22.04 | x86\_64, ARMv7, AArch64 | |
|
||||
| Ubuntu | 20.04 | x86\_64, ARMv7, AArch64 | |
|
||||
|
||||
|
||||
### Intermediate
|
||||
|
||||
Platforms in the intermediate support tier are those which Netdata wants to support, but cannot justify core level
|
||||
support for. They are also covered in CI, but not as rigorously as the core tier. They may or may not include
|
||||
official binary packages, and any platform-specific bugs receive a normal priority. Generally, we will add new
|
||||
platforms that we officially support ourselves to the intermediate tier. Our [static builds](#static-builds) are
|
||||
expected to work on these platforms if available. Source-based installs are expected to work on these platforms
|
||||
with minimal user effort.
|
||||
|
||||
| Platform | Version | Official Native Packages | Notes |
|
||||
|---------------|------------|--------------------------|------------------------------------------------------------------------------------------------------|
|
||||
| Alpine Linux | Edge | No | |
|
||||
| Alpine Linux | 3.17 | No | |
|
||||
| Alpine Linux | 3.16 | No | |
|
||||
| Arch Linux | Latest | No | We officially recommend the community packages available for Arch Linux |
|
||||
| Manjaro Linux | Latest | No | We officially recommend the community packages available for Arch Linux |
|
||||
| openSUSE | Tumbleweed | x86\_64, AArch64 | Scheduled for promotion to Core tier at some point after the release of v1.41.0 of the Netdata Agent |
|
||||
|
||||
### Community
|
||||
|
||||
Platforms in the community support tier are those which are primarily supported by community contributors. They may
|
||||
receive some support from Netdata, but are only a best-effort affair. When a community member makes a contribution
|
||||
to add support for a new platform, that platform generally will start in this tier. Our [static builds](#static-builds)
|
||||
are expected to work on these platforms if available. Source-based installs are usually expected to work on these
|
||||
platforms, but may require some extra effort from users.
|
||||
|
||||
| Platform | Version | Official Native Packages | Notes |
|
||||
|--------------|------------|--------------------------|-----------------------------------------------------------------------------------------------------------|
|
||||
| Clear Linux | Latest | No | |
|
||||
| Debian | Sid | No | |
|
||||
| Fedora | Rawhide | No | |
|
||||
| FreeBSD | 13-STABLE | No | Netdata is included in the FreeBSD Ports Tree, and this is the recommended installation method on FreeBSD |
|
||||
| Gentoo | Latest | No | |
|
||||
| macOS | 13 | No | Currently only works for Intel-based hardware. Requires Homebrew for dependencies |
|
||||
| macOS | 12 | No | Currently only works for Intel-based hardware. Requires Homebrew for dependencies |
|
||||
| macOS | 11 | No | Currently only works for Intel-based hardware. Requires Homebrew for dependencies. |
|
||||
|
||||
## Third-party supported platforms
|
||||
|
||||
Some platform maintainers actively support Netdata on their platforms even though we do not provide official
|
||||
support. Third-party supported platforms may work, but the experience of using Netdata on such platforms is not
|
||||
something we can guarantee. When you use an externally supported platform and report a bug, we will either ask
|
||||
you to reproduce the issue on a supported platform or submit a support request directly to the platform maintainers.
|
||||
|
||||
Currently, we know of the following platforms having some degree of third-party support for Netdata:
|
||||
|
||||
- NixOS: Netdata’s official installation methods do not support NixOS, but the NixOS maintainers provide their
|
||||
own Netdata packages for their platform.
|
||||
- Rockstor: Rockstor provides support for a Netdata add-on for their NAS platform. The Rockstor community and
|
||||
developers are the primary source for support on their platform.
|
||||
|
||||
## Previously supported platforms
|
||||
|
||||
As platforms become end of life upstream, Netdata will stop officially supporting them. We will not actively break
|
||||
things on these platforms, but we will also not make any effort to ensure that things keep working on them either.
|
||||
If you report a bug on a previously supported platforms, we will ask you to reproduce the issue on a currently
|
||||
supported platform. If the issue is not reproducible, it will be closed.
|
||||
|
||||
We consider a platform to be end of life when the upstream maintainers of that platform stop providing official
|
||||
support for it themselves, or when that platform transitions into an ‘extended security maintenance’ period.
|
||||
Platforms that meet these criteria will be immediately transitioned to the **Previously Supported** category,
|
||||
with no prior warning from Netdata and no deprecation notice, unlike those being dropped for technical reasons,
|
||||
as our end of support should already coincide with the end of the normal support lifecycle for that platform.
|
||||
|
||||
On occasion, we may also drop support for a platform due to technical limitations. In such cases, this will be
|
||||
announced in the release notes of the next stable release with a deprecation notice. The platform will be supported
|
||||
for _that release_, and will be removed from nightlies some time before the next release after that one.
|
||||
|
||||
This is a list of platforms that we have supported in the recent past but no longer officially support:
|
||||
|
||||
| Platform | Version | Notes |
|
||||
|--------------|-----------|----------------------|
|
||||
| Alpine Linux | 3.14 | EOL as of 2023-05-01 |
|
||||
| Alpine Linux | 3.13 | EOL as of 2022-11-01 |
|
||||
| Debian | 9.x | EOL as of 2022-06-30 |
|
||||
| Fedora | 37 | EOL as of 2023-12-05 |
|
||||
| Fedora | 36 | EOL as of 2023-05-18 |
|
||||
| Fedora | 35 | EOL as of 2022-12-13 |
|
||||
| openSUSE | Leap 15.4 | EOL as of 2023-12-07 |
|
||||
| openSUSE | Leap 15.3 | EOL as of 2022-12-01 |
|
||||
| Ubuntu | 23.04 | EOL as of 2024-01-20 |
|
||||
| Ubuntu | 22.10 | EOL as of 2023-07-20 |
|
||||
| Ubuntu | 21.10 | EOL as of 2022-07-31 |
|
||||
| Ubuntu | 18.04 | EOL as of 2023-04-02 |
|
||||
|
||||
## Static builds
|
||||
|
||||
The Netdata team provides static builds of Netdata for Linux systems with a selection of common CPU
|
||||
architectures. These static builds are largely self-contained, only requiring a a POSIX-compliant shell on the target
|
||||
system to provide their basic functionality. Static builds are built in an Alpine Linux environment using musl. This
|
||||
means that they generally do not support non-local username mappings or exotic name resolution configurations.
|
||||
|
||||
We currently provide static builds for the following CPU architectures:
|
||||
|
||||
- 64-bit x86
|
||||
- ARMv7
|
||||
- ARMv6
|
||||
- AArch64
|
||||
- POWER8+
|
||||
|
||||
## Platform-specific support considerations
|
||||
|
||||
### IPMI
|
||||
|
||||
Our IPMI collector is based on FreeIPMI. Due to upstream limitations in FreeIPMI, we are unable to support our
|
||||
IPMI collector on POWER-based hardware.
|
||||
|
||||
### Systemd
|
||||
|
||||
Many of our systemd integrations are not supported in our static builds. This is due to a general refusal by the
|
||||
systemd developers to support static linking (or any C runtime other than glibc), and is not something we can resolve.
|
|
@ -0,0 +1 @@
|
|||
../docs/netdata-agent/versions-and-platforms.md
|
|
@ -121,7 +121,7 @@ The following special exceptions to the public API exist:
|
|||
guaranteed to be supported for in-place updates for at least two minor versions after the change happens. The
|
||||
new format is not guaranteed to be backwards compatible.
|
||||
- The list of supported platforms is functionally a part of the public API, but our existing [platform support
|
||||
policy](https://github.com/netdata/netdata/blob/master/packaging/PLATFORM_SUPPORT.md) dictates when and how
|
||||
policy](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/versions-and-platforms.md) dictates when and how
|
||||
support for specific platforms is added or removed.
|
||||
- The list of components provided as separate packages in our official native packages is considered part of our
|
||||
strictly defined public API, but changes to our packaging that do not alter the functionality of existing installs
|
||||
|
|
Loading…
Reference in New Issue