Chapter 4. Enable and configure the Nexus Repository Manager plugin

Prerequisites

• You have a running Nexus Repository Manager instance.

Procedure

• Add the following configuration to your dynamic-plugins.yaml file to enable the plugin and configure its frontend mount point:

  plugins:
    - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-nexus-repository-manager:<tag>
      disabled: false
      pluginConfig:
        dynamicPlugins:
          frontend:
            backstage-community.plugin-nexus-repository-manager:
              mountPoints:
                - mountPoint: entity.page.image-registry/cards
                  importName: NexusRepositoryManagerPage
                  config:
                    layout:
                      gridColumn: 1 / -1
                    if:
                      anyOf:
                        - isNexusRepositoryManagerAvailable

  where:

  <tag>

  Enter your RHDH version of Backstage and the plugin version, in the format bs_<backstage-version>__<plugin-version> (note the double underscore delimiter). To find these versions, complete the following steps:

  1. Find your Backstage version in the RHDH release notes preface.

  2. Locate the plugin version in the Dynamic Plugins Reference guide. For example, for RHDH 1.10 based on Backstage 1.49.4, use the format bs_1.49.4__<plugin-version>.

     Tip

     To ensure environment stability, use a SHA256 digest instead of a version tag. See Determining SHA256 Digests.

     where:

  pluginConfig

  Configures how the frontend component renders in Developer Hub.

  mountPoint: entity.page.image-registry/cards

  Mounts the artifact view on the Image Registry tab of the entity page.

  importName: NexusRepositoryManagerPage

  The frontend component that displays artifact information.

  isNexusRepositoryManagerAvailable

  A condition that renders the component only for entities that have Nexus Repository Manager annotations.