Catalogs

A catalog is a git repository that contains the manifests of applications. A manifest contains all the details of an app. EDA Store builds a list of all available apps using the manifests of all the catalogs registered in EDA.

In the EDA UI, you can interact with catalogs from the System Administration > Catalogs page.

The Catalogs page displays all the catalogs available in EDA. You can double-click a catalog to view its details or edit it. For more information about how to manage a catalog, see Managing a catalog.

Creating a catalog credentials secret

The credentials created in this procedure is used in Adding a catalog to the EDA Store.
To create a catalog credentials secret, update the following Secret resource file: 
apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: your-creds # A unique secret name
data:
  username: <base64(username)> # Base64 encoded username
  password: <base64(password or token)> # Base64 encoded password/token
  • Provide a unique name in the name field.
  • Provide base64 encoded values for the data fields.

Adding a catalog to the EDA Store

You must have already created the authentication secret as described in Creating a catalog credentials secret.

In the EDA UI, you can add a catalog from the System Administration > Catalogs page.

  1. Click Create.
  2. Configure metadata for this resource.
    Set the following fields:
    • Name
    • Labels
    • Annotations
  3. Configure the specifications for this catalog.
    Set the following parameters:
    • Authentication Secret Reference: Provide the Kubernetes secret that contains the credentials to connect to the Catalog git repository over HTTPS.
    • Description
    • Refresh interval: how often the controller checks the remote catalog for updates
    • Remote Type: select from the drop-down list
    • Remote URL: provide the path to the catalog, the URL of the git repo where the catalog resides
    • Skip TLS Verify: by default, TLS verification is enabled; set this parameter to skip TLS verification
    • Title: provide the name of the catalog as you want it to appear in the Catalogs page
  4. Click Add to Transaction.

Managing a catalog

In the EDA UI, you can manage a catalog from the System Administration > Catalogs page.
Locate the catalog and at the end of its row, click the Table Row actions menu to select the action that you want to take.
You can take the following actions:
  • Add labels and annotations
  • View app details
  • Edit details about the catalog
  • Delete the catalog

    Before deleting a catalog, ensure that no apps are using it.