linux: deprecation of td-agent-bit now removal (fluent#949)

Signed-off-by: Patrick Stephens <[email protected]>

Signed-off-by: Patrick Stephens <[email protected]>

Author: Pat

installation/linux/README.md

@@ -1,33 +1,38 @@
 # Linux Packages
 
+The most secure option is to create the repositories acccording to the instructions for your specific OS.
+
 A simple installation script is provided to be used for most Linux targets.
 This will always install the most recent version released.
 
 ```bash
 curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
 ```
 
-If this fails or for more details on the installation then please refer to the specific section for your OS.
+This is purely a convenience helper and should always be validated prior to use.
 
 ## GPG key updates
 
 From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at [https://packages.fluentbit.io/fluentbit.key](https://packages.fluentbit.io/fluentbit.key) so ensure this new one is added.
 
 The GPG Key fingerprint of the new key is:
-```
+
+```text
 C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
 Fluentbit releases (Releases signing key) <[email protected]>
 ```
 
 The previous key is still available at [https://packages.fluentbit.io/fluentbit-legacy.key](https://packages.fluentbit.io/fluentbit-legacy.key) and may be required to install previous versions.
 
 The GPG Key fingerprint of the old key is:
-```
+
+```text
 F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
 ```
+
 Refer to the [supported platform documentation](./../supported-platforms.md) to see which platforms are supported in each release.
+
 ## Migration to Fluent Bit
 
-From version 1.9, `td-agent-bit` is a deprecated package and will be removed in the future.
+From version 1.9, `td-agent-bit` is a deprecated package and is removed after 1.9.9.
 The correct package name to use now is `fluent-bit`.
-Both are currently provided to allow migration.

installation/linux/amazon-linux.md

@@ -9,13 +9,15 @@ Fluent Bit is distributed as **fluent-bit** package and is available for the lat
 
 ## Single line install
 
-A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.
+A simple installation script is provided to be used for most Linux targets.
+This will always install the most recent version released.
 
 ```bash
 curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
 ```
 
-If this fails or for more details on the installation then please refer to the specific sections below.
+This is purely a convenience helper and should always be validated prior to use.
+The recommended secure deployment approach is to follow the instructions below.
 
 ## Configure Yum
 

installation/linux/debian.md

@@ -4,17 +4,20 @@ Fluent Bit is distributed as **fluent-bit** package and is available for the lat
 
 ## Single line install
 
-A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.
+A simple installation script is provided to be used for most Linux targets.
+This will always install the most recent version released.
 
 ```bash
 curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
 ```
 
-If this fails or for more details on the installation then please refer to the specific sections below.
+This is purely a convenience helper and should always be validated prior to use.
+The recommended secure deployment approach is to follow the instructions below.
 
 ## Server GPG key
 
-The first step is to add our server GPG key to your keyring, on that way you can get our signed packages. Follow the official Debian wiki guidance: https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distribution
+The first step is to add our server GPG key to your keyring, on that way you can get our signed packages.
+Follow the official Debian wiki guidance: <https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distribution>
 
 ```bash
 curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg
@@ -26,7 +29,7 @@ From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated
 
 The GPG Key fingerprint of the new key is:
 
-```
+```text
 C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
 Fluentbit releases (Releases signing key) <[email protected]>
 ```
@@ -35,7 +38,7 @@ The previous key is still available at [https://packages.fluentbit.io/fluentbit-
 
 The GPG Key fingerprint of the old key is:
 
-```
+```text
 F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
 ```
 
@@ -54,7 +57,7 @@ deb [signed-by=/usr/share/keyrings/fluentbit-keyring.gpg] https://packages.fluen
 Now let your system update the _apt_ database:
 
 ```bash
-$ sudo apt-get update
+sudo apt-get update
 ```
 
 {% hint style="info" %}
@@ -65,14 +68,14 @@ We recommend upgrading your system (`sudo apt-get upgrade`). This could avoid po
 
 Using the following _apt-get_ command you are able now to install the latest _fluent-bit_:
 
-```
-$ sudo apt-get install fluent-bit
+```bash
+sudo apt-get install fluent-bit
 ```
 
 Now the following step is to instruct _systemd_ to enable the service:
 
 ```bash
-$ sudo service fluent-bit start
+sudo systemctl fluent-bit start
 ```
 
 If you do a status check, you should see a similar output like this:

installation/linux/raspbian-raspberry-pi.md

@@ -18,29 +18,33 @@ curl https://packages.fluentbit.io/fluentbit.key | sudo apt-key add -
 From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at [https://packages.fluentbit.io/fluentbit.key](https://packages.fluentbit.io/fluentbit.key) so ensure this new one is added.
 
 The GPG Key fingerprint of the new key is:
-```
+
+```text
 C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
 Fluentbit releases (Releases signing key) <[email protected]>
 ```
 
 The previous key is still available at [https://packages.fluentbit.io/fluentbit-legacy.key](https://packages.fluentbit.io/fluentbit-legacy.key) and may be required to install previous versions.
 
 The GPG Key fingerprint of the old key is:
-```
+
+```text
 F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
 ```
+
 Refer to the [supported platform documentation](./../supported-platforms.md) to see which platforms are supported in each release.
+
 ## Update your sources lists
 
 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.
 
-#### Raspbian 11 \(Bullseye\)
+### Raspbian 11 \(Bullseye\)
 
 ```text
 deb https://packages.fluentbit.io/raspbian/bullseye bullseye main
 ```
 
-#### Raspbian 10 \(Buster\)
+### Raspbian 10 \(Buster\)
 
 ```text
 deb https://packages.fluentbit.io/raspbian/buster buster main
@@ -51,26 +55,25 @@ deb https://packages.fluentbit.io/raspbian/buster buster main
 Now let your system update the _apt_ database:
 
 ```bash
-$ sudo apt-get update
+sudo apt-get update
 ```
 
 {% hint style="info" %}
 We recommend upgrading your system (```sudo apt-get upgrade```). This could avoid potential issues with expired certificates.
 {% endhint %}
 
-
 ## Install Fluent Bit
 
 Using the following _apt-get_ command you are able now to install the latest _fluent-bit_:
 
 ```text
-$ sudo apt-get install fluent-bit
+sudo apt-get install fluent-bit
 ```
 
 Now the following step is to instruct _systemd_ to enable the service:
 
 ```bash
-$ sudo service fluent-bit start
+sudo service fluent-bit start
 ```
 
 If you do a status check, you should see a similar output like this:
@@ -90,4 +93,3 @@ sudo service fluent-bit status
 ```
 
 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.
-

installation/linux/redhat-centos.md

@@ -9,21 +9,23 @@ Fluent Bit is distributed as **fluent-bit** package and is available for the lat
 
 ## Single line install
 
-A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.
+A simple installation script is provided to be used for most Linux targets.
+This will always install the most recent version released.
 
 ```bash
 curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
 ```
 
-If this fails or for more details on the installation then please refer to the specific sections below.
+This is purely a convenience helper and should always be validated prior to use.
+The recommended secure deployment approach is to follow the instructions below.
 
 ## CentOS 8
 
 CentOS 8 is now EOL so the default Yum repositories are unavailable.
 
 Make sure to configure to use an appropriate mirror, for example:
 
-```
+```shell
 $ sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && \
   sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
 ```
@@ -34,7 +36,7 @@ An alternative is to use Rocky or Alma Linux which _should_ be equivalent.
 
 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:
 
-```
+```shell
 [fluent-bit]
 name = Fluent Bit
 baseurl = https://packages.fluentbit.io/centos/$releasever/$basearch/
@@ -52,7 +54,7 @@ From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated
 
 The GPG Key fingerprint of the new key is:
 
-```
+```text
 C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
 Fluentbit releases (Releases signing key) <[email protected]>
 ```
@@ -61,7 +63,7 @@ The previous key is still available at [https://packages.fluentbit.io/fluentbit-
 
 The GPG Key fingerprint of the old key is:
 
-```
+```text
 F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
 ```
 
@@ -72,13 +74,13 @@ Refer to the [supported platform documentation](../supported-platforms.md) to se
 Once your repository is configured, run the following command to install it:
 
 ```bash
-$ yum install fluent-bit
+yum install fluent-bit
 ```
 
 Now the following step is to instruct _Systemd_ to enable the service:
 
 ```bash
-$ sudo service fluent-bit start
+sudo service fluent-bit start
 ```
 
 If you do a status check, you should see a similar output like this:
@@ -100,9 +102,10 @@ The default configuration of **fluent-bit** is collecting metrics of CPU usage a
 ## FAQ
 
 ### Yum install fails with a "404 - Page not found" error for the package mirror
+
 The fluent-bit.repo file for the latest installations of Fluent-Bit uses a $releasever variable to determine the correct version of the package to install to your system:
 
-```
+```text
 [fluent-bit]
 name = Fluent Bit
 baseurl = https://packages.fluentbit.io/centos/$releasever/$basearch/
@@ -113,7 +116,7 @@ Depending on your Red Hat distribution version, this variable may return a value
 
 In order to resolve this issue, you can replace the $releasever variable with your system's OS major release version. For example:
 
-```
+```text
 [fluent-bit]
 name = Fluent Bit
 baseurl = https://packages.fluentbit.io/centos/7/$basearch/

installation/linux/ubuntu.md

@@ -4,17 +4,20 @@ Fluent Bit is distributed as **fluent-bit** package and is available for the lat
 
 ## Single line install
 
-A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.
+A simple installation script is provided to be used for most Linux targets.
+This will always install the most recent version released.
 
 ```bash
 curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
 ```
 
-If this fails or for more details on the installation then please refer to the specific sections below.
+This is purely a convenience helper and should always be validated prior to use.
+The recommended secure deployment approach is to follow the instructions below.
 
 ## Server GPG key
 
-The first step is to add our server GPG key to your keyring to ensure you can get our signed packages. Follow the official Debian wiki guidance: https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distribution
+The first step is to add our server GPG key to your keyring to ensure you can get our signed packages.
+Follow the official Debian wiki guidance: <https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distribution>
 
 ```bash
 curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg
@@ -26,7 +29,7 @@ From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated
 
 The GPG Key fingerprint of the new key is:
 
-```
+```text
 C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
 Fluentbit releases (Releases signing key) <[email protected]>
 ```
@@ -35,7 +38,7 @@ The previous key is still available at [https://packages.fluentbit.io/fluentbit-
 
 The GPG Key fingerprint of the old key is:
 
-```
+```text
 F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
 ```
 
@@ -65,14 +68,14 @@ We recommend upgrading your system (`sudo apt-get upgrade`). This could avoid po
 
 Using the following _apt-get_ command you are able now to install the latest _fluent-bit_:
 
-```
+```text
 sudo apt-get install fluent-bit
 ```
 
 Now the following step is to instruct _systemd_ to enable the service:
 
 ```bash
-sudo service fluent-bit start
+sudo systemctl fluent-bit start
 ```
 
 If you do a status check, you should see a similar output like this:

installation/upgrade-notes.md

@@ -9,6 +9,11 @@ Note: release notes will be prepared in advance of a Git tag for a release so an
 The tag drives the overall binary release process so release binaries (containers/packages) will appear after a tag and its associated release note.
 This allows users to expect the new release binary to appear and allow/deny/update it as appropriate in their infrastructure.
 
+## Fluent Bit v1.9.9
+
+The `td-agent-bit` package is no longer provided after this release.
+Users should switch to the `fluent-bit` package.
+
 ## Fluent Bit v1.6
 
 If you are migrating from previous version of Fluent Bit please review the following important changes: