Skip to content

Comments

docs(changelog): version 0.2.0 [citest skip]#21

Merged
spetrosi merged 1 commit intolinux-system-roles:mainfrom
spetrosi:changelog-20251002
Oct 2, 2025
Merged

docs(changelog): version 0.2.0 [citest skip]#21
spetrosi merged 1 commit intolinux-system-roles:mainfrom
spetrosi:changelog-20251002

Conversation

@spetrosi
Copy link
Collaborator

@spetrosi spetrosi commented Oct 2, 2025

Update changelog and .README.html for version 0.2.0

Signed-off-by: Sergei Petrosian spetrosi@redhat.com

Summary by Sourcery

Update documentation and changelog for version 0.2.0 by adding and detailing new configuration variables (kernel updates, package updates, system and source-built OpenMPI, firewall, HPC tuning), refreshing example playbooks, and recording recent feature additions, bug fix, and CI improvements

New Features:

  • Document support for building GDRCopy, HPCX, and OpenMPI from source
  • Document option to install system OpenMPI without GPU support
  • Document new variables for kernel and full system package updates
  • Add variable for configuring firewall management
  • Add variable for applying HPC tuning configurations

Bug Fixes:

  • Only enable the nvidia-fabricmanager service when installing NVIDIA Fabric Manager

Enhancements:

  • Update example playbooks in README.html to include new configuration variables

CI:

  • Use tox-lsr 3.12.0 for osbuild_config.yml feature
  • Use JSON format for __bootc_validation in CI

Documentation:

  • Bump changelog to version 0.2.0 with categorized entries for new features, bug fixes, and other changes

Update changelog and .README.html for version 0.2.0

Signed-off-by: Sergei Petrosian <spetrosi@redhat.com>
@spetrosi spetrosi requested a review from richm as a code owner October 2, 2025 07:48
@sourcery-ai
Copy link

sourcery-ai bot commented Oct 2, 2025

Reviewer's Guide

This PR updates the project documentation to introduce and document new HPC-related variables and playbook examples in .README.html, and publishes the 0.2.0 release notes in CHANGELOG.md with new features, bug fixes, and CI improvements.

Class diagram for new and updated HPC configuration variables

classDiagram
    class HPCConfigVariables {
      +bool hpc_update_kernel
      +bool hpc_update_all_packages
      +bool hpc_install_cuda_driver
      +bool hpc_install_cuda_toolkit
      +bool hpc_install_hpc_nvidia_nccl
      +bool hpc_install_nvidia_fabric_manager
      +bool hpc_install_rdma
      +bool hpc_install_system_openmpi
      +bool hpc_build_openmpi_w_nvidia_gpu_support
      +bool hpc_tuning
      +bool hpc_manage_firewall
    }
    class FirewallConfig {
      +bool hpc_manage_firewall
      +enable firewall service()
      +set default zone trusted()
    }
    class OpenMPIConfig {
      +bool hpc_install_system_openmpi
      +bool hpc_build_openmpi_w_nvidia_gpu_support
      +build requirements: GDRCopy, HPCX, PMIx
    }
    HPCConfigVariables --> FirewallConfig : manages
    HPCConfigVariables --> OpenMPIConfig : configures
Loading

File-Level Changes

Change Details Files
Extended .README.html with new variable sections and updated playbook examples
  • Added TOC entries for hpc_update_kernel, hpc_update_all_packages, tuning and firewall sections
  • Documented new boolean variables (kernel and package updates, tuning, firewall management) with defaults and types
  • Renamed and split existing variables (hpc_install_nvidia_rdma → hpc_install_rdma, separate system vs GPU-build OpenMPI)
  • Updated example playbooks to include all new variables and service enablement details
.README.html
Published version 0.2.0 release notes
  • Added new features: user feedback improvements, source builds for gdrcopy, hpcx, OpenMPI, system OpenMPI installation
  • Logged bug fix for fabric manager service enablement
  • Recorded CI changes for tox-lsr version bump and JSON validation
CHANGELOG.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Hey there - I've reviewed your changes - here's some feedback:

  • The .README.html list updates introduce complex nesting; please verify all
      and
    • tags are correctly opened and closed to avoid malformed HTML in the TOC.
    • The release date in CHANGELOG.md is set to 2025-10-02—please confirm this matches the intended release schedule.
    Prompt for AI Agents
    Please address the comments from this code review:
    
    ## Overall Comments
    - The .README.html list updates introduce complex nesting; please verify all <ul> and <li> tags are correctly opened and closed to avoid malformed HTML in the TOC.
    - The release date in CHANGELOG.md is set to 2025-10-02—please confirm this matches the intended release schedule.
    
    ## Individual Comments
    
    ### Comment 1
    <location> `.README.html:382-391` </location>
    <code_context>
    +<h2 id="hpc_manage_firewall">hpc_manage_firewall</h2>
    </code_context>
    
    <issue_to_address>
    **🚨 issue (security):** The firewall configuration may introduce security risks if not properly understood.
    
    Please add a warning or best practices section to clarify the risks of setting the default firewall zone to trusted and allowing all connections, particularly for users in cloud environments.
    </issue_to_address>
    
    ### Comment 2
    <location> `CHANGELOG.md:11` </location>
    <code_context>
    +
    +- feat: Add improvements from Yaju and Fabio feedback (#13)
    +- feat: Build gdrcopy, hpcx, and openmpi from source (#17)
    +- feat: Install system openmpi for usecases that don't need GPUs (#19)
    +
    +### Bug Fixes
    </code_context>
    
    <issue_to_address>
    **suggestion (typo):** Consider changing 'usecases' to 'use cases' for correct spelling.
    
    Writing 'use cases' as two words ensures clarity and follows standard usage.
    
    ```suggestion
    - feat: Install system openmpi for use cases that don't need GPUs (#19)
    ```
    </issue_to_address>

    Sourcery is free for open source - if you like our reviews please consider sharing them ✨
    Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Comment on lines +382 to +391
<h2 id="hpc_manage_firewall">hpc_manage_firewall</h2>
<p>Whether to run the linux-system-roles.firewall role to manage
Firewall.</p>
<p>Setting this variable to <code>true</code> does the following:</p>
<ol type="1">
<li>Enable and start the firewall service.</li>
<li>Configure the default firewall zone to be trusted.</li>
</ol>
<p>This, basically, allows all connections. This is a common practice
with HPC workloads because security is handled by cloud providers.</p>
Copy link

Choose a reason for hiding this comment

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

🚨 issue (security): The firewall configuration may introduce security risks if not properly understood.

Please add a warning or best practices section to clarify the risks of setting the default firewall zone to trusted and allowing all connections, particularly for users in cloud environments.


- feat: Add improvements from Yaju and Fabio feedback (#13)
- feat: Build gdrcopy, hpcx, and openmpi from source (#17)
- feat: Install system openmpi for usecases that don't need GPUs (#19)
Copy link

Choose a reason for hiding this comment

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

suggestion (typo): Consider changing 'usecases' to 'use cases' for correct spelling.

Writing 'use cases' as two words ensures clarity and follows standard usage.

Suggested change
- feat: Install system openmpi for usecases that don't need GPUs (#19)
- feat: Install system openmpi for use cases that don't need GPUs (#19)

@spetrosi spetrosi merged commit 97dadda into linux-system-roles:main Oct 2, 2025
21 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant