docs: Update supported platforms docs (#15365)
Co-authored-by: Dane Strandboge <136023093+DStrand1@users.noreply.github.com>
This commit is contained in:
Joshua Powers
GitHub
parent
66d864b1e6
commit
6effacd96e
|
|
@ -1,199 +1,60 @@
|
||||||
# Supported Platforms
|
# Supported Platforms
|
||||||
|
|
||||||
Telegraf is a cross-platform application. This doc helps define which
|
This doc helps define the platform support for Telegraf. See the
|
||||||
operating systems, distributions, and releases Telegraf supports.
|
[install guide][] for specific options for installing Telegraf.
|
||||||
|
|
||||||
Telegraf is supported on Linux, FreeBSD, Windows, and macOS. It is
|
Bug reports should be submitted only for supported platforms that are under
|
||||||
written in Go which supports these operating systems and
|
general support, not extended or paid support. In general, Telegraf supports
|
||||||
more. Telegraf may work on Go's other operating systems and users are
|
Linux, macOS, Microsoft Windows, and FreeBSD.
|
||||||
welcome to build their own binaries for them. Bug reports should be
|
|
||||||
submitted only for supported platforms.
|
|
||||||
|
|
||||||
Golang.org has a [table][go-table] of valid OS and architecture
|
Telegraf is written in Go, which supports many operating systems. Golang.org
|
||||||
combinations and the golang wiki has more specific [minimum
|
has a [table][go-table] of valid OS and architecture combinations and the Go
|
||||||
requirements][go-reqs] for Go itself.
|
Wiki has more specific [minimum requirements][go-reqs] for Go itself. Telegraf
|
||||||
|
may work and produce builds for other operating systems and users are welcome to
|
||||||
|
build their own binaries for them. Again, bug reports must be made on a
|
||||||
|
supported platform.
|
||||||
|
|
||||||
|
[install guide]: /docs/INSTALL_GUIDE.md
|
||||||
[go-table]: https://golang.org/doc/install/source#environment
|
[go-table]: https://golang.org/doc/install/source#environment
|
||||||
[go-reqs]: https://github.com/golang/go/wiki/MinimumRequirements#operating-systems
|
[go-reqs]: https://github.com/golang/go/wiki/MinimumRequirements#operating-systems
|
||||||
|
|
||||||
## Linux
|
|
||||||
|
|
||||||
Telegraf intent: *Support latest versions of major linux
|
|
||||||
distributions*
|
|
||||||
|
|
||||||
Telegraf supports RHEL, Fedora, Debian, and Ubuntu. InfluxData
|
|
||||||
provides package repositories for these distributions. Instructions
|
|
||||||
for using the package repositories can be found on
|
|
||||||
[docs.influxdata.com][repo-docs]. Bug reports should be submitted only
|
|
||||||
for supported distributions and releases.
|
|
||||||
|
|
||||||
Telegraf's Debian or Ubuntu packages are likely to work on other
|
|
||||||
Debian-based distributions although these are not
|
|
||||||
supported. Similarly, Telegraf's Fedora and RHEL packages are likely
|
|
||||||
to work on other Redhat-based distributions although again these are
|
|
||||||
not supported.
|
|
||||||
|
|
||||||
Telegraf releases include .tar.gz packages for use with other
|
|
||||||
distributions, for building container images, or for installation
|
|
||||||
without a package manager. As part of telegraf's release process we
|
|
||||||
publish [official images][docker-hub] to Docker Hub.
|
|
||||||
|
|
||||||
Distrowatch lists [major distributions][dw-major] and tracks
|
|
||||||
[popularity][dw-pop] of distributions. Wikipedia lists [linux
|
|
||||||
distributions][wp-distro] by the major distribution they're based on.
|
|
||||||
|
|
||||||
[repo-docs]: https://docs.influxdata.com/telegraf/latest/introduction/installation/
|
|
||||||
[docker-hub]: https://hub.docker.com/_/telegraf
|
|
||||||
[dw-major]: https://distrowatch.com/dwres.php?resource=major
|
|
||||||
[dw-pop]: https://distrowatch.com/dwres.php?resource=popularity
|
|
||||||
[wp-distro]: https://en.wikipedia.org/wiki/List_of_Linux_distributions
|
|
||||||
|
|
||||||
### RHEL
|
|
||||||
|
|
||||||
Red Hat makes a major release every four to five years and supports
|
|
||||||
each release in production for ten years. Extended support is
|
|
||||||
available for three or more years.
|
|
||||||
|
|
||||||
Telegraf intent: *Support releases in RHEL production, but not in
|
|
||||||
extended support.*
|
|
||||||
|
|
||||||
Redhat publishes [release history][rh-history] and wikipedia has a
|
|
||||||
[summary timeline][wp-rhel].
|
|
||||||
|
|
||||||
As of April 2021, 7 and 8 are production releases.
|
|
||||||
|
|
||||||
[rh-history]: https://access.redhat.com/articles/3078
|
|
||||||
[wp-rhel]: https://en.wikipedia.org/wiki/Red_Hat_Enterprise_Linux#Version_history_and_timeline
|
|
||||||
|
|
||||||
### Ubuntu
|
|
||||||
|
|
||||||
Ubuntu makes two releases a year. Every two years one of the releases
|
|
||||||
is an LTS (long-term support) release. Interim (non-LTS) releases are
|
|
||||||
in standard support for nine months. LTS releases are in maintenance
|
|
||||||
for five years, then in extended security maintenance for up to three
|
|
||||||
more years.
|
|
||||||
|
|
||||||
Telegraf intent: *Support interim releases and LTS releases in Ubuntu
|
|
||||||
maintenance, but not in extended security maintenance.*
|
|
||||||
|
|
||||||
Ubuntu publishes [release history][ub-history] and wikipedia has a
|
|
||||||
[table][wp-ub] of all releases and support status.
|
|
||||||
|
|
||||||
As of April 2021, Ubuntu 20.10 is in standard support. Ubuntu 18.04
|
|
||||||
LTS and 20.04 LTS are in maintenance.
|
|
||||||
|
|
||||||
[ub-history]: https://ubuntu.com/about/release-cycle
|
|
||||||
[wp-ub]: https://en.wikipedia.org/wiki/Ubuntu_version_history#Table_of_versions
|
|
||||||
|
|
||||||
### Debian
|
|
||||||
|
|
||||||
Debian generally makes major releases every two years and provides
|
|
||||||
security support for each release for three years. After security
|
|
||||||
support expires the release enters long term support (LTS) until at
|
|
||||||
least five years after release.
|
|
||||||
|
|
||||||
Telegraf intent: *Support releases under Debian security support*
|
|
||||||
|
|
||||||
Debian publishes [releases and support status][deb-history] and
|
|
||||||
wikipedia has a [summary table][wp-deb].
|
|
||||||
|
|
||||||
As of April 2021, Debian 10 is in security support.
|
|
||||||
|
|
||||||
[deb-history]: https://www.debian.org/releases/
|
|
||||||
[wp-deb]: https://en.wikipedia.org/wiki/Debian_version_history#Release_table
|
|
||||||
|
|
||||||
### Fedora
|
|
||||||
|
|
||||||
Fedora makes two releases a year and supports each release for a year.
|
|
||||||
|
|
||||||
Telegraf intent: *Support releases supported by Fedora*
|
|
||||||
|
|
||||||
Fedora publishes [release history][fed-history] and wikipedia has a
|
|
||||||
[summary table][wp-fed].
|
|
||||||
|
|
||||||
[fed-history]: https://fedoraproject.org/wiki/Releases
|
|
||||||
[wp-fed]: https://en.wikipedia.org/wiki/Fedora_version_history#Version_history
|
|
||||||
|
|
||||||
## FreeBSD
|
## FreeBSD
|
||||||
|
|
||||||
FreeBSD makes major releases about every two years. Releases reach end
|
Telegraf supports releases under FreeBSD security support. See the
|
||||||
of life after five years.
|
[FreeBSD security page][] for specific versions.
|
||||||
|
|
||||||
Telegraf intent: *Support releases under FreeBSD security support*
|
[FreeBSD security page]: https://www.freebsd.org/security/#sup
|
||||||
|
|
||||||
FreeBSD publishes [release history][freebsd-history] and wikipedia has
|
## Linux
|
||||||
a [summary table][wp-freebsd].
|
|
||||||
|
|
||||||
As of April 2021, releases 11 and 12 are under security support.
|
Telegraf will support the latest generally supported versions of major linux
|
||||||
|
distributions. This does not include extended supported releases where customers
|
||||||
|
can pay for additional support.
|
||||||
|
|
||||||
[freebsd-history]: https://www.freebsd.org/security/#sup
|
Below are some of the major distributions and the intent to support:
|
||||||
[wp-freebsd]: https://en.wikipedia.org/wiki/FreeBSD#Version_history
|
|
||||||
|
|
||||||
## Windows
|
* [Debian][]: Releases supported by security and release teams
|
||||||
|
* [Fedora][]: Releases currently supported by Fedora team
|
||||||
|
* [Red Hat Enterprise Linux][]: Releases under full support
|
||||||
|
* [Ubuntu][]: Releases, interim and LTS, releases in standard support
|
||||||
|
|
||||||
Telegraf intent: *Support current versions of Windows and Windows
|
[Debian]: https://wiki.debian.org/LTS
|
||||||
Server*
|
[Fedora]: https://fedoraproject.org/wiki/Releases
|
||||||
|
[Red Hat Enterprise Linux]: https://access.redhat.com/support/policy/updates/errata#Life_Cycle_Dates
|
||||||
Microsoft has two release channels, the semi-annual channel (SAC) and
|
[Ubuntu]: https://ubuntu.com/about/release-cycle
|
||||||
the long-term servicing channel (LTSC). The semi-annual channel is for
|
|
||||||
mainstream feature releases.
|
|
||||||
|
|
||||||
Microsoft publishes [lifecycle policy by release][ms-lifecycle] and a
|
|
||||||
[product lifecycle faq][ms-lifecycle-faq].
|
|
||||||
|
|
||||||
[ms-lifecycle]: https://docs.microsoft.com/en-us/lifecycle/products/?terms=windows
|
|
||||||
[ms-lifecycle-faq]: https://docs.microsoft.com/en-us/lifecycle/faq/windows
|
|
||||||
|
|
||||||
### Windows 10
|
|
||||||
|
|
||||||
Windows 10 makes SAC releases twice a year and supports those releases
|
|
||||||
for [18 or 30 months][w10-timeline]. They also make LTSC releases
|
|
||||||
which are supported for 10 years but are intended only for medical or
|
|
||||||
industrial devices that require a static feature set.
|
|
||||||
|
|
||||||
Telegraf intent: *Support semi-annual channel releases supported by
|
|
||||||
Microsoft*
|
|
||||||
|
|
||||||
Microsoft publishes Windows 10 [release information][w10-history], and
|
|
||||||
[servicing channels][w10-channels]. Wikipedia has a [summary
|
|
||||||
table][wp-w10] of support status.
|
|
||||||
|
|
||||||
As of April 2021, versions 19H2, 20H1, and 20H2 are supported.
|
|
||||||
|
|
||||||
[w10-timeline]: https://docs.microsoft.com/en-us/lifecycle/faq/windows#what-is-the-servicing-timeline-for-a-version-feature-update-of-windows-10
|
|
||||||
[w10-history]: https://docs.microsoft.com/en-us/windows/release-health/release-information
|
|
||||||
[w10-channels]: https://docs.microsoft.com/en-us/windows/deployment/update/get-started-updates-channels-tools
|
|
||||||
[wp-w10]: https://en.wikipedia.org/wiki/Windows_10_version_history#Channels
|
|
||||||
|
|
||||||
### Windows Server
|
|
||||||
|
|
||||||
Windows Server makes SAC releases for that are supported for 18 months
|
|
||||||
and LTSC releases that are supported for five years under mainstream
|
|
||||||
support and five more years under extended support.
|
|
||||||
|
|
||||||
Telegraf intent: *Support current semi-annual channel releases
|
|
||||||
supported by Microsoft and long-term releases under mainstream
|
|
||||||
support*
|
|
||||||
|
|
||||||
Microsoft publishes Windows Server [release information][ws-history]
|
|
||||||
and [servicing channels][ws-channels].
|
|
||||||
|
|
||||||
As of April 2021, Server 2016 (version 1607) and Server 2019 (version
|
|
||||||
1809) are LTSC releases under mainstream support and versions 1909,
|
|
||||||
2004, and 20H2 are supported SAC releases.
|
|
||||||
|
|
||||||
[ws-history]: https://docs.microsoft.com/en-us/windows-server/get-started/windows-server-release-info
|
|
||||||
[ws-channels]: https://docs.microsoft.com/en-us/windows-server/get-started-19/servicing-channels-19
|
|
||||||
|
|
||||||
## macOS
|
## macOS
|
||||||
|
|
||||||
MacOS makes one major release a year and provides support for each
|
Telegraf supports releases supported by Apple. Release history is available from
|
||||||
release for three years.
|
[wikipedia][wp-macos].
|
||||||
|
|
||||||
Telegraf intent: *Support releases supported by Apple*
|
[wp-macos]: https://endoflife.date/macos
|
||||||
|
|
||||||
Release history is available from [wikipedia][wp-macos].
|
## Microsoft Windows
|
||||||
|
|
||||||
As of April 2021, 10.14, 10.15, and 11 are supported.
|
Telegraf intends to support current versions of [Windows][] and
|
||||||
|
[Windows Server][]. The release must be under mainstream or generally supported
|
||||||
|
and not under any paid or extended security support.
|
||||||
|
|
||||||
[wp-macos]: https://en.wikipedia.org/wiki/MacOS#Release_history
|
[Windows]: https://learn.microsoft.com/en-us/lifecycle/faq/windows
|
||||||
|
[Windows Server]: https://learn.microsoft.com/en-us/windows-server/get-started/windows-server-release-info
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue