Skip to content

packaging: add opensuse and sles#2103

Open
illescad wants to merge 6 commits into
fluent:masterfrom
illescad:illescad-packaging-suse
Open

packaging: add opensuse and sles#2103
illescad wants to merge 6 commits into
fluent:masterfrom
illescad:illescad-packaging-suse

Conversation

@illescad
Copy link
Copy Markdown

@illescad illescad commented Oct 16, 2025

Support for opensuse-leap 15.6 and sles 15.7 pacakging. See fluent-bit/10978 for implementation, resolves #10875

Summary by CodeRabbit

  • Documentation
    • Added comprehensive installation guide for openSUSE Leap and SUSE Linux Enterprise Server, including repository configuration, installation steps, and troubleshooting for common issues.
    • Updated installation documentation index with openSUSE/SLES entry.

Review Change Stack

Signed-off-by: Dan Illescas <daniel.illescas@hpe.com>
Comment thread SUMMARY.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Copy link
Copy Markdown
Contributor

@esmerel esmerel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I made some consistency suggestions which will fix some of the vale warnings.

I also updated the vale test so that SUSE/SLES shouldn't give warnings anymore, but those are in master so this branch is still going to have the warnings but won't after merging (or if it's rebased).

Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Signed-off-by: Dan Illescas <daniel.illescas@hpe.com>
@illescad
Copy link
Copy Markdown
Author

@esmerel thanks for your review and suggestions. i just pushed changes for suse.md. I had left a draft version of that file in by accident

Copy link
Copy Markdown
Contributor

@cosmo0920 cosmo0920 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added a very small nitpick. Could you check it?

Comment thread installation/downloads/linux/suse.md Outdated
…onfusion and issues going forward

Signed-off-by: Dan Illescas <daniel.illescas@hpe.com>
Copy link
Copy Markdown
Contributor

@cosmo0920 cosmo0920 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For technical terminology, it looks good to me.

@eschabell
Copy link
Copy Markdown
Collaborator

@esmerel the vale lint failed, is this a blocker or just a run failure, can you check?

I'm nudging on the code PR side (2x) to get this completed.

@eschabell eschabell self-assigned this Oct 21, 2025
@eschabell eschabell added the waiting-on-review Waiting on a review from mainteners label Oct 21, 2025
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md Outdated
Signed-off-by: Lynette  Miles <6818907+esmerel@users.noreply.github.com>
@esmerel
Copy link
Copy Markdown
Contributor

esmerel commented Oct 21, 2025

@eschabell I pushed a bunch of vale corrections - the one that test is failing on won't (or at least shouldn't) block the merge, you can still merge even though the button isn't green. In this case it's a test that needed an update to account for the capitalization, which I already fixed in main. I have no issues merging this PR as it is.

@eschabell eschabell added lint-vale-issues and removed waiting-on-review Waiting on a review from mainteners labels Oct 22, 2025
@eschabell eschabell added 4.2.1 conflict Waiting on conflict to be resolved by contributor and removed 4.2.1 lint-vale-issues labels Dec 3, 2025
@eschabell
Copy link
Copy Markdown
Collaborator

@illescad — I've rebased your branch to resolve the conflicts. You can update your PR branch with:

git fetch upstream
git reset --hard upstream/illescad-packaging-suse
git push origin illescad-packaging-suse --force

Where upstream is their remote pointing to fluent/fluent-bit-docs. Once you do this we can proceed with the rest of the issues to get this doc PR over the finish line. Thanks!

@eschabell eschabell added the waiting-for-user Waiting for user/contributors feedback or requested changes label May 26, 2026
Resolve conflicts:
- SUMMARY.md: insert openSUSE/SLES into master's alphabetized Linux list
- installation/downloads.md: master replaced the table; openSUSE/SLES
  added to the new Linux bullet list instead
- installation/getting-started-with-fluent-bit.md: accept upstream
  deletion (content consolidated into downloads.md)

Also fix one vale error in suse.md (may -> might).

Signed-off-by: Eric D. Schabell <eric@schabell.org>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 29, 2026

Warning

Review limit reached

@eschabell, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 4 minutes and 58 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5f414e26-ae81-42ec-9c29-6b4a587a9f93

📥 Commits

Reviewing files that changed from the base of the PR and between d8ae83a and 09d82be.

📒 Files selected for processing (1)
  • installation/downloads/linux/suse.md
📝 Walkthrough

Walkthrough

This PR adds a complete installation guide for Fluent Bit on openSUSE Leap and SUSE Linux Enterprise Server, including repository configuration, installation commands, and troubleshooting guidance. The new guide is indexed in the documentation navigation and table of contents.

Changes

openSUSE/SLES Installation Documentation

Layer / File(s) Summary
openSUSE/SLES installation guide
installation/downloads/linux/suse.md
New 136-line documentation page covering Zypper repository setup (including GPG key configuration for both openSUSE Leap and SLES), installation via zypper install fluent-bit, service startup with systemctl, expected systemd output, and FAQ addressing common Zypper 404 mirror and dependency mismatch errors.
Navigation and TOC updates
SUMMARY.md, installation/downloads.md
Table of Contents and installation downloads index now include entries for "openSUSE / SLES" that link to the new installation guide.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~18 minutes

Possibly related PRs

  • fluent/fluent-bit-docs#2172: Both PRs modify the installation documentation navigation in SUMMARY.md and installation/downloads.md; PR 2172 also rewrites those pages and adds redirects.

Suggested reviewers

  • gguillotte

Poem

🐰 A leap for openSUSE shines, Zypper config so fine,
SLES repositories aligned, with GPG keys that bind.
The guide now springs to life complete,
A thousand hops in lines so neat!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'packaging: add opensuse and sles' directly and accurately summarizes the main change: adding documentation and packaging support for openSUSE and SLES distributions.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

♻️ Duplicate comments (1)
installation/downloads/linux/suse.md (1)

39-40: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Use $releasever consistently in openSUSE instructions.

The openSUSE section uses $releaserver while the SLES section and explanatory text use $releasever. This inconsistency can lead to broken repo URLs when users copy/paste as-is.

Suggested doc fix
-- `https://packages.fluentbit.io/opensuse/leap/$releaserver`
+- `https://packages.fluentbit.io/opensuse/leap/$releasever`

-1. Add the following content to the file (replace `$releaserver` with your Leap version. For example, `15.6`):
+1. Add the following content to the file (replace `$releasever` with your Leap version, for example `15.6`):

-    baseurl=https://packages.fluentbit.io/opensuse/leap/$releaserver/
+    baseurl=https://packages.fluentbit.io/opensuse/leap/$releasever/

-Ensure you use the correct `$releaserver` (for example, `15.6`) in your repo path:
+Ensure you use the correct `$releasever` (for example, `15.6`) in your repo path:

Also applies to: 44-45, 49-49, 118-119

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@installation/downloads/linux/suse.md` around lines 39 - 40, Replace the
incorrect token `$releaserver` with the correct `$releasever` in the
openSUSE/SLES repository URL examples and any explanatory text; search for
occurrences of the string `$releaserver` and update them to `$releasever` (e.g.,
the repo URL `https://packages.fluentbit.io/opensuse/leap/$releaserver` and the
other instances noted), ensuring all repo lines and explanatory mentions
consistently use `$releasever`.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@installation/downloads/linux/suse.md`:
- Line 108: The sample systemd output line currently shows "-c
etc/fluent-bit/fluent-bit.conf" without the leading slash; update the example
string "└─3820 /opt/fluent-bit/bin/fluent-bit -c etc/fluent-bit/fluent-bit.conf"
to use an absolute path by changing "-c etc/fluent-bit/fluent-bit.conf" to "-c
/etc/fluent-bit/fluent-bit.conf" so the sample command is correct.
- Line 21: Fix the heading typo in the markdown heading "## Ensure you select
the correct openSUSE verse SLES Package" by replacing "verse" with "versus" so
it reads "## Ensure you select the correct openSUSE versus SLES Package"; update
that line in the installation/downloads/linux/suse.md file (look for the exact
heading string) and commit the corrected heading.

---

Duplicate comments:
In `@installation/downloads/linux/suse.md`:
- Around line 39-40: Replace the incorrect token `$releaserver` with the correct
`$releasever` in the openSUSE/SLES repository URL examples and any explanatory
text; search for occurrences of the string `$releaserver` and update them to
`$releasever` (e.g., the repo URL
`https://packages.fluentbit.io/opensuse/leap/$releaserver` and the other
instances noted), ensuring all repo lines and explanatory mentions consistently
use `$releasever`.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9a035448-372c-49d1-bd00-f1dd89ef3b2b

📥 Commits

Reviewing files that changed from the base of the PR and between 82ab6af and d8ae83a.

📒 Files selected for processing (3)
  • SUMMARY.md
  • installation/downloads.md
  • installation/downloads/linux/suse.md

Comment thread installation/downloads/linux/suse.md Outdated
Comment thread installation/downloads/linux/suse.md
CI vale runs with -level=info -fail-on-error=true and flagged the SUSE
docs. Fix without changing vale-styles:

- Backtick command and variable names (`zypper`, `$releasever`,
  `baseproduct`) so the Spelling rule treats them as code spans.
- Backtick brand names (`openSUSE`, `SLES`, `SUSE Linux Enterprise
  Server`) in headings so the Headings capitalization rule treats them
  as masked tokens.
- Fix typo in heading ("verse" -> "or"); lowercase trailing "Package".
- "is not recommended" -> "isn't recommended" (contraction).
- Expand casual abbreviations ("repo" -> "repository",
  "distro" -> "distribution").

Signed-off-by: Eric D. Schabell <eric@schabell.org>
Copy link
Copy Markdown
Collaborator

@eschabell eschabell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@illescad now just waiting on code PR merging.

@eschabell eschabell removed waiting-for-user Waiting for user/contributors feedback or requested changes conflict Waiting on conflict to be resolved by contributor labels May 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add suse and sles as packing/distros

5 participants