-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
16 changed files
with
238 additions
and
6 deletions.
There are no files selected for viewing
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,19 @@ | ||
annotations: | ||
catalog.cattle.io/certified: rancher | ||
catalog.cattle.io/kube-version: '>= v1.16.0-0 < v1.30.0-0' | ||
catalog.cattle.io/namespace: cattle-ui-plugin-system | ||
catalog.cattle.io/os: linux | ||
catalog.cattle.io/permits-os: linux, windows | ||
catalog.cattle.io/rancher-version: '>= 2.8.0-0 < v2.9.0-0' | ||
catalog.cattle.io/scope: management | ||
catalog.cattle.io/ui-component: plugins | ||
catalog.cattle.io/display-name: 'Krum Platform Tools: App Launcher' | ||
catalog.cattle.io/ui-version: '>= 2.7.2 < v2.9.0-0' | ||
apiVersion: v2 | ||
appVersion: 0.1.32 | ||
description: App Launcher extension for Rancher | ||
name: app-launcher | ||
type: application | ||
version: 0.1.32 | ||
icon: >- | ||
https://raw.githubusercontent.com/krumIO/krum-rancher-extensions/main/pkg/app-launcher/icon.svg |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,70 @@ | ||
# Rancher App Launcher Extension | ||
|
||
Rancher App Launcher Extension is a simple yet powerful tool for improved accessibility and resource discovery within Kubernetes. The extension is designed to extract ingresses from various clusters and consolidate them into a unified global resource page. With neatly organized cards for each discovered service, the tool offers an efficient method of displaying and accessing your Rancher services, making the Rancher experience seamless for both new and experienced users. | ||
|
||
The extension intends to improve the discoverability of services and offer a straightforward way to navigate the complexities of multi-cluster environments. | ||
|
||
<img src="./docs/images/preview.png" width="50%" alt="App Launcher Extension preview image"> | ||
|
||
## Features | ||
|
||
- Unified resource page for all discovered services and ingresses | ||
- Convenient access to services with a simple click | ||
- Global apps section for user-selected favorites and global apps defined by cluster YAML files | ||
- Grid and list views for easy navigation | ||
- Multi-cluster support for viewing services across different clusters | ||
|
||
## Usage | ||
|
||
### Filter by Name | ||
|
||
- Use the Filter box in the toolbar to search through all of the objects that your user credentials have access to across clusters. | ||
|
||
### Filter by Cluster | ||
|
||
- This page showcases cards for each discovered service and ingress, allowing you to conveniently open the service with a simple click. | ||
*The extension is designed to improve discoverability and offer a straightforward way to navigate the complexities of multi-cluster environments.* | ||
|
||
### Change views | ||
|
||
- The view can be changed with the view buttons in the toolbar, to switch between grid view and list view. | ||
|
||
### Select favorites (user) | ||
|
||
- Star service or ingress objects to surface them to the Global Apps section for easier discovery on repeat visits. | ||
- Note: This is currently limited | ||
|
||
### Tag "Global" Apps (admin) | ||
|
||
Global apps will show at the top of the App Launcher page as a combination of global apps defined by cluster YAML files and user-selected favorites. | ||
|
||
- Apps tagged in Yaml will persist for all users. | ||
- (currently) User-selected favorites will only persist for the user who selected them and are stored in the browser's local storage. | ||
|
||
To select a Service or Ingress as a Global App, add the following annotation to the Service or Ingress: | ||
|
||
```yaml | ||
metadata: | ||
annotations: | ||
extensions.applauncher/global-app: "true" | ||
``` | ||
## Installation | ||
Please follow the instructions for installing the extension collection at the repository root: https://github.com/krumIO/krum-rancher-extensions/ | ||
## Development | ||
1. Clone this repository to your machine. | ||
2. Install the npm dependencies using the command `yarn install`. | ||
3. Run the extension collection locally with the command `API=<Rancher Backend URL> yarn dev`. | ||
|
||
## Contribution | ||
|
||
Your contribution matters! If you're looking to enhance the functionalities of this extension or have innovative ideas to improve the discoverability further, we warmly welcome pull requests. Let's make the Rancher environment more user-friendly together! | ||
|
||
## Support | ||
|
||
If you encounter any issues, have questions or suggestions, please file them in our issue tracker. We're committed to providing a smooth user experience and appreciate your feedback to continually improve. | ||
|
||
Rancher App Launcher Extension is here to address the need for effective discoverability within the Rancher platform. Let's make resource navigation simpler and more efficient! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
{{/* | ||
Expand the name of the chart. | ||
*/}} | ||
{{- define "extension-server.name" -}} | ||
{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }} | ||
{{- end }} | ||
|
||
{{/* | ||
Create a default fully qualified app name. | ||
We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec). | ||
If release name contains chart name it will be used as a full name. | ||
*/}} | ||
{{- define "extension-server.fullname" -}} | ||
{{- if .Values.fullnameOverride }} | ||
{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }} | ||
{{- else }} | ||
{{- $name := default .Chart.Name .Values.nameOverride }} | ||
{{- if contains $name .Release.Name }} | ||
{{- .Release.Name | trunc 63 | trimSuffix "-" }} | ||
{{- else }} | ||
{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }} | ||
{{- end }} | ||
{{- end }} | ||
{{- end }} | ||
|
||
|
||
{{/* | ||
Create chart name and version as used by the chart label. | ||
*/}} | ||
{{- define "extension-server.chart" -}} | ||
{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }} | ||
{{- end }} | ||
|
||
{{/* | ||
Common labels | ||
*/}} | ||
{{- define "extension-server.labels" -}} | ||
helm.sh/chart: {{ include "extension-server.chart" . }} | ||
{{ include "extension-server.selectorLabels" . }} | ||
{{- if .Chart.AppVersion }} | ||
app.kubernetes.io/version: {{ .Chart.AppVersion | quote }} | ||
{{- end }} | ||
app.kubernetes.io/managed-by: {{ .Release.Service }} | ||
{{- end }} | ||
|
||
{{/* | ||
Selector labels | ||
*/}} | ||
{{- define "extension-server.selectorLabels" -}} | ||
app.kubernetes.io/name: {{ include "extension-server.name" . }} | ||
app.kubernetes.io/instance: {{ .Release.Name }} | ||
{{- end }} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
apiVersion: catalog.cattle.io/v1 | ||
kind: UIPlugin | ||
metadata: | ||
name: {{ include "extension-server.fullname" . }} | ||
namespace: {{ .Release.Namespace }} | ||
labels: {{ include "extension-server.labels" . | nindent 4 }} | ||
spec: | ||
plugin: | ||
name: {{ include "extension-server.fullname" . }} | ||
version: {{ (semver (default .Chart.AppVersion .Values.plugin.versionOverride)).Original }} | ||
endpoint: https://raw.githubusercontent.com/krumIO/krum-rancher-extensions/gh-pages/extensions/app-launcher/0.1.32 | ||
noCache: {{ .Values.plugin.noCache }} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
nameOverride: "" | ||
fullnameOverride: "" | ||
plugin: | ||
enabled: true | ||
versionOverride: "" | ||
noCache: false |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
plugin/app-launcher-0.1.32.umd.min.1.js | ||
plugin/app-launcher-0.1.32.umd.min.1.js.map | ||
plugin/app-launcher-0.1.32.umd.min.2.js | ||
plugin/app-launcher-0.1.32.umd.min.2.js.map | ||
plugin/app-launcher-0.1.32.umd.min.js | ||
plugin/app-launcher-0.1.32.umd.min.js.map | ||
plugin/package.json |
2 changes: 2 additions & 0 deletions
2
extensions/app-launcher/0.1.32/plugin/app-launcher-0.1.32.umd.min.1.js
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
1 change: 1 addition & 0 deletions
1
extensions/app-launcher/0.1.32/plugin/app-launcher-0.1.32.umd.min.1.js.map
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
2 changes: 2 additions & 0 deletions
2
extensions/app-launcher/0.1.32/plugin/app-launcher-0.1.32.umd.min.2.js
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
1 change: 1 addition & 0 deletions
1
extensions/app-launcher/0.1.32/plugin/app-launcher-0.1.32.umd.min.2.js.map
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
16 changes: 16 additions & 0 deletions
16
extensions/app-launcher/0.1.32/plugin/app-launcher-0.1.32.umd.min.js
Large diffs are not rendered by default.
Oops, something went wrong.
1 change: 1 addition & 0 deletions
1
extensions/app-launcher/0.1.32/plugin/app-launcher-0.1.32.umd.min.js.map
Large diffs are not rendered by default.
Oops, something went wrong.
Oops, something went wrong.