diff --git a/SUMMARY.md b/SUMMARY.md index 6d86a49e6..2d6f3b6fd 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -34,6 +34,7 @@ * [Build with Static Configuration](installation/sources/build-with-static-configuration.md) * [Linux Packages](installation/linux/README.md) * [Amazon Linux](installation/linux/amazon-linux.md) + * [Alma / Rocky Linux](installation/linux/alma-rocky.md) * [Redhat / CentOS](installation/linux/redhat-centos.md) * [Debian](installation/linux/debian.md) * [Ubuntu](installation/linux/ubuntu.md) diff --git a/installation/linux/alma-rocky.md b/installation/linux/alma-rocky.md new file mode 100644 index 000000000..1f6fee917 --- /dev/null +++ b/installation/linux/alma-rocky.md @@ -0,0 +1,84 @@ +# Rocky Linux and Alma Linux + +Fluent Bit is distributed as the `fluent-bit` package and is available for the latest +versions of Rocky or Alma Linux now that CentOS Stream is tracking more recent dependencies. + +Fluent Bit supports the following architectures: + +- `x86_64` +- `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. + +```bash +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 will not support auto-detecting Rocky or Alma Linux. +The recommended secure deployment approach is to use the following instructions: + +## RHEL 9 + +From CentOS 9 Stream onwards, the CentOS dependencies will update more often than downstream usage. +This may mean that incompatible (more recent) versions are provided of certain dependencies (e.g. OpenSSL). +For OSS, we also provide RockyLinux and AlmaLinux repositories. +This may be required for RHEL 9 as well which will no longer track equivalent CentOS 9 stream dependencies. +No RHEL 9 build is provided, it is expected to use one of the OSS variants listed. + +## Configure Yum + +The `fluent-bit` is provided through a Yum repository. +To add the repository reference to your system: + +1. In `/etc/yum.repos.d/`, add a new file called `fluent-bit.repo`. +1. Add the following content to the file - replace `almalinux` with `rockylinux` if required: + + ```text + [fluent-bit] + name = Fluent Bit + baseurl = https://packages.fluentbit.io/almalinux/$releasever/ + gpgcheck=1 + gpgkey=https://packages.fluentbit.io/fluentbit.key + repo_gpgcheck=1 + enabled=1 + ``` + +1. As a best practice, enable `gpgcheck` and `repo_gpgcheck` for security reasons. + Fluent Bit signs its repository metadata and all Fluent Bit packages. + +## Install + +1. After your repository is configured, run the following command to install it: + + ```bash + sudo yum install fluent-bit + ``` + +1. Instruct `Systemd` to enable the service: + + ```bash + sudo systemctl start fluent-bit + ``` + +If you do a status check, you should see a similar output like this: + +```bash +$ systemctl status fluent-bit +● fluent-bit.service - Fluent Bit + Loaded: loaded (/usr/lib/systemd/system/fluent-bit.service; disabled; vendor preset: disabled) + Active: active (running) since Thu 2016-07-07 02:08:01 BST; 9s ago + Main PID: 3820 (fluent-bit) + CGroup: /system.slice/fluent-bit.service + └─3820 /opt/fluent-bit/bin/fluent-bit -c etc/fluent-bit/fluent-bit.conf +... +``` + +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/linux/redhat-centos.md b/installation/linux/redhat-centos.md index c4c5fc5b6..d1ebdd71f 100644 --- a/installation/linux/redhat-centos.md +++ b/installation/linux/redhat-centos.md @@ -37,6 +37,16 @@ sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' / An alternative is to use Rocky or Alma Linux, which should be equivalent. +## RHEL/AlmaLinux/RockyLinux and CentOS 9 Stream + +From CentOS 9 Stream onwards, the CentOS dependencies will update more often than downstream usage. +This may mean that incompatible (more recent) versions are provided of certain dependencies (e.g. OpenSSL). +For OSS, we also provide RockyLinux and AlmaLinux repositories. + +Replace the `centos` string in Yum configuration below with `almalinux` or `rockylinux` to use those repositories instead. +This may be required for RHEL 9 as well which will no longer track equivalent CentOS 9 stream dependencies. +No RHEL 9 build is provided, it is expected to use one of the OSS variants listed. + ## Configure Yum The `fluent-bit` is provided through a Yum repository. To add the repository @@ -146,3 +156,10 @@ gpgkey=https://packages.fluentbit.io/fluentbit.key repo_gpgcheck=1 enabled=1 ``` + +### Yum install fails with incompatible dependencies using CentOS 9+ + +CentOS 9 onwards will no longer be compatible with RHEL 9 as it may track more recent dependencies. +Alternative AlmaLinux and RockyLinux repositories are available. + +See the guidance above. diff --git a/installation/supported-platforms.md b/installation/supported-platforms.md index 426fc843a..c5d2b7081 100644 --- a/installation/supported-platforms.md +++ b/installation/supported-platforms.md @@ -9,10 +9,10 @@ Fluent Bit supports the following operating systems and architectures: | | [CentOS 9 Stream](linux/redhat-centos.md) | x86_64, Arm64v8 | | | [CentOS 8](linux/redhat-centos.md) | x86_64, Arm64v8 | | | [CentOS 7](linux/redhat-centos.md) | x86_64, Arm64v8 | -| | [Rocky Linux 8](linux/redhat-centos.md) | x86_64, Arm64v8 | -| | [Rocky Linux 9](linux/redhat-centos.md) | x86_64, Arm64v8 | -| | [Alma Linux 8](linux/redhat-centos.md) | x86_64, Arm64v8 | -| | [Alma Linux 9](linux/redhat-centos.md) | x86_64, Arm64v8 | +| | [Rocky Linux 8](linux/alma-rocky.md) | x86_64, Arm64v8 | +| | [Rocky Linux 9](linux/alma-rocky.md) | x86_64, Arm64v8 | +| | [Alma Linux 8](linux/alma-rocky.md) | x86_64, Arm64v8 | +| | [Alma Linux 9](linux/alma-rocky.md) | x86_64, Arm64v8 | | | [Debian 12 (Bookworm)](linux/debian.md) | x86_64, Arm64v8 | | | [Debian 11 (Bullseye)](linux/debian.md) | x86_64, Arm64v8 | | | [Debian 10 (Buster)](linux/debian.md) | x86_64, Arm64v8 |