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.
  1. From the System Administration navigation panel, select Catalogs.
  2. Click Create.
  3. Provide the following metadata for this resource:
    • name
    • labels
    • annotations
  4. 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
  5. Click Commit to commit your change immediately or click Add To Transaction to add this item to transactions to commit later.

Managing a catalog

  1. From the System Administration navigation panel, click Catalogs.
  2. Locate the catalog and click the action that you want to take from Table row actions menu.
    You can take the following actions:
    • view details about the catalog
    • edit details about the catalog
    • duplicate the catalog
    • delete the catalog

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

  3. Click Commit to commit your change immediately or click Add To Transaction to add this item to transactions to commit later.