Skip to main content
Version: Next

How to Enable Nexus Repository Manager

This guide walks you through how to enable Nexus Repository Manager.

note

These tasks are intended to be completed as a system integrator.

Prerequisites​

  • Structsure Package
  • Structsure IaC Bundle
  • kubectl configured to interact with your cluster

Step 1: Enable Nexus IaC​

note

More details about configuring IaC can be found here.

Enabling the Nexus IaC will provision and configure Nexus Repository Manager for S3 and optionally RDS.

In the infra env.hcl, enable the nexus module:

locals {
  modules = {
    nexus = true
  }

  nexus_repository_manager_inputs = {
    nexus_pro_version_enabled = true # If you have a license, you can enable this to turn on RDS
  }
}

Step 2: Configure Structsure Package​

note

More details about installation options can be found here.

Nexus Repository Manager is disabled by default in Structsure. To enable it, add the following to the Zarf config file:

package:
  deploy:
    set:
      NEXUS_REPOSITORY_MANAGER_ENABLED: true

Step 3 (Optional): Configure License​

A Nexus Repository Manager licence is required in order to use RDS and SSO. The following is an example of how to provide the license via Big Bang secret values:

addons:
  nexusRepositoryManager:
    license_key: <base64-encoded contents of license file>

Step 4: Log in to Nexus Repository Manager​

The initial admin password is available in a Kuberenetes secret in the nexus-repository-manager namespace. Kubernetes secrets are base64 encoded, so the password can be retrieved with the following command:

kubectl get secret nexus-repository-manager-secret -n nexus-repository-manager --template='{{index .data "admin.password" | base64decode }}'

The URL to Nexus Repository Manager can be found in the Virtual Services in the nexus-repository-manager namespace.

Running the command kubectl get virtualservice -n nexus-repository-manager should return something similar to:

NAME                       GATEWAYS                  HOSTS                           AGE
nexus-repository-manager   ["istio-system/public"]   ["nexus.10-32-19-210.nip.io"]   174m

Be sure to prepend the host with https://.

Upon visiting the URL, you can log in with the admin user and the password retrieved above.

Upon first log in, you will be prompted to change the password and update some initial settings. It is highly recommended to disable anonymous access when prompted.

Step 5: Locating S3 Blob Store and Repository​

While logged in as an admin, go to the admin panel by clicking the gear icon at the top of the page. From here, the blob store and repository settings can be viewed. There should be a blob store of type S3 and a repository configured to use the blob store.