Skip to content

Install a Plugin

Installing a Plugin is the entire backbone of Terra. Plugins can add everything from game servers, databases, monitoring and even runtime workload modifiers.

intro

Install Workstation Plugin

Workstation Plugins provide the "schema" for a Workstation Template. This allows Terra to install different workstations from different vendors, or even custom ones you create yourself. In this example, we will add the Official Helios Workstation Plugin.

Search and Install Helios

Find the Helios Plugin in the Plugin Marketplace and click the application tile.

side-bar

Other Helios Plugins

Make sure to only install the Plugin named Helios. The other Helios Plugins are runtime Kuiper Plugins that are not needed for this step.

Verify Installation

Next, navigate to the Installs tab and verify that the Helios Plugin is installed. You can also view the plugin in your ArgoCD instance.

side-bar

Find Helios in Workloads/Workstations

Finally, navigate to the workstations/workloads tab in Genesis and create a new Workstation. You should see Helios as an option now.

side-bar

You can now follow the instructions in the Workstation Creation documentation to create a Helios Workstation if you wish.

Install Dashboard Plugin

Dashboard Plugins provide additional functionality to Orion. Many services provide web dashboards which Orion can embed into its interface. In this example, we will add the Official ArgoCD Dashboard Plugin which embeds ArgoCD into Genesis and provides single-sign on functionality.

Search and Install Argocd

Find the ArgoCD Plugin in the Plugin Marketplace and click the application tile.

side-bar

Verify Installation

Next, navigate to the Installs tab and verify that the ArgoCD Plugin is installed.

side-bar

Connect to the Dashboard

Refresh Genesis and you will see that the ArgoCD logo has been added to the nav bar in Genesis.

side-bar

Click the icon and you will be connected to ArgoCD and able to manage your ArgoCD applications from within Genesis.

side-bar

Install Management via ArgoCD Plugin

Orion is closely integrated with ArgoCD to provide GitOps functionality. Because of this, we provide native integration with ArgoCD via the Plugin. For example, on the Installs tab, you will see a connect button on the right side of each installation which will route you to the relevant ArgoCD application.

side-bar