Updated all Linux distros, macOS and Docker (#15532)
* Updated all Linux distros, macOS and Docker * Updated Docker deployment options and added Kubernetes * Only Intel Based macs supported * Windows deployment added
Satyadeep Ashwathnarayana committed
Jul 26, 2023 at 01:31 UTC
f3a51f62e02d150c438f5f19315716205b7f5eb8
1 file changed
+485
-3
integrations/deploy.yaml
+485
-3
@@ -5,7 +5,7 @@
5
link: ''
6
categories:
7
- deploy.operating-systems
8
- icon_filename: ''
8
+ icon_filename: 'linux.png'
9
keywords:
10
- linux
11
description: 'Run the following command on your node to install and claim Netdata:"r'
@@ -31,7 +31,7 @@
31
curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh
32
--stable-channel --claim-token {% claim_token %} --claim-url {% claim_url %}
33
additional_info: &ref_containers >
34
- Did you know you can also deploy Netdata on your OS using Kubernetes or Docker?
34
+ Did you know you can also deploy Netdata on your OS using {% goToCategory categoryId="deploy.docker-kubernetes" %}Kubernetes{% /goToCategory %} or {% goToCategory categoryId="deploy.docker-kubernetes" %}Docker{% /goToCategory %}?
35
related_resources: {}
36
platform_info:
37
group: ''
@@ -43,8 +43,490 @@
43
<<: *linux_meta
44
name: Ubuntu
45
link: https://ubuntu.com/
46
- icon: ''
46
+ icon: 'ubuntu.png'
47
platform_info:
48
group: 'include'
49
distro: 'ubuntu'
50
quick_start: -1
51
+- <<: *linux
52
+ id: deploy-debian
53
+ meta:
54
+ <<: *linux_meta
55
+ name: Debian
56
+ link: https://www.debian.org/
57
+ icon: 'debian.png'
58
+ platform_info:
59
+ group: 'include'
60
+ distro: 'debian'
61
+ quick_start: -1
62
+- <<: *linux
63
+ id: deploy-fedora
64
+ meta:
65
+ <<: *linux_meta
66
+ name: Fedora
67
+ link: https://www.fedoraproject.org/
68
+ icon: 'fedora.png'
69
+ platform_info:
70
+ group: 'include'
71
+ distro: 'fedora'
72
+ quick_start: -1
73
+- <<: *linux
74
+ id: deploy-rhel
75
+ meta:
76
+ <<: *linux_meta
77
+ name: Red Hat Enterprise Linux
78
+ link: https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux
79
+ icon: 'rhel.png'
80
+ platform_info:
81
+ group: 'include'
82
+ distro: 'rhel'
83
+ quick_start: -1
84
+- <<: *linux
85
+ id: deploy-almalinux
86
+ meta:
87
+ <<: *linux_meta
88
+ name: Alma Linux
89
+ link: https://almalinux.org/
90
+ icon: 'alma.png'
91
+ platform_info:
92
+ group: 'include'
93
+ distro: 'almalinux'
94
+ quick_start: -1
95
+- <<: *linux
96
+ id: deploy-alpinelinux
97
+ meta:
98
+ <<: *linux_meta
99
+ name: Alpine Linux
100
+ link: https://www.alpinelinux.org/
101
+ icon: 'alpine.png'
102
+ platform_info:
103
+ group: 'include'
104
+ distro: 'alpinelinux'
105
+ quick_start: -1
106
+- <<: *linux
107
+ id: deploy-amazonlinux
108
+ meta:
109
+ <<: *linux_meta
110
+ name: Amazon Linux
111
+ link: https://aws.amazon.com/amazon-linux-2/
112
+ icon: 'amazonlinux.png'
113
+ platform_info:
114
+ group: 'include'
115
+ distro: 'amazonlinux'
116
+ quick_start: -1
117
+- <<: *linux
118
+ id: deploy-archlinux
119
+ meta:
120
+ <<: *linux_meta
121
+ name: Arch Linux
122
+ link: https://archlinux.org/
123
+ icon: 'archlinux.png'
124
+ platform_info:
125
+ group: 'include'
126
+ distro: 'archlinux'
127
+ quick_start: -1
128
+- <<: *linux
129
+ id: deploy-centos
130
+ meta:
131
+ <<: *linux_meta
132
+ name: CentOS
133
+ link: https://www.centos.org/
134
+ icon: 'centos.png'
135
+ platform_info:
136
+ group: 'include'
137
+ distro: 'centos'
138
+ quick_start: -1
139
+- <<: *linux
140
+ id: deploy-manjarolinux
141
+ meta:
142
+ <<: *linux_meta
143
+ name: Manjaro Linux
144
+ link: https://manjaro.org/
145
+ icon: 'manjaro.png'
146
+ platform_info:
147
+ group: 'include'
148
+ distro: 'archlinux'
149
+ quick_start: -1
150
+- <<: *linux
151
+ id: deploy-oraclelinux
152
+ meta:
153
+ <<: *linux_meta
154
+ name: Oracle Linux
155
+ link: https://www.oracle.com/linux/
156
+ icon: 'oraclelinux.png'
157
+ platform_info:
158
+ group: 'include'
159
+ distro: 'oraclelinux'
160
+ quick_start: -1
161
+- <<: *linux
162
+ id: deploy-opensuse
163
+ meta:
164
+ <<: *linux_meta
165
+ name: SUSE Linux
166
+ link: https://www.suse.com/
167
+ icon: 'openSUSE.png'
168
+ group: 'include'
169
+ distro: 'opensuse'
170
+ quick_start: -1
171
+-
172
+ id: deploy-macos
173
+ meta:
174
+ name: MacOS
175
+ link: ''
176
+ categories:
177
+ - deploy.operating-systems
178
+ icon_filename: ''
179
+ keywords:
180
+ - MacOS
181
+ - mac
182
+ description: 'Run the following command on your Intel based OSX, macOS servers to install and claim Netdata:"r'
183
+ methods:
184
+ - method: curl
185
+ commands:
186
+ - channel: nightly
187
+ command: >
188
+ curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh
189
+ --nightly-channel --claim-token {% claim_token %} --claim-url {% claim_url %}
190
+ - channel: stable
191
+ command: >
192
+ curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh
193
+ --stable-channel --claim-token {% claim_token %} --claim-url {% claim_url %}
194
+ additional_info: &ref_containers >
195
+ Did you know you can also deploy Netdata on your OS using {% goToCategory categoryId="deploy.docker-kubernetes" %}Kubernetes{% /goToCategory %} or {% goToCategory categoryId="deploy.docker-kubernetes" %}Docker{% /goToCategory %}?
196
+ related_resources: {}
197
+ platform_info:
198
+ group: 'include'
199
+ distro: 'macos'
200
+ quick_start: 1
201
+-
202
+ id: deploy-docker
203
+ meta:
204
+ name: Docker
205
+ link: ''
206
+ categories:
207
+ - deploy.docker-kubernetes
208
+ icon_filename: 'docker.png'
209
+ keywords:
210
+ - docker
211
+ - container
212
+ - containers
213
+ description: |
214
+ Install and connect new Docker containers
215
+ Find the commands for `docker run`, `docker compose` or `Docker Swarm`. On the last two you can copy the configs, then run `docker-compose up -d` in the same directory as the `docker-compose.yml`
216
+ ```
217
+ Netdata container requires different privileges and mounts to provide functionality similar to that provided by Netdata installed on the host. More info [here](https://learn.netdata.cloud/docs/installing/docker?_gl=1*f2xcnf*_ga*MTI1MTUwMzU0OS4xNjg2NjM1MDA1*_ga_J69Z2JCTFB*MTY5MDMxMDIyMS40MS4xLjE2OTAzMTAzNjkuNTguMC4w#create-a-new-netdata-agent-container)
218
+ Netdata will use the hostname from the container in which it is run instead of that of the host system. To change the default hostname check [here](https://learn.netdata.cloud/docs/agent/packaging/docker?_gl=1*i5weve*_ga*MTI1MTUwMzU0OS4xNjg2NjM1MDA1*_ga_J69Z2JCTFB*MTY5MDMxMjM4Ny40Mi4xLjE2OTAzMTIzOTAuNTcuMC4w#change-the-default-hostname)
219
+ ```
220
+ methods:
221
+ - method: Docker CLI
222
+ commands:
223
+ - channel: nightly
224
+ command: |
225
+ docker run -d --name=netdata \
226
+ --pid=host \
227
+ --network=host \
228
+ -v netdataconfig:/etc/netdata \
229
+ -v netdatalib:/var/lib/netdata \
230
+ -v netdatacache:/var/cache/netdata \
231
+ -v /etc/passwd:/host/etc/passwd:ro \
232
+ -v /etc/group:/host/etc/group:ro \
233
+ -v /proc:/host/proc:ro \
234
+ -v /sys:/host/sys:ro \
235
+ -v /etc/os-release:/host/etc/os-release:ro \
236
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
237
+ --restart unless-stopped \
238
+ --cap-add SYS_PTRACE \
239
+ --cap-add SYS_ADMIN \
240
+ --security-opt apparmor=unconfined \
241
+ netdata/netdata:edge \
242
+ -e NETDATA_CLAIM_TOKEN= {% claim_token %} \
243
+ -e NETDATA_CLAIM_URL={% claim_url %}
244
+ - channel: stable
245
+ command: |
246
+ docker run -d --name=netdata \
247
+ --pid=host \
248
+ --network=host \
249
+ -v netdataconfig:/etc/netdata \
250
+ -v netdatalib:/var/lib/netdata \
251
+ -v netdatacache:/var/cache/netdata \
252
+ -v /etc/passwd:/host/etc/passwd:ro \
253
+ -v /etc/group:/host/etc/group:ro \
254
+ -v /proc:/host/proc:ro \
255
+ -v /sys:/host/sys:ro \
256
+ -v /etc/os-release:/host/etc/os-release:ro \
257
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
258
+ --restart unless-stopped \
259
+ --cap-add SYS_PTRACE \
260
+ --cap-add SYS_ADMIN \
261
+ --security-opt apparmor=unconfined \
262
+ netdata/netdata:stable \
263
+ -e NETDATA_CLAIM_TOKEN= {% claim_token %} \
264
+ -e NETDATA_CLAIM_URL={% claim_url %}
265
+ - method: Docker Compose
266
+ commands:
267
+ - channel: nightly
268
+ command: |
269
+ version: '3'
270
+ services:
271
+ netdata:
272
+ image: netdata/netdata:edge
273
+ container_name: netdata
274
+ pid: host
275
+ network_mode: host
276
+ restart: unless-stopped
277
+ cap_add:
278
+ - SYS_PTRACE
279
+ - SYS_ADMIN
280
+ security_opt:
281
+ - apparmor:unconfined
282
+ volumes:
283
+ - netdataconfig:/etc/netdata
284
+ - netdatalib:/var/lib/netdata
285
+ - netdatacache:/var/cache/netdata
286
+ - /etc/passwd:/host/etc/passwd:ro
287
+ - /etc/group:/host/etc/group:ro
288
+ - /proc:/host/proc:ro
289
+ - /sys:/host/sys:ro
290
+ - /etc/os-release:/host/etc/os-release:ro
291
+ - /var/run/docker.sock:/var/run/docker.sock:ro
292
+ environment:
293
+ - NETDATA_CLAIM_TOKEN={% claim_token %}
294
+ - NETDATA_CLAIM_URL={% claim_url %}
295
+ - NETDATA_CLAIM_ROOMS=
296
+ volumes:
297
+ netdataconfig:
298
+ netdatalib:
299
+ netdatacache:
300
+ - channel: stable
301
+ command: |
302
+ version: '3'
303
+ services:
304
+ netdata:
305
+ image: netdata/netdata:stable
306
+ container_name: netdata
307
+ pid: host
308
+ network_mode: host
309
+ restart: unless-stopped
310
+ cap_add:
311
+ - SYS_PTRACE
312
+ - SYS_ADMIN
313
+ security_opt:
314
+ - apparmor:unconfined
315
+ volumes:
316
+ - netdataconfig:/etc/netdata
317
+ - netdatalib:/var/lib/netdata
318
+ - netdatacache:/var/cache/netdata
319
+ - /etc/passwd:/host/etc/passwd:ro
320
+ - /etc/group:/host/etc/group:ro
321
+ - /proc:/host/proc:ro
322
+ - /sys:/host/sys:ro
323
+ - /etc/os-release:/host/etc/os-release:ro
324
+ - /var/run/docker.sock:/var/run/docker.sock:ro
325
+ environment:
326
+ - NETDATA_CLAIM_TOKEN={% claim_token %}
327
+ - NETDATA_CLAIM_URL={% claim_url %}
328
+ - NETDATA_CLAIM_ROOMS=
329
+ volumes:
330
+ netdataconfig:
331
+ netdatalib:
332
+ netdatacache:
333
+ - method: Docker Swarm
334
+ commands:
335
+ - channel: nightly
336
+ command: |
337
+ version: '3'
338
+ services:
339
+ netdata:
340
+ image: netdata/netdata:edge
341
+ container_name: netdata
342
+ ports:
343
+ - 19999:19999
344
+ restart: unless-stopped
345
+ cap_add:
346
+ - SYS_PTRACE
347
+ security_opt:
348
+ - apparmor:unconfined
349
+ volumes:
350
+ - netdataconfig:/etc/netdata
351
+ - netdatalib:/var/lib/netdata
352
+ - netdatacache:/var/cache/netdata
353
+ - /etc/passwd:/host/etc/passwd:ro
354
+ - /etc/group:/host/etc/group:ro
355
+ - /proc:/host/proc:ro
356
+ - /sys:/host/sys:ro
357
+ - /etc/os-release:/host/etc/os-release:ro
358
+ - /etc/hostname:/etc/hostname:ro
359
+ environment:
360
+ - NETDATA_CLAIM_TOKEN={% claim_token %}
361
+ - NETDATA_CLAIM_URL={% claim_url %}
362
+ - NETDATA_CLAIM_ROOMS=
363
+ deploy:
364
+ mode: global
365
+
366
+ volumes:
367
+ netdataconfig:
368
+ netdatalib:
369
+ netdatacache:
370
+ - channel: stable
371
+ command: |
372
+ version: '3'
373
+ services:
374
+ netdata:
375
+ image: netdata/netdata:stable
376
+ container_name: netdata
377
+ ports:
378
+ - 19999:19999
379
+ restart: unless-stopped
380
+ cap_add:
381
+ - SYS_PTRACE
382
+ security_opt:
383
+ - apparmor:unconfined
384
+ volumes:
385
+ - netdataconfig:/etc/netdata
386
+ - netdatalib:/var/lib/netdata
387
+ - netdatacache:/var/cache/netdata
388
+ - /etc/passwd:/host/etc/passwd:ro
389
+ - /etc/group:/host/etc/group:ro
390
+ - /proc:/host/proc:ro
391
+ - /sys:/host/sys:ro
392
+ - /etc/os-release:/host/etc/os-release:ro
393
+ - /etc/hostname:/etc/hostname:ro
394
+ environment:
395
+ - NETDATA_CLAIM_TOKEN={% claim_token %}
396
+ - NETDATA_CLAIM_URL={% claim_url %}
397
+ - NETDATA_CLAIM_ROOMS=
398
+ deploy:
399
+ mode: global
400
+
401
+ volumes:
402
+ netdataconfig:
403
+ netdatalib:
404
+ netdatacache:
405
+ additional_info: ''
406
+ related_resources: {}
407
+ platform_info:
408
+ group: 'no_include'
409
+ distro: 'docker'
410
+ quick_start: 1
411
+-
412
+ id: deploy-kubernetes
413
+ meta:
414
+ name: Kubernetes
415
+ link: ''
416
+ categories:
417
+ - deploy.docker-kubernetes
418
+ icon_filename: 'kubernetes.png'
419
+ keywords:
420
+ - kubernetes
421
+ - container
422
+ - Orchestrator
423
+ description: |
424
+ **Use helm install to install Netdata on your Kubernetes cluster**
425
+ For a new installation use `helm install`` or for existing clusters add the content below to your `override.yamland`` then run `helm upgrade -f override.yml netdata netdata/netdata`
426
+ methods:
427
+ - method: Helm
428
+ commands:
429
+ - channel: nightly
430
+ command: |
431
+ helm install netdata netdata/netdata \
432
+ --set image.tag=latest \
433
+ --set parent.claiming.enabled="true" \
434
+ --set parent.claiming.token={% claim_token %} \
435
+ --set child.claiming.enabled="true" \
436
+ --set child.claiming.token={% claim_token %}
437
+ - channel: stable
438
+ command: |
439
+ helm install netdata netdata/netdata \
440
+ --set image.tag=stable \
441
+ --set parent.claiming.enabled="true" \
442
+ --set parent.claiming.token={% claim_token %} \
443
+ --set child.claiming.enabled="true" \
444
+ --set child.claiming.token={% claim_token %}
445
+ - method: Existing Cluster
446
+ commands:
447
+ - channel: nightly
448
+ command: |
449
+ image:
450
+ tag: latest
451
+
452
+ restarter:
453
+ enabled: true
454
+
455
+ parent:
456
+ claiming:
457
+ enabled: true
458
+ token: {% claim_token %}
459
+ rooms:
460
+
461
+ child:
462
+ claiming:
463
+ enabled: true
464
+ token: {% claim_token %}
465
+ rooms:
466
+ - channel: stable
467
+ command: |
468
+ image:
469
+ tag: stable
470
+
471
+ restarter:
472
+ enabled: true
473
+
474
+ parent:
475
+ claiming:
476
+ enabled: true
477
+ token: {% claim_token %}
478
+ rooms:
479
+
480
+ child:
481
+ claiming:
482
+ enabled: true
483
+ token: {% claim_token %}
484
+ rooms:
485
+ additional_info: ''
486
+ related_resources: {}
487
+ platform_info:
488
+ group: ''
489
+ distro: ''
490
+ quick_start: 1
491
+-
492
+ id: deploy-windows
493
+ meta:
494
+ name: Windows
495
+ link: ''
496
+ categories:
497
+ - deploy.operating-systems
498
+ icon_filename: 'windows.png'
499
+ keywords:
500
+ - windows
501
+ description: |
502
+ 1. Install [Windows Exporter](https://github.com/prometheus-community/windows_exporter) on every Windows host you want to monitor.
503
+ 2. Install Netdata agent on Linux, FreeBSD or Mac.
504
+ 3. Configure Netdata to collect data remotely from your Windows hosts by adding one job per host to windows.conf file. See the [configuration section](https://learn.netdata.cloud/docs/data-collection/monitor-anything/System%20Metrics/Windows-machines#configuration) for details.
505
+ 4. Enable virtual nodes configuration so the windows nodes are displayed as separate nodes.
506
+ methods:
507
+ - method: wget
508
+ commands:
509
+ - channel: nightly
510
+ command: >
511
+ wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh
512
+ --nightly-channel --claim-token {% claim_token %} --claim-url {% claim_url %}
513
+ - channel: stable
514
+ command: >
515
+ wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh
516
+ --stable-channel --claim-token {% claim_token %} --claim-url {% claim_url %}
517
+ - method: curl
518
+ commands:
519
+ - channel: nightly
520
+ command: >
521
+ curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh
522
+ --nightly-channel --claim-token {% claim_token %} --claim-url {% claim_url %}
523
+ - channel: stable
524
+ command: >
525
+ curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh
526
+ --stable-channel --claim-token {% claim_token %} --claim-url {% claim_url %}
527
+ additional_info: ''
528
+ related_resources: {}
529
+ platform_info:
530
+ group: ''
531
+ distro: ''
532
+ quick_start: 1