Chapter 5. Enabling the Image Registry tab


When you create your application, Red Hat Developer Hub should display the Image Registry tab on your component’s page. This tab provides useful information about your container images stored in your artifact registry. However, in some cases, the tab isn’t displayed and here’s why.

RHTAP attempts to detect your artifact registry type by analyzing the URL. If the URL contains “quay”, “jfrog” or “artifactory”, RHTAP adds a corresponding annotation to the catalog-info.yaml file in the Git repository with your application. RHDH uses this information to annotate Catalog entries and then correctly displays the Image Registry tab.

However, if your registry URL doesn’t include “quay”, “jfrog” or “artifactory”, RHTAP cannot detect your registry type and annotate your components correctly. As a result, the Image Registry tab isn’t enabled in RHDH.

If the Image Registry tab is missing in the RHDH UI, you can manually enable it. You have 2 options:

  1. Enable the tab for a single existing component.
  2. Modify the registry detection script, and all new components will be automatically annotated correctly.

Option 1: Enabling the Image Registry tab for the existing component

Repeat this procedure for every affected component.

Procedure

  1. In the Git repository with your component, navigate to skeleton > source-repo and open the catalog-info.yaml file.
  2. Add an annotation relevant to your case:

    metadata:
        annotations:
            'quay.io/repository-slug': `<ORGANIZATION>/<REPOSITORY>'
    metadata:
        annotations:
            'jfrog-artifactory/image-name': '<IMAGE-NAME>'
  3. Commit and push the changes to the repository.

RHDH will detect your registry type and enable the Image Registry tab.

Verification

Select an RHTAP component where the Image Registry tab was missing. The tab menu should display it now.

Figure 5.1. The Image Registry tab displayed

imageregistry

Option 2: Enabling the Image Registry tab for all future components

The RHTAP software templates use specific patterns to identify the registry type, Quay or JFrog Artifactory. If your registry does not match these patterns, you can update the catalog-info.yaml file in the templates, and RHTAP will automatically detect your registry type for all future components and annotate them correctly for RHDH.

Prerequisites

Procedure

  1. In a GitHub repository with your templates, navigate to skeleton > source-repo and open the catalog-info.yaml file.
  2. Find code related to registry detection:

      {%- if "quay" in values.image %}
        quay.io/repository-slug: ${{ values.repoSlug }}
    
      {%- elif "jfrog" in values.image or "artifactory" in values.image %}
        jfrog-artifactory/image-name: ${{ values.imageName }}
  3. Replace "quay", "jfrog" or "artifactory" with a part of the URL of your registry.

    For example, if your Artifactory registry is called my-registry.mycompany.com, then your images names may be my-registry.mycompany.com/username/my-image. You can add my-registry.mycompany to catalog-info.yaml.

The updated template will automatically trigger correct annotations, and the Image Registry tab will be displayed in RHDH.





Revised on 2025-04-30 03:56:00 UTC

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.