Skip to content

rancher/supportability-review-app

Repository files navigation

Supportability Review - Rancher Extension

The Supportability Review (SR) extension helps proactively validate your Rancher managed kubernetes cluster configuration and environment to ensure it's production-ready and support-aligned.

It provides:

  • Best Practice Validation: Verifies that your cluster design adheres to SUSE-recommended architecture for optimal supportability.
  • Support Matrix Compliance: Checks whether your cluster meets all SUSE supportability requirements for reliable and successful operation.
  • CVE Awareness: Alerts you to known CVEs (Common Vulnerabilities and Exposures) that may affect your cluster components.

Installation Guide

Follow the steps below to install the Supportability Review extension inside Rancher UI:

1. Open Extensions Menu

  • Navigate to the bottom-left hamburger menu in the Rancher UI.
  • Click on Extensions → Available / All Extensions. Hamburger menu icon

2. Add Rancher Repositories

  • Click the three dots (⋮) on the extensions page.
  • Select Add Rancher Repositories.
  • Wait a few seconds while the repository syncs.
  • You will now see the Supportability Review extension listed. Add extension menu

3. Install the Extension

  • Click on the Supportability Review entry.
  • Click the Install button.

Once installed, a new Cattleman icon will appear in the side menu.


Post-Installation Setup

4. Install the Supportability Review Operator

  • Click the Supportability Review (SR) icon in the sidebar.

  • Press the button: Add Supportability Review Operator Repository.

  • Then click Install Supportability Review Operator. Dashboard view to add repo

  • Important Step: Please update the default value of the container registry field to: docker.io(Interim fix until the Rancher registry is synced with the required images.) Container Regitry to docker.io During the installation process, you can configure the following components (We recommend keeping the default settings):

  • Images: Repository details for collector and analyzer images.

  • Collector Configuration: CPU, memory limits for the collector container.

  • Analyzer Configuration: CPU, memory limits for the analyzer container.

  • Redis Configuration: CPU, memory, and ephemeral storage limits for the Redis container.

    Collector configuration during install


Getting Started

5. Create a Review Bundle

  • Click the Get Started button from the Dashboard to begin creating your first review report.

  • You will be redirected to the Create Review page with two tabs:

    a. Basic Tab

    • Enter a custom bundle name (default: review-bundle). Create view

    b. Advanced Tab

    • Change the namespace for Sonobuoy.
    • Add node tolerations.
    • Write a bundle description.

we recommend keeping the default values

Prime customers can obtain a full supportability review by opening a Rancher support case and sharing the generated review bundle.
You can also preview what a full report looks like by clicking the View Sample Report link.


View and Manage Review Bundles

  • After creation, a review job is launched and enters a Running state.

  • Navigate to the Review Bundles tab to see:

    • A list of all previously created bundles, including:
      • Number of clusters
      • Number of passed checks
      • Bundle size ReviewBundle sidebar options
  • On the right side of each bundle entry, click the three-dot menu (⋮) to:

    • Download the bundle
    • View the report
  • Click on the bundle name or select View Report from the three-dot menu (⋮) to view a detailed visual report of your local cluster. Review report visualization


Feedback & Issues

If you encounter any bugs, installation issues, or have suggestions for improvement, please open an issue in this repository.

For further assistance, including detailed results, remediations, or a full supportability review, feel free to contact us at: [email protected]


About

No description, website, or topics provided.

Resources

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors 3

  •  
  •  
  •