mbacodes / docker-nexus3

Dockerized version of Nexus Repo Manager 3

sonatype/docker-nexus3

A Dockerfile for Sonatype Nexus Repository Manager 3, based on CentOS.

• Notes
  • Persistent Data
• Getting Help

To run, binding the exposed port 8081 to the host.

$ docker run -d -p 8081:8081 --name nexus sonatype/docker-nexus3

To test:

$ curl -u admin:admin123 http://localhost:8081/service/metrics/ping

To (re)build the image:

Copy the Dockerfile and do the build-

$ docker build --rm=true --tag=sonatype/docker-nexus3 .

Notes

• Default credentials are: admin / admin123 (Can be changed using the environment variables NEXUS_DEFAULT_PASSWORD and NEXUS_PASSWORD.)

• It can take some time (2-3 minutes) for the service to launch in a new container. You can tail the log to determine once Nexus is ready:

$ docker logs -f nexus

• Installation of Nexus is to /opt/sonatype/nexus.

• A persistent directory, /nexus-data, is used for configuration, logs, and storage. This directory needs to be writable by the Nexus process, which runs as UID 200.

• Three environment variables can be used to control the JVM arguments

  • JAVA_MAX_MEM, passed as -Xmx. Defaults to 1200m.

  • JAVA_MIN_MEM, passed as -Xms. Defaults to 1200m.

  • EXTRA_JAVA_OPTS. Additional options can be passed to the JVM via this variable.

  These can be used supplied at runtime to control the JVM:

  $ docker run -d -p 8081:8081 --name nexus -e JAVA_MAX_MEM=768m sonatype/docker-nexus3
  

• Another environment variable can be used to control the Nexus Context Path

  • NEXUS_CONTEXT, defaults to /

  This can be supplied at runtime:

  $ docker run -d -p 8081:8081 --name nexus -e NEXUS_CONTEXT=nexus sonatype/docker-nexus3
  

Docker Registry

To configure a Docker Registry from start on, use the environment variables DOCKER_REPOSITORY_NAME and DOCKER_REPOSITORY_PORT. A startup script located at /usr/local/bin/config.sh makes use of the api to postprocessing your config.

Docker compose

For your convenience use docker compose to start nexus as shown below:

 nexus:
    build: .
    network_mode: "bridge"
    environment:
      - DOCKER_REPOSITORY_NAME=default
      - DOCKER_REPOSITORY_PORT=5000
      - NEXUS_DEFAULT_PASSWORD=admin123
      - NEXUS_PASSWORD=changeme
    ports:
      - 5000:5000
      - 8081:8081
    volumes:
      - /data/nexus:/nexus-data
    restart: always

Persistent Data

There are two general approaches to handling persistent storage requirements with Docker. See Managing Data in Containers for additional information.

1. Use a data volume. Since data volumes are persistent until no containers use them, a volume can be created specifically for this purpose. This is the recommended approach.

$ docker volume create --name nexus-data
$ docker run -d -p 8081:8081 --name nexus -v nexus-data:/nexus-data sonatype/docker-nexus3

2. Mount a host directory as the volume. This is not portable, as it relies on the directory existing with correct permissions on the host. However it can be useful in certain situations where this volume needs to be assigned to certain specific underlying storage.

$ mkdir /some/dir/nexus-data && chown -R 200 /some/dir/nexus-data
$ docker run -d -p 8081:8081 --name nexus -v /some/dir/nexus-data:/nexus-data sonatype/docker-nexus3

Getting Help

Looking to contribute to our Docker image but need some help? There's a few ways to get information or our attention:

• File a public issue here on GitHub
• Check out the Nexus3 tag on Stack Overflow
• Pop into our public HipChat room and ask us some questions
• Check out the Nexus Repository User List