Netdata/packaging: Add documentation for binary packages, plus draft table for distributions support (#6422)
* netdata/packaging: Python default for all * netdata/packaging: Binary Packages documentation - intro * netdata/packaging: Bring on board the distributions table and refer this to our readme * netdata/packaging: [ci skip] Add more details * netdata/packaging: move up, totally the wrong place to put it * netdata/packaging: reduce marketing * netdata/packaging: attend feedback * netdata/packaging: Documentation - add architecture * netdata/packaging: Update buildyaml.sh for the links to work * netdata/packaging: further documentation clean ups
Paul Emm. Katsoulakis committed
Jul 10, 2019 at 22:57 UTC
92057dee692fc82ee7e8ab2525bc9af620707f0b
3 files changed
+60
-4
docs/generator/buildyaml.sh
+1
@@ -138,6 +138,7 @@ echo -ne " - 'docs/Demo-Sites.md'
138
- 'packaging/installer/README.md'
139
- 'packaging/docker/README.md'
140
- 'packaging/installer/UPDATE.md'
141
+ - 'packaging/DISTRIBUTIONS.md'
142
- 'packaging/installer/UNINSTALL.md'
143
- 'docs/GettingStarted.md'
144
- Running Netdata:
packaging/DISTRIBUTIONS.md
new
+37
@@ -0,0 +1,37 @@
1
+# Netdata distribution support matrix
2
+
3
+
4
+In the following table we've listed Netdata's official supported operating systems. We detail the distributions, flavors, and the level of support Netdata is currently capable to provide.
5
+
6
+The following table is a work in progress. We have concluded on the list of distributions
7
+that we currently supporting and we are working on documenting our current state so that our users
8
+have complete visibility over the range of support.
9
+
10
+Distribution | Family | Architecture | Code health | Installer support | Kickstart support | Binary packaging support | Integrity testing (CI) | Functionality testing (CI) | Community support
11
+:------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :--------------------
12
+14.04.6 LTS (Trusty Tahr) | Ubuntu | | | | | | | |
13
+16.04.6 LTS (Xenial Xerus) | Ubuntu | | | | | | | |
14
+18.04.2 LTS (Bionic Beaver) | Ubuntu | | | | | | | |
15
+19.04 (Disco Dingo) Latest | Ubuntu | | | | | | | |
16
+Debian 7 (Wheezy) | Debian | | | | | | | |
17
+Debian 8 (Jessie) | Debian | | | | | | | |
18
+Debian 9 (Stretch) | Debian | | | | | | | |
19
+Debian 10 (Buster) | Debian | | | | | | | |
20
+Versions 6.* | RHEL | | | | | | | |
21
+Versions 7.* | RHEL | | | | | | | |
22
+Versions 8.* | RHEL | | | | | | | |
23
+Fedora 28 | Fedora | | | | | | | |
24
+Fedora 29 | Fedora | | | | | | | |
25
+Fedora 30 | Fedora | | | | | | | |
26
+Fedora 31 | Fedora | | | | | | | |
27
+CentOS 6.* | Cent OS | | | | | | | | |
28
+CentOS 7.* | Cent OS | | | | | | | | |
29
+CentOS 8.* | Cent OS | | | | | | | | |
30
+Open SuSE Leap 15.0 | Open SuSE | | | | | | | |
31
+Open SuSE Leap 15.1 | Open SuSE | | | | | | | |
32
+Open SuSE Tumbleweed (latest) | Open SuSE | | | | | | | |
33
+SuSE Enterprise Linux Server 11 | SLES | | | | | | | |
34
+SuSE Enterprise Linux Server 12 | SLES | | | | | | | |
35
+SuSE Enterprise Linux Server 15 | SLES | | | | | | | |
36
+Arch Linux (latest) | Arch | | | | | | | |
37
+All other linux | Other | | | | | | | |
packaging/installer/README.md
+22
-4
@@ -6,7 +6,6 @@ The best way to install Netdata is directly from source. Our **automatic install
6
7
!!! warning
8
You can find Netdata packages distributed by third parties. In many cases, these packages are either too old or broken. So, the suggested ways to install Netdata are the ones in this page.
9
- **We are currently working to provide our binary packages for all Linux distros.** Stay tuned...
9
10
1. [Automatic one line installation](#one-line-installation), easy installation from source, **this is the default**
11
2. [Install pre-built static binary on any 64bit Linux](#linux-64bit-pre-built-static-binary)
@@ -17,6 +16,7 @@ The best way to install Netdata is directly from source. Our **automatic install
16
7. [Enable on FreeNAS Corral](#freenas)
17
8. [Install on macOS (OS X)](#macos)
18
9. [Install on a Kubernetes cluster](https://github.com/netdata/helmchart#netdata-helm-chart-for-kubernetes-deployments)
19
+10. [Install using binary packages](#binary-packages)
20
21
See also the list of Netdata [package maintainers](../maintainers) for ASUSTOR NAS, OpenWRT, ReadyNAS, etc.
22
@@ -205,16 +205,16 @@ This is how to do it by hand:
205
206
```sh
207
# Debian / Ubuntu
208
-apt-get install zlib1g-dev uuid-dev libuv1-dev liblz4-dev libjudy-dev libssl-dev libmnl-dev gcc make git autoconf autoconf-archive autogen automake pkg-config curl
208
+apt-get install zlib1g-dev uuid-dev libuv1-dev liblz4-dev libjudy-dev libssl-dev libmnl-dev gcc make git autoconf autoconf-archive autogen automake pkg-config curl python
209
210
# Fedora
211
-dnf install zlib-devel libuuid-devel libuv-devel lz4-devel Judy-devel openssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils
211
+dnf install zlib-devel libuuid-devel libuv-devel lz4-devel Judy-devel openssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils python
212
213
# CentOS / Red Hat Enterprise Linux
214
yum install autoconf automake curl gcc git libmnl-devel libuuid-devel openssl-devel libuv-devel lz4-devel Judy-devel make nc pkgconfig python zlib-devel
215
216
# openSUSE
217
-zypper install zlib-devel libuuid-devel libuv-devel liblz4-devel judy-devel libopenssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils
217
+zypper install zlib-devel libuuid-devel libuv-devel liblz4-devel judy-devel libopenssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils python
218
219
```
220
@@ -293,6 +293,24 @@ To apply the changes you made, you have to restart Netdata.
293
294
---
295
296
+### Binary Packages
297
+
298
+
299
+We provide our own flavour of binary packages for the most common operating systems that comply with .RPM and .DEB packaging formats.
300
+
301
+We have currently released .RPM versions with version [1.16.0](https://github.com/netdata/netdata/releases/tag/v1.16.0). We are planning to release packages following the .DEB format on one of the following releases. Our current packaging infrastructure provider is [Package Cloud](https://packagecloud.io).
302
+
303
+Netdata is committed to support installation of our solution to all operating systems. This is a constant battle for Netdata, as we strive to automate and make things easier for our users. For the operating system support matrix, please visit our [distributions](../DISTRIBUTIONS.md) support page.
304
+
305
+We provide two separate repositories, one for our stable releases and one for our nightly releases.
306
+
307
+1. Stable releases: Our stable production releases are hosted in [netdata/netdata](https://packagecloud.io/netdata/netdata) repository of package cloud
308
+2. Nightly releases: Our latest releases are hosted in [netdata/netdata-edge](https://packagecloud.io/netdata/netdata-edge) repository of package cloud
309
+
310
+Visit the repository pages and follow the quick set-up instructions to get started.
311
+
312
+---
313
+
314
## Other Systems
315
316