Rancher Extensions
New in Rancher v2.7.0, Rancher introduces extensions. Extensions allow users, developers, partners, and customers to extend and enhance the Rancher UI. In addition, users can make changes and create enhancements to their UI functionality independent of Rancher releases. Extensions will enable users to build on top of Rancher to better tailor it to their respective environments. Note that users will also have the ability to update to new versions as well as roll back to a previous version.
Extensions are Helm charts that can only be installed once into a cluster; therefore, these charts have been simplified and separated from the general Helm charts listed under Apps.
Examples of built-in Rancher extensions are Fleet, Explorer, and Harvester. Examples of other extensions that use the Extensions API that can be manually added are Kubewarden and Elemental.
Prerequisites
You must log in as an admin in order to view and interact with the extensions management page.
Installing Extensions
Click ☰ > Extensions under Configuration.
If not already installed in Apps, you must enable the extension operator by clicking the Enable button.
- Click OK to add the Rancher extension repository if your installation is not air-gapped. Otherwise, uncheck the box to do so and click OK.
On the Extensions page, click on the Available tab to select which extensions you want to install.
In v2.7.0, the built-in extensions will not be displayed under the Available tab. Therefore, you will need to manually add the desired repos to install extensions. We will update the community once these extensions have been pulled out to be available for selection.
If no extensions are showing as available, you may manually add repos as follows:
4.1. On the upper right of screen, click on ⋮ > Manage Repositories > Create.
4.2. Add the desired repo name, making sure to also specify the Git Repo URL and the Git Branch.
4.3. Click Create in the lower right again to complete.
Under the Available tab, click Install on the desired extension and version as in the example below. Note that you can easily update your extension as the button to Update will appear on the extension if one is available.
Click the Reload page button that will appear after your extension successfully installs. Note that a logged-in user who has just installed an extension will not see a change to the UI unless they reload the page.
Uninstalling Extensions
There are two ways in which you can uninstall or disable your extensions:
Under the Installed tab, click the Uninstall button on the extension you wish to remove.
On the extensions management page, click ⋮ > Disable Extension Support. This will disable all installed extensions.
You must reload the page after disabling extensions or display issues may occur.
Rolling Back Extensions
Under the Installed tab, click the Rollback button on the extension you wish to roll back.
You must reload the page after rolling back extensions or display issues may occur.
Developing Extensions
To learn how to develop your own extensions, refer to the official Getting Started guide.