n3dr

Backup or Migrate your entire Nexus Artifact Server

Download all artifacts at once or migrate automatically from Nexus to Nexus.

Without n3dr it is not possible to download all artifacts from Nexus at once. n3dr makes it possible to easily migrate a Nexus server from AWS to Azure or Google Cloud.

The aims of the n3dr tool are:

• to backup all artifacts from a certain Nexus maven repository.
• to migrate all artifacts from NexusA to NexusB.

Installation

Linux

snap install n3dr

MaxOS

brew install n3dr

Windows

choco install n3dr

Configuration

N3DR download user

Create a user, e.g. n3dr-download in Nexus3, create a role, e.g. n3dr-download and assign the following roles:

• nx-repository-view-*-*-browse
• nx-repository-view-*-*-read

N3DR upload user

In order to upload artifacts, additional privileges are required:

• nx-repository-view-*-*-add
• nx-repository-view-*-*-edit

Usage

Check the help menu

user@computer:~/dev$ ./n3dr-linux -h
N3DR is a tool that is able to download all artifacts from
a certain Nexus3 repository.

Usage:
  n3dr [command]

Available Commands:
  backup       Backup all artifacts from a Nexus3 repository
  help         Help about any command
  repositories Count the number of repositories or return their names
  upload       Upload all artifacts to a specific Nexus3 repository

Flags:
  -v, --apiVersion string   The Nexus3 APIVersion, e.g. v1 or beta (default "v1")
  -d, --debug               Enable debug logging
  -h, --help                help for n3dr
      --insecureSkipVerify  Skip repository certificate check
  -p, --n3drPass string     The Nexus3 password
  -n, --n3drURL string      The Nexus3 URL
  -u, --n3drUser string     The Nexus3 user
  -z, --zip                 Add downloaded artifacts to a ZIP archive

Use "n3dr [command] --help" for more information about a command.

Store the password in a read-only file

Define the password in ~/.n3dr.yaml:

---
n3drPass: admin123

and set the permissions to 400 by issuing:

chmod 400 ~/.n3dr.yaml

Backup artifacts from a certain repository

All artifacts from a repository will be stored in a download folder when the following command is run:

./n3dr-linux backup -u admin -n http://localhost:8081 -r maven-releases

Backup all repositories

All artifacts from various repositories will be stored in a download folder when the following command is issued:

./n3dr-linux repositories -u admin -n http://localhost:8081 -b

Note: a new folder will be created for every repository:

• download/maven-public
• download/maven-releases

Backup only certain artifacts

It is possible to only download artifacts that match a regular expression. If one would like to download all artifacts from ‘some/group42’ then one could do that as follows:

./n3dr-linux backup -u admin -n http://localhost:8081 -r maven-releases -x 'some/group42'

If one would like to deploy is while download from all repositories then use the -x option as well:

./n3dr-linux repositories -u admin -n http://localhost:8081 -b -x 'some/group42'

Add all downloaded archives to a ZIP archive

In order to add all archives to a zip archive, one has to use the –zip or -z flag.

Upload all artifacts to a certain repository

It is possible to upload all JARs that reside in a folder by running the following command:

./n3dr-linux upload -u admin -n http://localhost:8081 -r maven-public

“Clone” a Nexus3 repository

Suppose that one has created a new Nexus3 repository, e.g. NexusNEW and that one would like to copy the content of the old repository, e.g. NexusOLD, then these basic steps could be issued to “clone” NexusOLD:

n3dr backup -u <old-nexus3-user> -n <old-nexus3-server-url> \
-r <old-repo-source-name>
cd download
mv <old-repo-source-name> <new-repo-target-name>
n3dr upload -u <new-target-nexus3-user> -n <new-target-nexus3-server-url> \
-r <new-repo-target-name>

Backup to OCI Object Storage

n3dr supports backing up to OCI Object Storage. To enable this option you need to

• Configure OCI environment and secrets locally: https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/sdkconfig.htm
• Add following options to ~/.n3dr.yaml:

  ociBucket: nexus_dev_archives
  

If you want to remove local copies (after object has been uploaded) add following to ~/.n3dr.yaml:

removeLocalFile: true

Rationale for N3DR

Although there is a number of equivalent tools:

• https://github.com/RiotGamesMinions/nexus_cli
• https://github.com/packagemgmt/repositorytools
• https://github.com/thiagofigueiro/nexus3-cli

None of them seems to be able to backup all repositories by running a single command.

Stargazers over time