Post-Deployment Steps for HA
NEW IN 3.50.0
After you have completed your high availability (HA) deployment, there are a few steps you must take before you can fully use Sonatype Nexus Repository in its new HA environment.
Configuring Docker Repositories
As outlined in System Requirements for High Availability Deployments, if you plan to use more than one Docker repository, you must use one of the following:
- An external load balancer (e.g., NGINX) as a reverse proxy
- A Docker Subdomain Connector to route traffic to each Docker subdomain
We highly recommend using one of these two methods. However, if you do only plan to have one Docker repository and will use port connectors instead of one of the above methods, then you must do the following:
- Created the Docker repository in Sonatype Nexus Repository and specified a port (see our Docker format documentation).
- Fill out an Ingress for Docker YAML and a Docker Service YAML (samples provided below).
- Apply the Ingress for Docker YAML first.
- Apply the Docker Service YAML second.
The Ingress for Docker YAML exposes the Docker service so that it can be reached from outside the Kubernetes cluster (i.e., the service created by Docker Services YAML). The Docker Service YAML creates a Kubernetes service through which a Docker repository can be reached via an HTTP port.
Sample YAMLs can be found in the following locations:
The YAML files linked in this section are just examples and cannot be used as-is. You must fill them out with the appropriate information for your deployment to be able to use them.
Rebuild Metadata Tasks
After your deployment, you will need to run a task for each existing Apt, Helm, and Yum repository in order to rebuild their metadata:
- Apt - Rebuild Apt metadata for each Apt repository
- Helm - Rebuild Helm metadata for each Helm repository
- Repair - Rebuild Yum repository metadata (repodata) for each Yum repository
Rebuild Search Index Task
No action required; this is handled automatically as of release 3.51.0. We have provided the information below for your awareness.
As described in the Search Feature Differences section, HA uses different technology for its search behavior (SQL Search rather than Elasticsearch). Due to this change, Sonatype Nexus Repository must run a Repair - Rebuild repository search task for each hosted repository in your Sonatype Nexus Repository deployment. This will happen automatically once you migrate to HA and start Sonatype Nexus Repository and may take some time depending on the amount of data there is to process.