From 7eaac337a36dae1b0532f1a79ad794a203f9a0cd Mon Sep 17 00:00:00 2001 From: Dan Illescas Date: Thu, 16 Oct 2025 11:31:12 -0500 Subject: [PATCH 1/4] packaging: add opensuse and sles Signed-off-by: Dan Illescas --- SUMMARY.md | 1 + installation/downloads.md | 2 + installation/downloads/linux/suse.md | 140 ++++++++++++++++++ .../getting-started-with-fluent-bit.md | 2 + 4 files changed, 145 insertions(+) create mode 100644 installation/downloads/linux/suse.md diff --git a/SUMMARY.md b/SUMMARY.md index ac8b71a45..1663d020e 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -28,6 +28,7 @@ * [Amazon Linux](installation/downloads/linux/amazon-linux.md) * [Rocky Linux and Alma Linux ](installation/downloads/linux/alma-rocky.md) * [Red Hat and CentOS](installation/downloads/linux/redhat-centos.md) + * [openSUSE / SLES](installation/downloads/linux/suse.md) * [Debian](installation/downloads/linux/debian.md) * [Ubuntu](installation/downloads/linux/ubuntu.md) * [Raspbian and Raspberry Pi](installation/downloads/linux/raspbian-raspberry-pi.md) diff --git a/installation/downloads.md b/installation/downloads.md index da9d662d7..06fab500f 100644 --- a/installation/downloads.md +++ b/installation/downloads.md @@ -22,6 +22,8 @@ Fluent Bit supports the following operating systems and architectures: | macOS | * | x86_64, Apple M1 | | Windows | [Windows Server 2019](downloads/windows.md) | x86_64, x86 | | | [Windows 10 1903](downloads/windows.md) | x86_64, x86 | +| | [openSUSE Leap 15.6](downloads/linux/suse.md) | x86_64, Arm64v8 | +| | [SUSE Linux Enterprise Server (SLES) 15.7](downloads/linux/suse.md) | x86_64, Arm64v8 | From an architecture support perspective, Fluent Bit is fully functional on x86_64, Arm64v8, and Arm32v7 based processors. diff --git a/installation/downloads/linux/suse.md b/installation/downloads/linux/suse.md new file mode 100644 index 000000000..036e8607a --- /dev/null +++ b/installation/downloads/linux/suse.md @@ -0,0 +1,140 @@ +# openSUSE and SLES + +Fluent Bit is distributed as the `fluent-bit` package and is available for the latest stable opensuse-leap and sles 15.7 system. + +Fluent Bit supports the following architectures: + +- `x86_64` +- `aarch64` +- `arm64v8` + +For openSUSE 15, Fluent Bit uses [openSUSE Leap](https://get.opensuse.org/leap) as the canonical base system. + +The recommended secure deployment approach is to use the following instructions: + +## For openSUSE and SUSE Linux Enterprise Server (SLES) + +Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the $releasever variable to dynamically fetch packages for your specific system version. + +## Configure `zypper` + +The `fluent-bit` openSUSE package is provided through a `zypper` repository. To add the repository reference to your system: + +1. Import the GPG key used to sign the packages. +1. In `/etc/zypp/repos.d/`, add a new file named `fluent-bit.repo`. +1. Add the following content to the file. + ```text + [fluent-bit] + name = Fluent Bit + baseurl = https://packages.fluentbit.io/suse/$releasever/ + gpgcheck=1 + gpgkey=https://packages.fluentbit.io/fluentbit.key + repo_gpgcheck=1 + enabled=1 + ``` +1. Refresh the repository to make the new packages available. + ```text + sudo zypper refresh + ``` +1. As a best practice, gpgcheck and repo_gpgcheck are enabled by default for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages + +## Install + +Ensure you've configured 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-* +``` + +An alternative is to use Rocky or Alma Linux, which should be equivalent. + +## SLES + +For openSUSE and SUSE Linux Enterprise Server (SLES) + +Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the $releasever variable to dynamically fetch packages for your specific system version. + +## Configure `zypper` + +The`fluent-bit` package 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: + + ```text + [fluent-bit] + name = Fluent Bit + baseurl = https://packages.fluentbit.io/centos/$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. 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 + sudo dnf install fluent-bit + ``` + +1. Instruct `Systemd` to enable the service: + + ```shell + sudo systemctl start fluent-bit + ``` + +If you do a status check, you should see a similar output like this: + +```shell +$ 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. + +## 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/ +``` + +Depending on your Red Hat distribution version, this variable can return a value other than the OS major release version (for example, RHEL7 Server distributions return `7Server` instead of `7`). The Fluent Bit package URL uses the major OS release version, so any other value here will cause a 404. + +To resolve this issue, 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/ + gpgcheck=1 + gpgkey=https://packages.fluentbit.io/fluentbit.key + repo_gpgcheck=1 + enabled=1 +``` + +### Yum install fails with incompatible dependencies using CentOS 9+ + +CentOS 9 and later will no longer be compatible with RHEL 9 as it might track more recent dependencies. Alternative AlmaLinux and RockyLinux repositories are available. + +See the previous guidance. diff --git a/installation/getting-started-with-fluent-bit.md b/installation/getting-started-with-fluent-bit.md index 111205119..9c242a786 100644 --- a/installation/getting-started-with-fluent-bit.md +++ b/installation/getting-started-with-fluent-bit.md @@ -36,6 +36,8 @@ To select a package for a container or operating system, use the instructions fo | Alma Linux / Red Hat | [Alma Linux 8](downloads/linux/alma-rocky.md), [Alma Linux 9](downloads/linux/alma-rocky.md), [Alma Linux 10](downloads/linux/alma-rocky.md) | | CentOS / Red Hat | [CentOS 7](downloads/linux/redhat-centos.md#install-on-redhat-centos), [CentOS 8](downloads/linux/redhat-centos.md#install-on-redhat-centos), [CentOS 9 Stream](downloads/linux/redhat-centos.md#install-on-redhat-centos), [CentOS 10 Stream](downloads/linux/redhat-centos.md#install-on-redhat-centos) | | Rocky Linux / Red Hat | [Rocky Linux 8](downloads/linux/alma-rocky.md), [Rocky Linux 9](downloads/linux/alma-rocky.md), [Rocky Linux 10](downloads/linux/alma-rocky.md) | +| openSUSE Leap | [openSUSE Leap 15.6](downloads/linux/suse.md) | +| SUSE Linux Enterprise | [SUSE Linux Enterprise Server 15.7](downloads/linux/suse.md) | | Ubuntu | [Ubuntu 16.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 18.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 20.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 22.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 24.04 LTS](downloads/linux/ubuntu.md) | | Debian | [Debian 10](downloads/linux/debian.md), [Debian 11](downloads/linux/debian.md), [Debian 12](downloads/linux/debian.md), [Debian 13](downloads/linux/debian.md) | | Amazon Linux | [Amazon Linux 2](downloads/linux/amazon-linux.md#install-on-amazon-linux-2), [Amazon Linux 2023](downloads/linux/amazon-linux.md#amazon-linux-2023) | From 7dc3b5ed3c80792bdd96ea66fef3628806c3937d Mon Sep 17 00:00:00 2001 From: Dan Illescas Date: Thu, 16 Oct 2025 14:32:26 -0500 Subject: [PATCH 2/4] packaging: fix suse.md Signed-off-by: Dan Illescas --- installation/downloads/linux/suse.md | 119 +++++++++++++-------------- 1 file changed, 58 insertions(+), 61 deletions(-) diff --git a/installation/downloads/linux/suse.md b/installation/downloads/linux/suse.md index 036e8607a..a032fee44 100644 --- a/installation/downloads/linux/suse.md +++ b/installation/downloads/linux/suse.md @@ -1,6 +1,6 @@ -# openSUSE and SLES +# openSUSE and SUSE Linux Enterprise Server (SLES) -Fluent Bit is distributed as the `fluent-bit` package and is available for the latest stable opensuse-leap and sles 15.7 system. +Fluent Bit is distributed as the `fluent-bit` package and is available for OpenSUSE-Leap 15.6 and SLES 15.7 systems. Fluent Bit supports the following architectures: @@ -8,81 +8,86 @@ Fluent Bit supports the following architectures: - `aarch64` - `arm64v8` -For openSUSE 15, Fluent Bit uses [openSUSE Leap](https://get.opensuse.org/leap) as the canonical base system. +Fluent Bit supports the following distro versions: + +- opensuse/leap:15.6 +- sles/15.7 + +For openSUSE, Fluent Bit uses [openSUSE Leap Base Container Images (BCI)](https://build.opensuse.org/project/show/openSUSE:Containers:Leap) as the canonical base system. + +For SLES, Fluent Bit uses [SUSE Base Container Images (BCI)](https://www.suse.com/products/base-container-images/) as the canonical base system. The recommended secure deployment approach is to use the following instructions: -## For openSUSE and SUSE Linux Enterprise Server (SLES) +## Ensure you select the correct openSUSE verse SLES Package + +The openSUSE package is built and tested specifically for openSUSE Leap environments, ensuring compatibility with openSUSE libraries, update cycles, and system dependencies. Using the openSUSE package on openSUSE Leap systems helps avoid potential issues with mismatched dependencies or unsupported features that may arise from using SLES packages. + +The SLES package is tailored for SUSE Linux Enterprise Server and is built against the SUSE Base Container Image, which may include different versions of libraries. It uses enterprise repositories with specific package versions, while Leap uses free, community driven repositories that have a broader range of packages. Installing the SLES package on openSUSE Leap is not recommended, as it may lead to library incompatibilities. + + +**In summary:** +- Use the openSUSE package for openSUSE Leap systems. +- Use the SLES package for SUSE Linux Enterprise Server systems. -Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the $releasever variable to dynamically fetch packages for your specific system version. +This ensures you receive the correct updates and compatibility for your chosen platform. -## Configure `zypper` -The `fluent-bit` openSUSE package is provided through a `zypper` repository. To add the repository reference to your system: +## openSUSE Leap + +Ensure your system repositories are up to date. For openSUSE Leap, use the following repository path: + +- `https://packages.fluentbit.io/opensuse/leap/$releaserver` + +### Configure Zypper for openSUSE Leap + +1. In `/etc/zypp/repos.d/`, add a new file called `fluent-bit.repo`. +1. Add the following content to the file (replace `$releaserver` with your Leap version, e.g., `15.6`): -1. Import the GPG key used to sign the packages. -1. In `/etc/zypp/repos.d/`, add a new file named `fluent-bit.repo`. -1. Add the following content to the file. ```text [fluent-bit] - name = Fluent Bit - baseurl = https://packages.fluentbit.io/suse/$releasever/ + name=Fluent Bit + baseurl=https://packages.fluentbit.io/opensuse/leap/$releaserver/ gpgcheck=1 - gpgkey=https://packages.fluentbit.io/fluentbit.key repo_gpgcheck=1 + gpgkey=https://packages.fluentbit.io/fluentbit.key enabled=1 ``` -1. Refresh the repository to make the new packages available. - ```text - sudo zypper refresh - ``` -1. As a best practice, gpgcheck and repo_gpgcheck are enabled by default for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages - -## Install - -Ensure you've configured 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-* -``` - -An alternative is to use Rocky or Alma Linux, which should be equivalent. -## SLES +1. As a best practice, enable `gpgcheck` for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages. -For openSUSE and SUSE Linux Enterprise Server (SLES) +## SUSE Linux Enterprise Server (SLES) -Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the $releasever variable to dynamically fetch packages for your specific system version. +Ensure your system repositories are up to date. For SLES, use the following repository path: -## Configure `zypper` +- `https://packages.fluentbit.io/sles/$releasever` -The`fluent-bit` package is provided through a Yum repository. To add the repository reference to your system: +### Configure Zypper for SLES -1. In `/etc/yum.repos.d/`, add a new file called `fluent-bit.repo`. +1. In `/etc/zypp/repos.d/`, add a new file called `fluent-bit.repo`. 1. Add the following content to the file: ```text [fluent-bit] - name = Fluent Bit - baseurl = https://packages.fluentbit.io/centos/$releasever/ + name=Fluent Bit + baseurl=https://packages.fluentbit.io/sles/$releasever/ gpgcheck=1 - gpgkey=https://packages.fluentbit.io/fluentbit.key repo_gpgcheck=1 + gpgkey=https://packages.fluentbit.io/fluentbit.key 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. +1. As a best practice, enable `gpgcheck` for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages. -### Install +### Install Fluent Bit 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 - sudo dnf install fluent-bit + sudo zypper refresh + sudo zypper install fluent-bit ``` 1. Instruct `Systemd` to enable the service: @@ -105,36 +110,28 @@ $ 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. +The default Fluent Bit configuration collects metrics of CPU usage and sends the records to the standard output. You can see the outgoing data in your `/var/log/messages` file. ## FAQ -### Yum install fails with a `404 - Page not found` error for the package mirror +### Zypper install fails with a `404 - Page not found` error for the package mirror + +Ensure you use the correct `$releaserver` (e.g., `15.6`) in your repo path: -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: +For openSUSE Leap: ```text -[fluent-bit] - name = Fluent Bit - baseurl = https://packages.fluentbit.io/centos/$releasever/$basearch/ +baseurl=https://packages.fluentbit.io/opensuse/leap/15.6/ ``` -Depending on your Red Hat distribution version, this variable can return a value other than the OS major release version (for example, RHEL7 Server distributions return `7Server` instead of `7`). The Fluent Bit package URL uses the major OS release version, so any other value here will cause a 404. - -To resolve this issue, replace the `$releasever` variable with your system's OS major release version. For example: +For SLES ```text -[fluent-bit] - name = Fluent Bit - baseurl = https://packages.fluentbit.io/centos/7/$basearch/ - gpgcheck=1 - gpgkey=https://packages.fluentbit.io/fluentbit.key - repo_gpgcheck=1 - enabled=1 +baseurl=https://packages.fluentbit.io/sles/15.7/ ``` -### Yum install fails with incompatible dependencies using CentOS 9+ +zypper knows about special variables like $releasever. It has its own internal logic to replace these with the correct values from your system's baseproduct file. -CentOS 9 and later will no longer be compatible with RHEL 9 as it might track more recent dependencies. Alternative AlmaLinux and RockyLinux repositories are available. +### Zypper install fails with incompatible dependencies -See the previous guidance. +OpenSUSE may track more recent dependencies than SLES. If you encounter dependency issues, ensure you are using the correct repository path for your OS distro. From 76d762b56a14d54bdaae401a46eb4f0681bd846f Mon Sep 17 00:00:00 2001 From: Dan Illescas Date: Fri, 17 Oct 2025 13:49:38 -0500 Subject: [PATCH 3/4] packaging: only use aarch64 as supported suse architecture to avoid confusion and issues going forward Signed-off-by: Dan Illescas --- installation/downloads/linux/suse.md | 1 - 1 file changed, 1 deletion(-) diff --git a/installation/downloads/linux/suse.md b/installation/downloads/linux/suse.md index a032fee44..0bf24326d 100644 --- a/installation/downloads/linux/suse.md +++ b/installation/downloads/linux/suse.md @@ -6,7 +6,6 @@ Fluent Bit supports the following architectures: - `x86_64` - `aarch64` -- `arm64v8` Fluent Bit supports the following distro versions: From 0faeb29b83806385a383d5beca97e52a0ac12c6a Mon Sep 17 00:00:00 2001 From: Lynette Miles <6818907+esmerel@users.noreply.github.com> Date: Tue, 21 Oct 2025 09:19:33 -0700 Subject: [PATCH 4/4] Apply suggestions from code review Signed-off-by: Lynette Miles <6818907+esmerel@users.noreply.github.com> --- installation/downloads/linux/suse.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/installation/downloads/linux/suse.md b/installation/downloads/linux/suse.md index 0bf24326d..9c003734e 100644 --- a/installation/downloads/linux/suse.md +++ b/installation/downloads/linux/suse.md @@ -7,7 +7,7 @@ Fluent Bit supports the following architectures: - `x86_64` - `aarch64` -Fluent Bit supports the following distro versions: +Fluent Bit supports the following distributions: - opensuse/leap:15.6 - sles/15.7 @@ -20,12 +20,12 @@ The recommended secure deployment approach is to use the following instructions: ## Ensure you select the correct openSUSE verse SLES Package -The openSUSE package is built and tested specifically for openSUSE Leap environments, ensuring compatibility with openSUSE libraries, update cycles, and system dependencies. Using the openSUSE package on openSUSE Leap systems helps avoid potential issues with mismatched dependencies or unsupported features that may arise from using SLES packages. +The openSUSE package is built and tested specifically for openSUSE Leap environments, ensuring compatibility with openSUSE libraries, update cycles, and system dependencies. Using the openSUSE package on openSUSE Leap systems helps avoid potential issues with mismatched dependencies or unsupported features that might arise from using SLES packages. -The SLES package is tailored for SUSE Linux Enterprise Server and is built against the SUSE Base Container Image, which may include different versions of libraries. It uses enterprise repositories with specific package versions, while Leap uses free, community driven repositories that have a broader range of packages. Installing the SLES package on openSUSE Leap is not recommended, as it may lead to library incompatibilities. +The SLES package is tailored for SUSE Linux Enterprise Server and is built against the SUSE Base Container Image, which may include different versions of libraries. It uses enterprise repositories with specific package versions, while Leap uses free, community driven repositories that have a broader range of packages. Installing the SLES package on openSUSE Leap is not recommended, as it can lead to library incompatibilities. -**In summary:** +In summary: - Use the openSUSE package for openSUSE Leap systems. - Use the SLES package for SUSE Linux Enterprise Server systems. @@ -41,7 +41,7 @@ Ensure your system repositories are up to date. For openSUSE Leap, use the follo ### Configure Zypper for openSUSE Leap 1. In `/etc/zypp/repos.d/`, add a new file called `fluent-bit.repo`. -1. Add the following content to the file (replace `$releaserver` with your Leap version, e.g., `15.6`): +1. Add the following content to the file (replace `$releaserver` with your Leap version. For example, `15.6`): ```text [fluent-bit] @@ -115,7 +115,7 @@ The default Fluent Bit configuration collects metrics of CPU usage and sends the ### Zypper install fails with a `404 - Page not found` error for the package mirror -Ensure you use the correct `$releaserver` (e.g., `15.6`) in your repo path: +Ensure you use the correct `$releaserver` (for example, `15.6`) in your repo path: For openSUSE Leap: @@ -133,4 +133,4 @@ zypper knows about special variables like $releasever. It has its own internal l ### Zypper install fails with incompatible dependencies -OpenSUSE may track more recent dependencies than SLES. If you encounter dependency issues, ensure you are using the correct repository path for your OS distro. +OpenSUSE might track more recent dependencies than SLES. If you encounter dependency issues, ensure you are using the correct repository path for your OS distro.