From 2ccd6589a2f44a179d979128887a6767fba29e76 Mon Sep 17 00:00:00 2001 From: Lynette Miles Date: Thu, 25 Sep 2025 10:30:07 -0700 Subject: [PATCH 1/2] Abstracting duplicated info Signed-off-by: Lynette Miles --- installation/downloads/linux/alma-rocky.md | 14 ++----- installation/downloads/linux/amazon-linux.md | 34 ++-------------- installation/downloads/linux/debian.md | 37 +++--------------- .../downloads/linux/raspbian-raspberry-pi.md | 27 +++---------- installation/downloads/linux/redhat-centos.md | 33 ++-------------- installation/downloads/linux/ubuntu.md | 39 ++++--------------- 6 files changed, 27 insertions(+), 157 deletions(-) diff --git a/installation/downloads/linux/alma-rocky.md b/installation/downloads/linux/alma-rocky.md index df127b20c..a184546c4 100644 --- a/installation/downloads/linux/alma-rocky.md +++ b/installation/downloads/linux/alma-rocky.md @@ -8,16 +8,6 @@ Fluent Bit supports the following architectures: - `aarch64` - `arm64v8` -## Single line install - -Fluent Bit provides an installation script to use for most Linux targets. This will always install the most recently released version. - -```shell -curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh -``` - -This is a convenience helper and should always be validated prior to use. Older versions of this install script won't support auto-detecting Rocky or Alma Linux. The recommended secure deployment approach is to use the following instructions: - ## RHEL 9 From CentOS 9 Stream and later, the CentOS dependencies will update more often than @@ -74,4 +64,6 @@ $ systemctl status fluent-bit ... ``` -The default Fluent Bit configuration collect metrics of CPU usage and sends the records to the standard output. You can see the outgoing data in your `/var/log/messages` file. \ No newline at end of file +The default Fluent Bit configuration collect metrics of CPU usage and sends the +records to the standard output. You can see the outgoing data in your +`/var/log/messages` file. diff --git a/installation/downloads/linux/amazon-linux.md b/installation/downloads/linux/amazon-linux.md index 6e436a061..acadf9e74 100644 --- a/installation/downloads/linux/amazon-linux.md +++ b/installation/downloads/linux/amazon-linux.md @@ -9,15 +9,7 @@ Fluent Bit is distributed as the `fluent-bit` package and is available for the l Amazon Linux 2022 is no longer supported. -## Single line install - -Fluent Bit provides an installation script to use for most Linux targets. This will always install the most recently released version. - -```shell -curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh -``` - -This is a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to use the following instructions: +The recommended secure deployment approach is to use the following instructions: ## Configure YUM @@ -47,29 +39,9 @@ The `fluent-bit` is provided through a Yum repository. To add the repository ref You should always enable `gpgcheck` for security reasons. All Fluent Bit packages are signed. -### Updated key from March 2022 - -For the 1.9.0 and 1.8.15 and later releases, the [GPG key has been updated](https://packages.fluentbit.io/fluentbit.key). 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) -``` - -The previous key is [still available](https://packages.fluentbit.io/fluentbit-legacy.key) and might 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. - ### Install +1. Ensure your [GPG key](../linux.md#gpg-key-updates) is up to date. 1. After your repository is configured, run the following command to install it: ```shell @@ -96,4 +68,4 @@ $ systemctl status fluent-bit ... ``` -The default Fluent Bit configuration collect metrics of CPU usage and sends the records to the standard output. You can see the outgoing data in your `/var/log/messages` file. \ No newline at end of file +The default Fluent Bit configuration collect metrics of CPU usage and sends the records to the standard output. You can see the outgoing data in your `/var/log/messages` file. diff --git a/installation/downloads/linux/debian.md b/installation/downloads/linux/debian.md index b8a9b775a..3e37539c6 100644 --- a/installation/downloads/linux/debian.md +++ b/installation/downloads/linux/debian.md @@ -8,15 +8,7 @@ The following architectures are supported - `aarch64` - `arm64v8` -## Single line install - -Fluent Bit provides an installation script to use for most Linux targets. This will always install the most recently released version. - -```shell -curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh -``` - -This is a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to use the following instructions: +The recommended secure deployment approach is to use the following instructions: ## Server GPG key @@ -28,27 +20,6 @@ Follow the official [Debian wiki guidance](https://wiki.debian.org/DebianReposit sudo sh -c 'curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg' ``` -### Updated key from March 2022 - -For the 1.9.0 and 1.8.15 and later releases, the [GPG key has been updated](https://packages.fluentbit.io/fluentbit.key). 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) -``` - -The previous key is [still available](https://packages.fluentbit.io/fluentbit-legacy.key) and might 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 For Debian, you must add the Fluent Bit APT server entry to your sources lists. @@ -80,6 +51,8 @@ Fluent Bit recommends upgrading your system (`sudo apt-get upgrade`). This could ## Install Fluent Bit +1. Ensure your [GPG key](../linux.md#gpg-key-updates) is up to date. + 1. Use the following `apt-get` command to install the latest Fluent Bit: ```shell @@ -109,4 +82,6 @@ $ sudo service fluent-bit status ... ``` -The default Fluent Bit configuration collect metrics of CPU usage and sends the records to the standard output. You can see the outgoing data in your `/var/log/messages` file. \ No newline at end of file +The default Fluent Bit configuration collect metrics of CPU usage and sends the +records to the standard output. You can see the outgoing data in your +`/var/log/messages` file. diff --git a/installation/downloads/linux/raspbian-raspberry-pi.md b/installation/downloads/linux/raspbian-raspberry-pi.md index cfa999827..7ab60c128 100644 --- a/installation/downloads/linux/raspbian-raspberry-pi.md +++ b/installation/downloads/linux/raspbian-raspberry-pi.md @@ -14,27 +14,6 @@ The first step is to add the Fluent Bit server GPG key to your keyring so you ca sudo sh -c 'curl https://packages.fluentbit.io/fluentbit.key | sudo apt-key add - ' ``` -### Updated key from March 2022 - -For the 1.9.0 and 1.8.15 and later releases, the [GPG key has been updated](https://packages.fluentbit.io/fluentbit.key). 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) -``` - -The previous key is [still available](https://packages.fluentbit.io/fluentbit-legacy.key) and might 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 the Fluent Bit APT server entry to your sources lists. @@ -75,6 +54,8 @@ Fluent Bit recommends upgrading your system (`sudo apt-get upgrade`) to avoid po ## Install Fluent Bit +1. Ensure your [GPG key](../linux.md#gpg-key-updates) is up to date. + 1. Use the following `apt-get` command to install the latest Fluent Bit: ```shell @@ -104,4 +85,6 @@ $ sudo service fluent-bit status ... ``` -The default configuration of Fluent Bit collects metrics for CPU usage and sends the records to the standard output. You can see the outgoing data in your `/var/log/syslog` file. \ No newline at end of file +The default configuration of Fluent Bit collects metrics for CPU usage and sends the +records to the standard output. You can see the outgoing data in your +`/var/log/syslog` file. diff --git a/installation/downloads/linux/redhat-centos.md b/installation/downloads/linux/redhat-centos.md index 3501218f4..afe279e8c 100644 --- a/installation/downloads/linux/redhat-centos.md +++ b/installation/downloads/linux/redhat-centos.md @@ -10,15 +10,7 @@ Fluent Bit supports the following architectures: For CentOS 9 and later, Fluent Bit uses [CentOS Stream](https://www.centos.org/centos-stream/) as the canonical base system. -## Single line install - -Fluent Bit provides an installation script to use for most Linux targets. This will always install the most recently released version. - -```shell -curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh -``` - -This is a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to use the following instructions: +The recommended secure deployment approach is to use the following instructions: ## CentOS 8 @@ -60,29 +52,10 @@ The`fluent-bit` package is provided through a Yum repository. To add the reposit 1. As a best practice, enable `gpgcheck` and `repo_gpgcheck` for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages. -### Updated key from March 2022 - -For the 1.9.0 and 1.8.15 and later releases, the [GPG key has been updated](https://packages.fluentbit.io/fluentbit.key). 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) -``` - -The previous key is [still available](https://packages.fluentbit.io/fluentbit-legacy.key) and might 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. - ### Install +1. Ensure your [GPG key](../linux.md#gpg-key-updates) is up to date. + 1. After your repository is configured, run the following command to install it: ```shell diff --git a/installation/downloads/linux/ubuntu.md b/installation/downloads/linux/ubuntu.md index 28a49011e..4a2f52205 100644 --- a/installation/downloads/linux/ubuntu.md +++ b/installation/downloads/linux/ubuntu.md @@ -2,19 +2,11 @@ Fluent Bit is distributed as the `fluent-bit` package and is available for long-term support releases of Ubuntu. The latest officially supported version is Noble Numbat (24.04). -## Single line install - -An installation script is provided for most Linux targets. This will always install the most recent version released. - -```shell -curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh -``` - -This is purely a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to use the following instructions. +The recommended secure deployment approach is to use the following instructions. ## Server GPG key -The first step is to add the Fluent Bit server GPG key to your keyring to ensure you can get the correct signed packages. +Add the Fluent Bit server GPG key to your keyring to ensure you can get the correct signed packages. Follow the official [Debian wiki guidance](https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP_Key_distribution). @@ -22,27 +14,6 @@ Follow the official [Debian wiki guidance](https://wiki.debian.org/DebianReposit sudo sh -c 'curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg' ``` -### Updated key from March 2022 - -For releases 1.9.0 and 1.8.15 and later, the [GPG key has been updated](https://packages.fluentbit.io/fluentbit.key). Ensure the new key 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) -``` - -The previous key is [still available](https://packages.fluentbit.io/fluentbit-legacy.key) and might 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 Ubuntu, you need to add the Fluent Bit APT server entry to your sources lists. @@ -80,6 +51,8 @@ If you receive the error `Certificate verification failed`, check if the package ## Install Fluent Bit +1. Ensure your [GPG key](../linux.md#gpg-key-updates) is up to date. + 1. Use the following `apt-get` command to install the latest Fluent Bit: ```shell @@ -109,4 +82,6 @@ $ systemctl status fluent-bit ... ``` -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. \ No newline at end of file +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. From 724c18bcc78cab1dc0ccd208c3202e7844404aac Mon Sep 17 00:00:00 2001 From: Lynette Miles Date: Thu, 25 Sep 2025 10:34:16 -0700 Subject: [PATCH 2/2] failed save Signed-off-by: Lynette Miles --- installation/downloads/linux.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/installation/downloads/linux.md b/installation/downloads/linux.md index ab88220ea..63a6e59d9 100644 --- a/installation/downloads/linux.md +++ b/installation/downloads/linux.md @@ -4,6 +4,8 @@ Fluent Bit is available for a variety of Linux distributions and embedded Linux The most secure option is to create the repositories according to the instructions for your specific OS. +## Single line install + An installation script is provided for use with most Linux targets. This will by default install the most recent version released. ```bash