Introduction

Terra is Juno's open-source Kubernetes application marketplace that serves as a plugin system utilizing Helm charts in conjunction with Argo CD. Terra opens the door to the whole world of Kubernetes, expanding far beyond basic workstation deployments by providing access to thousands of existing applications through a standardized, one-click deployment system.

Initial Source

When first using Terra, it will not have any plugin sources configured. You can add the official Juno repository by following this guide: Adding the Juno Official Plugins Repository.

At the top of the Terra marketplace, users will see tabs to navigate between the main store, source repositories, and their installed applications.

App Store

When first navigating to the marketplace, users will see a list of available plugins to install as well as search tools. You can click on the plugin cards to view the plugin details and install form.

Install a plugin

1. Click which plugin you want to install.
2. Fill out the install form and submit.
3. Navigate to the terra installs tab. Read more about the installs tab here
4. Click the refresh button to get the latest status of the installed plugin or if you have the ArgoCD Dashboard plugin installed. View the install within Argo. Read more about the plugin here

Source Repositories

Here you can manage your Terra git repository sources. Read more about Terra Repositories here

Add Official Source

Click on the plus icon next to the Official Repo URL to add the Juno Innovations Official Terra Repository. We recommend forking the official repository. Read more about contributing here

Create New Source

1. Navigate to Terra source repo tab.
2. Click the NEW SOURCE button.
3. Fill in the form and submit.

Field	Required	Description
Name	Yes	This will be your reference for the repo within the terra app store.
URL	Yes	Git URL for the repo.
Ref	Yes	Git branch you want to pull from.
Username	No	If the repo is private, provide a username that can access it.
Password/Token	No	If the repo is private, provide a password/token that can access it.

Delete Source

Click the delete icon on the source row to delete. If you delete a source and a plugin is installed from that source. The plugin will be labeled as orphaned in the installs table. The plugin is still usable but simply cannot be tracked back to its original source. You can add the source back and terra will pick it up and re-sync the plugins installed from that source.

Plugin Installs

Here you can view and manage your currently installed plugins. The install table groups installs by namespace, we do this so you can see which plugins are a part of which projects. At anypoint you want to refresh the table to get the latest data. Click the refresh button located in the top left of the table.

Table Actions

Uninstall

Click the delete icon in the action column for the plugin, then click the refresh button to update its status. Once the plugin is removed from the table it is fully uninstalled.

Open in ArgoCD Dashboard

If you have the ArgoCD Dashboard plugin installed. You can navigate to the installed plugin in ArgoCD directly from the install table. Click on the link icon in the action column on each row. Read more about the ArgoCD Dashboard plugin here

Dashboard Plugins

Installed dashboard plugins will show up in the sidebar. This allows for easy access to them while you are navigating genesis. Read more about dashboard plugins here