Skip to content

Commit b03dd71

Browse files
Patlecaros
andauthored
installation: update to use new one line install and other fixes (#696)
* installation: update to use new one line install and other fixes Signed-off-by: Patrick Stephens <[email protected]> * installation: minor tweak Signed-off-by: Patrick Stephens <[email protected]> * Update installation/linux/raspbian-raspberry-pi.md Co-authored-by: José Lecaros <[email protected]> * Update installation/linux/ubuntu.md Co-authored-by: José Lecaros <[email protected]> Co-authored-by: José Lecaros <[email protected]>
1 parent b38e0d6 commit b03dd71

File tree

7 files changed

+103
-111
lines changed

7 files changed

+103
-111
lines changed

installation/linux/README.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,16 @@
11
# Linux Packages
22

3+
A simple installation script is provided to be used for most Linux targets.
4+
This will always install the most recent version released.
5+
6+
```bash
7+
curl https://raw.githubusercontent.com/fluent/fluent-bit/master/update_version.sh | sh
8+
```
9+
10+
If this fails or for more details on the installation then please refer to the specific section for your OS.
11+
12+
## Migration to Fluent Bit
13+
14+
From version 1.9, `td-agent-bit` is a deprecated package and will be removed in the future.
15+
The correct package name to use now is `fluent-bit`.
16+
Both are currently provided to allow migration.

installation/linux/amazon-linux.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22

33
## Install on Amazon Linux 2
44

5-
Fluent Bit is distributed as **td-agent-bit** package and is available for the latest Amazon Linux 2. The following architectures are supported
5+
Fluent Bit is distributed as **fluent-bit** package and is available for the latest Amazon Linux 2. The following architectures are supported
66

77
* x86\_64
88
* aarch64 / arm64v8
99

1010
## Configure Yum
1111

12-
We provide **td-agent-bit** through a Yum repository. In order to add the repository reference to your system, please add a new file called _td-agent-bit.repo_ in _/etc/yum.repos.d/_ with the following content:
12+
We provide **fluent-bit** through a Yum repository. In order to add the repository reference to your system, please add a new file called _fluent-bit.repo_ in _/etc/yum.repos.d/_ with the following content:
1313

1414
```text
15-
[td-agent-bit]
16-
name = TD Agent Bit
15+
[fluent-bit]
16+
name = Fluent Bit
1717
baseurl = https://packages.fluentbit.io/amazonlinux/2/$basearch/
1818
gpgcheck=1
1919
gpgkey=https://packages.fluentbit.io/fluentbit.key
@@ -29,28 +29,28 @@ The GPG Key fingerprint is `F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A`
2929
Once your repository is configured, run the following command to install it:
3030

3131
```bash
32-
$ yum install td-agent-bit
32+
$ yum install fluent-bit
3333
```
3434

3535
Now the following step is to instruct _systemd_ to enable the service:
3636

3737
```bash
38-
$ sudo service td-agent-bit start
38+
$ sudo service fluent-bit start
3939
```
4040

4141
If you do a status check, you should see a similar output like this:
4242

4343
```bash
44-
$ service td-agent-bit status
45-
Redirecting to /bin/systemctl status td-agent-bit.service
46-
td-agent-bit.service - TD Agent Bit
47-
Loaded: loaded (/usr/lib/systemd/system/td-agent-bit.service; disabled; vendor preset: disabled)
44+
$ service fluent-bit status
45+
Redirecting to /bin/systemctl status fluent-bit.service
46+
fluent-bit.service - Fluent Bit
47+
Loaded: loaded (/usr/lib/systemd/system/fluent-bit.service; disabled; vendor preset: disabled)
4848
Active: active (running) since Thu 2016-07-07 02:08:01 BST; 9s ago
49-
Main PID: 3820 (td-agent-bit)
50-
CGroup: /system.slice/td-agent-bit.service
51-
└─3820 /opt/td-agent-bit/bin/td-agent-bit -c etc/td-agent-bit/td-agent-bit.conf
49+
Main PID: 3820 (fluent-bit)
50+
CGroup: /system.slice/fluent-bit.service
51+
└─3820 /opt/fluent-bit/bin/fluent-bit -c etc/fluent-bit/fluent-bit.conf
5252
...
5353
```
5454

55-
The default configuration of **td-agent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/messages_ file.
55+
The default configuration of **fluent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/messages_ file.
5656

installation/linux/debian.md

Lines changed: 20 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,24 @@
11
# Debian
22

3-
Fluent Bit is distributed as **td-agent-bit** package and is available for the latest \(and old\) stable Debian systems: Buster, Stretch and Jessie.
3+
Fluent Bit is distributed as **fluent-bit** package and is available for the latest \(and old\) stable Debian systems: Buster, Stretch and Jessie.
44

55
## Server GPG key
66

7-
The first step is to add our server GPG key to your keyring, on that way you can get our signed packages:
7+
The first step is to add our server GPG key to your keyring, on that way you can get our signed packages.
8+
Follow the official Debian wiki guidance: https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP_Key_distribution
89

9-
```text
10-
curl https://packages.fluentbit.io/fluentbit.key | sudo apt-key add -
10+
```bash
11+
curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg
1112
```
12-
1313
## Update your sources lists
1414

15-
On Debian, you need to add our APT server entry to your sources lists, please add the following content at bottom of your **/etc/apt/sources.list** file:
15+
On Debian, you need to add our APT server entry to your sources lists, please add the following content at bottom of your **/etc/apt/sources.list** file - ensure to set `CODENAME` to your specific [Ubuntu release name](https://wiki.ubuntu.com/Releases) (e.g. `focal` for Ubuntu 20.04):
1616

17-
#### Debian 10 \(Buster\)
18-
19-
```text
20-
deb https://packages.fluentbit.io/debian/buster buster main
21-
```
22-
23-
#### Debian 9 \(Stretch\)
24-
25-
```text
26-
deb https://packages.fluentbit.io/debian/stretch stretch main
17+
```bash
18+
deb [signed-by=/usr/share/keyrings/fluentbit-keyring.gpg] https://packages.fluentbit.io/debian/${CODENAME} ${CODENAME} main
2719
```
2820

29-
### Update your repositories database
21+
## Update your repositories database
3022

3123
Now let your system update the _apt_ database:
3224

@@ -38,36 +30,35 @@ $ sudo apt-get update
3830
We recommend upgrading your system (```sudo apt-get upgrade```). This could avoid potential issues with expired certificates.
3931
{% endhint %}
4032

33+
## Install Fluent Bit
4134

42-
## Install TD Agent Bit
43-
44-
Using the following _apt-get_ command you are able now to install the latest _td-agent-bit_:
35+
Using the following _apt-get_ command you are able now to install the latest _fluent-bit_:
4536

4637
```text
47-
$ sudo apt-get install td-agent-bit
38+
$ sudo apt-get install fluent-bit
4839
```
4940

5041
Now the following step is to instruct _systemd_ to enable the service:
5142

5243
```bash
53-
$ sudo service td-agent-bit start
44+
$ sudo service fluent-bit start
5445
```
5546

5647
If you do a status check, you should see a similar output like this:
5748

5849
```bash
59-
sudo service td-agent-bit status
60-
td-agent-bit.service - TD Agent Bit
61-
Loaded: loaded (/lib/systemd/system/td-agent-bit.service; disabled; vendor preset: enabled)
50+
sudo service fluent-bit status
51+
fluent-bit.service - Fluent Bit
52+
Loaded: loaded (/lib/systemd/system/fluent-bit.service; disabled; vendor preset: enabled)
6253
Active: active (running) since mié 2016-07-06 16:58:25 CST; 2h 45min ago
63-
Main PID: 6739 (td-agent-bit)
54+
Main PID: 6739 (fluent-bit)
6455
Tasks: 1
6556
Memory: 656.0K
6657
CPU: 1.393s
67-
CGroup: /system.slice/td-agent-bit.service
68-
└─6739 /opt/td-agent-bit/bin/td-agent-bit -c /etc/td-agent-bit/td-agent-bit.conf
58+
CGroup: /system.slice/fluent-bit.service
59+
└─6739 /opt/fluent-bit/bin/fluent-bit -c /etc/fluent-bit/fluent-bit.conf
6960
...
7061
```
7162

72-
The default configuration of **td-agent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/syslog_ file.
63+
The default configuration of **fluent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/syslog_ file.
7364

installation/linux/raspbian-raspberry-pi.md

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,9 @@
11
# Raspbian / Raspberry Pi
22

3-
Fluent Bit is distributed as **td-agent-bit** package and is available for the Raspberry, specifically for [Raspbian](http://raspbian.org) distribution, the following versions are supported:
3+
Fluent Bit is distributed as **fluent-bit** package and is available for the Raspberry, specifically for [Raspbian](http://raspbian.org) distribution, the following versions are supported:
44

5+
* Raspbian Bullseye \(11\)
56
* Raspbian Buster \(10\)
6-
* Raspbian Stretch \(9\)
7-
* Raspbian Jessie \(8\)
87

98
## Server GPG key
109

@@ -16,7 +15,13 @@ curl https://packages.fluentbit.io/fluentbit.key | sudo apt-key add -
1615

1716
## Update your sources lists
1817

19-
On Debian and derivative systems such as Raspbian, you need to add our APT server entry to your sources lists, please add the following content at bottom of your **/etc/apt/sources.list** file:
18+
On Debian and derivative systems such as Raspbian, you need to add our APT server entry to your sources lists, please add the following content at bottom of your **/etc/apt/sources.list** file.
19+
20+
#### Raspbian 11 \(Bullseye\)
21+
22+
```text
23+
deb https://packages.fluentbit.io/raspbian/bullseye bullseye main
24+
```
2025

2126
#### Raspbian 10 \(Buster\)
2227

@@ -37,35 +42,35 @@ We recommend upgrading your system (```sudo apt-get upgrade```). This could avoi
3742
{% endhint %}
3843

3944

40-
## Install TD-Agent Bit
45+
## Install Fluent Bit
4146

42-
Using the following _apt-get_ command you are able now to install the latest _td-agent-bit_:
47+
Using the following _apt-get_ command you are able now to install the latest _fluent-bit_:
4348

4449
```text
45-
$ sudo apt-get install td-agent-bit
50+
$ sudo apt-get install fluent-bit
4651
```
4752

4853
Now the following step is to instruct _systemd_ to enable the service:
4954

5055
```bash
51-
$ sudo service td-agent-bit start
56+
$ sudo service fluent-bit start
5257
```
5358

5459
If you do a status check, you should see a similar output like this:
5560

5661
```bash
57-
sudo service td-agent-bit status
58-
td-agent-bit.service - TD Agent Bit
59-
Loaded: loaded (/lib/systemd/system/td-agent-bit.service; disabled; vendor preset: enabled)
62+
sudo service fluent-bit status
63+
fluent-bit.service - Fluent Bit
64+
Loaded: loaded (/lib/systemd/system/fluent-bit.service; disabled; vendor preset: enabled)
6065
Active: active (running) since mié 2016-07-06 16:58:25 CST; 2h 45min ago
61-
Main PID: 6739 (td-agent-bit)
66+
Main PID: 6739 (fluent-bit)
6267
Tasks: 1
6368
Memory: 656.0K
6469
CPU: 1.393s
65-
CGroup: /system.slice/td-agent-bit.service
66-
└─6739 /opt/td-agent-bit/bin/td-agent-bit -c /etc/td-agent-bit/td-agent-bit.conf
70+
CGroup: /system.slice/fluent-bit.service
71+
└─6739 /opt/fluent-bit/bin/fluent-bit -c /etc/fluent-bit/fluent-bit.conf
6772
...
6873
```
6974

70-
The default configuration of **td-agent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/syslog_ file.
75+
The default configuration of **fluent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/syslog_ file.
7176

installation/linux/redhat-centos.md

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,55 +2,54 @@
22

33
## Install on Redhat / CentOS
44

5-
Fluent Bit is distributed as **td-agent-bit** package and is available for the latest stable CentOS system. The following architectures are supported
5+
Fluent Bit is distributed as **fluent-bit** package and is available for the latest stable CentOS system. The following architectures are supported
66

77
* x86\_64
88
* aarch64 / arm64v8
99

1010
## Configure Yum
1111

12-
We provide **td-agent-bit** through a Yum repository. In order to add the repository reference to your system, please add a new file called _td-agent-bit.repo_ in _/etc/yum.repos.d/_ with the following content:
12+
We provide **fluent-bit** through a Yum repository. In order to add the repository reference to your system, please add a new file called _fluent-bit.repo_ in _/etc/yum.repos.d/_ with the following content:
1313

1414
```text
15-
[td-agent-bit]
16-
name = TD Agent Bit
15+
[fluent-bit]
16+
name = Fluent Bit
1717
baseurl = https://packages.fluentbit.io/centos/7/$basearch/
1818
gpgcheck=1
1919
gpgkey=https://packages.fluentbit.io/fluentbit.key
2020
enabled=1
2121
```
2222

23-
note: we encourage you always enable the _gpgcheck_ for security reasons. All our packages are signed.
24-
25-
The GPG Key fingerprint is `F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A`
23+
It is best practice to always enable the _gpgcheck_ for security reasons.
24+
All our packages are signed.
2625

2726
### Install
2827

2928
Once your repository is configured, run the following command to install it:
3029

3130
```bash
32-
$ yum install td-agent-bit
31+
$ yum install fluent-bit
3332
```
3433

3534
Now the following step is to instruct _Systemd_ to enable the service:
3635

3736
```bash
38-
$ sudo service td-agent-bit start
37+
$ sudo service fluent-bit start
3938
```
4039

4140
If you do a status check, you should see a similar output like this:
4241

4342
```bash
44-
$ service td-agent-bit status
45-
Redirecting to /bin/systemctl status td-agent-bit.service
46-
td-agent-bit.service - TD Agent Bit
47-
Loaded: loaded (/usr/lib/systemd/system/td-agent-bit.service; disabled; vendor preset: disabled)
43+
$ service fluent-bit status
44+
Redirecting to /bin/systemctl status fluent-bit.service
45+
fluent-bit.service - Fluent Bit
46+
Loaded: loaded (/usr/lib/systemd/system/fluent-bit.service; disabled; vendor preset: disabled)
4847
Active: active (running) since Thu 2016-07-07 02:08:01 BST; 9s ago
49-
Main PID: 3820 (td-agent-bit)
50-
CGroup: /system.slice/td-agent-bit.service
51-
└─3820 /opt/td-agent-bit/bin/td-agent-bit -c etc/td-agent-bit/td-agent-bit.conf
48+
Main PID: 3820 (fluent-bit)
49+
CGroup: /system.slice/fluent-bit.service
50+
└─3820 /opt/fluent-bit/bin/fluent-bit -c etc/fluent-bit/fluent-bit.conf
5251
...
5352
```
5453

55-
The default configuration of **td-agent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/messages_ file.
54+
The default configuration of **fluent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/messages_ file.
5655

installation/linux/snap.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,8 @@
22

33
If you use any Linux distribution [supported by](https://snapcraft.io/docs/installing-snapd) Snapcraft, you can get Fluent Bit as a Snap in your system.
44

5-
6-
75
[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-white.svg)](https://snapcraft.io/fluent-bit)
86

9-
10-
117
## Getting Started
128

139
Install Fluent Bit Snap in your system

0 commit comments

Comments
 (0)