Skip to content

Commit 7dc3b5e

Browse files
committed
packaging: fix suse.md
Signed-off-by: Dan Illescas <[email protected]>
1 parent 7eaac33 commit 7dc3b5e

File tree

1 file changed

+58
-61
lines changed
  • installation/downloads/linux

1 file changed

+58
-61
lines changed
Lines changed: 58 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1,88 +1,93 @@
1-
# openSUSE and SLES
1+
# openSUSE and SUSE Linux Enterprise Server (SLES)
22

3-
Fluent Bit is distributed as the `fluent-bit` package and is available for the latest stable opensuse-leap and sles 15.7 system.
3+
Fluent Bit is distributed as the `fluent-bit` package and is available for OpenSUSE-Leap 15.6 and SLES 15.7 systems.
44

55
Fluent Bit supports the following architectures:
66

77
- `x86_64`
88
- `aarch64`
99
- `arm64v8`
1010

11-
For openSUSE 15, Fluent Bit uses [openSUSE Leap](https://get.opensuse.org/leap) as the canonical base system.
11+
Fluent Bit supports the following distro versions:
12+
13+
- opensuse/leap:15.6
14+
- sles/15.7
15+
16+
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.
17+
18+
For SLES, Fluent Bit uses [SUSE Base Container Images (BCI)](https://www.suse.com/products/base-container-images/) as the canonical base system.
1219

1320
The recommended secure deployment approach is to use the following instructions:
1421

15-
## For openSUSE and SUSE Linux Enterprise Server (SLES)
22+
## Ensure you select the correct openSUSE verse SLES Package
23+
24+
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.
25+
26+
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.
27+
28+
29+
**In summary:**
30+
- Use the openSUSE package for openSUSE Leap systems.
31+
- Use the SLES package for SUSE Linux Enterprise Server systems.
1632

17-
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.
33+
This ensures you receive the correct updates and compatibility for your chosen platform.
1834

19-
## Configure `zypper`
2035

21-
The `fluent-bit` openSUSE package is provided through a `zypper` repository. To add the repository reference to your system:
36+
## openSUSE Leap
37+
38+
Ensure your system repositories are up to date. For openSUSE Leap, use the following repository path:
39+
40+
- `https://packages.fluentbit.io/opensuse/leap/$releaserver`
41+
42+
### Configure Zypper for openSUSE Leap
43+
44+
1. In `/etc/zypp/repos.d/`, add a new file called `fluent-bit.repo`.
45+
1. Add the following content to the file (replace `$releaserver` with your Leap version, e.g., `15.6`):
2246

23-
1. Import the GPG key used to sign the packages.
24-
1. In `/etc/zypp/repos.d/`, add a new file named `fluent-bit.repo`.
25-
1. Add the following content to the file.
2647
```text
2748
[fluent-bit]
28-
name = Fluent Bit
29-
baseurl = https://packages.fluentbit.io/suse/$releasever/
49+
name=Fluent Bit
50+
baseurl=https://packages.fluentbit.io/opensuse/leap/$releaserver/
3051
gpgcheck=1
31-
gpgkey=https://packages.fluentbit.io/fluentbit.key
3252
repo_gpgcheck=1
53+
gpgkey=https://packages.fluentbit.io/fluentbit.key
3354
enabled=1
3455
```
35-
1. Refresh the repository to make the new packages available.
36-
```text
37-
sudo zypper refresh
38-
```
39-
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
40-
41-
## Install
42-
43-
Ensure you've configured an appropriate mirror. For example:
44-
45-
```shell
46-
$ sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && \
47-
48-
$ sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
49-
```
50-
51-
An alternative is to use Rocky or Alma Linux, which should be equivalent.
5256

53-
## SLES
57+
1. As a best practice, enable `gpgcheck` for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages.
5458

55-
For openSUSE and SUSE Linux Enterprise Server (SLES)
59+
## SUSE Linux Enterprise Server (SLES)
5660

57-
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.
61+
Ensure your system repositories are up to date. For SLES, use the following repository path:
5862

59-
## Configure `zypper`
63+
- `https://packages.fluentbit.io/sles/$releasever`
6064

61-
The`fluent-bit` package is provided through a Yum repository. To add the repository reference to your system:
65+
### Configure Zypper for SLES
6266

63-
1. In `/etc/yum.repos.d/`, add a new file called `fluent-bit.repo`.
67+
1. In `/etc/zypp/repos.d/`, add a new file called `fluent-bit.repo`.
6468
1. Add the following content to the file:
6569

6670
```text
6771
[fluent-bit]
68-
name = Fluent Bit
69-
baseurl = https://packages.fluentbit.io/centos/$releasever/
72+
name=Fluent Bit
73+
baseurl=https://packages.fluentbit.io/sles/$releasever/
7074
gpgcheck=1
71-
gpgkey=https://packages.fluentbit.io/fluentbit.key
7275
repo_gpgcheck=1
76+
gpgkey=https://packages.fluentbit.io/fluentbit.key
7377
enabled=1
7478
```
7579

76-
1. As a best practice, enable `gpgcheck` and `repo_gpgcheck` for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages.
80+
1. As a best practice, enable `gpgcheck` for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages.
7781

78-
### Install
82+
### Install Fluent Bit
7983

8084
1. Ensure your [GPG key](../linux.md#gpg-key-updates) is up to date.
8185

8286
1. After your repository is configured, run the following command to install it:
8387

8488
```shell
85-
sudo dnf install fluent-bit
89+
sudo zypper refresh
90+
sudo zypper install fluent-bit
8691
```
8792

8893
1. Instruct `Systemd` to enable the service:
@@ -105,36 +110,28 @@ $ systemctl status fluent-bit
105110
...
106111
```
107112

108-
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.
113+
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.
109114

110115
## FAQ
111116

112-
### Yum install fails with a `404 - Page not found` error for the package mirror
117+
### Zypper install fails with a `404 - Page not found` error for the package mirror
118+
119+
Ensure you use the correct `$releaserver` (e.g., `15.6`) in your repo path:
113120

114-
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:
121+
For openSUSE Leap:
115122

116123
```text
117-
[fluent-bit]
118-
name = Fluent Bit
119-
baseurl = https://packages.fluentbit.io/centos/$releasever/$basearch/
124+
baseurl=https://packages.fluentbit.io/opensuse/leap/15.6/
120125
```
121126

122-
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.
123-
124-
To resolve this issue, replace the `$releasever` variable with your system's OS major release version. For example:
127+
For SLES
125128

126129
```text
127-
[fluent-bit]
128-
name = Fluent Bit
129-
baseurl = https://packages.fluentbit.io/centos/7/$basearch/
130-
gpgcheck=1
131-
gpgkey=https://packages.fluentbit.io/fluentbit.key
132-
repo_gpgcheck=1
133-
enabled=1
130+
baseurl=https://packages.fluentbit.io/sles/15.7/
134131
```
135132

136-
### Yum install fails with incompatible dependencies using CentOS 9+
133+
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.
137134

138-
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.
135+
### Zypper install fails with incompatible dependencies
139136

140-
See the previous guidance.
137+
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.

0 commit comments

Comments
 (0)