Nexus OSS is a free open source repository manager. It supports a wide range of package formats and it's used by hundreds of tech companies.
This chart bootstraps a Nexus OSS deployment on a cluster using Helm. This setup is best configured in GCP since:
- google cloud storage is used for backups
- GCE Ingress controller is used for using a pre-allocated static IP in GCE.
There is also the option of using a proxy for Nexus that authenticates Nexus against an external identity provider (only GCP IAM at the moment) which is disabled by default.
- Kubernetes 1.8+ with Beta APIs enabled
- PV provisioner support in the underlying infrastructure
- Fulfill Nexus kubernetes requirements
All the Prerequisites should be in place, plus:
To test the chart:
helm install --dry-run --debug ./To test the chart with your own values:
helm install --dry-run --debug -f my_values.yaml ./To install the chart:
helm repo add oteemocharts https://oteemo.github.io/charts
helm install sonatype-nexus oteemocharts/sonatype-nexusThe above command deploys Nexus on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.
The default login is admin/admin123
To uninstall/delete the deployment:
$ helm list
NAME REVISION UPDATED STATUS CHART NAMESPACE
plinking-gopher 1 Fri Sep 1 13:19:50 2017 DEPLOYED sonatype-nexus-0.1.0 default
$ helm delete plinking-gopherThe command removes all the Kubernetes components associated with the chart and deletes the release.
There are known issues with backups on the official image. If you want to swap in the official image, just override the values when installing the chart. Please note that backups will not work as expected with the official image.
The following table lists the configurable parameters of the Nexus chart and their default values.
| Parameter | Description | Default |
|---|---|---|
statefulset.enabled |
Use statefulset instead of deployment | false |
replicaCount |
Number of Nexus service replicas | 1 |
deploymentStrategy |
Deployment Strategy | rollingUpdate |
nexus.imageName |
Nexus image | quay.io/travelaudience/docker-nexus |
nexus.imageTag |
Version of Nexus | 3.21.2-03 |
nexus.imagePullPolicy |
Nexus image pull policy | IfNotPresent |
nexus.imagePullSecret |
Secret to download Nexus image from private registry | nil |
nexus.env |
Nexus environment variables | [{install4jAddVmParams: -Xms1200M -Xmx1200M -XX:MaxDirectMemorySize=2G -XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap}] |
nexus.resources |
Nexus resource requests and limits | {} |
nexus.dockerPort |
Port to access docker | 5003 |
nexus.nexusPort |
Internal port for Nexus service | 8081 |
nexus.service.type |
Service for Nexus | CluserIP |
nexus.service.clusterIp |
Specific cluster IP when service type is cluster IP. Use None for headless service | nil |
nexus.service.loadBalancerIP |
Custom loadBalancerIP | nil |
nexus.securityContextEnabled |
Security Context (for enabling official image use fsGroup: 200) |
{} |
nexus.labels |
Service labels | {} |
nexus.podAnnotations |
Pod Annotations | {} |
nexus.livenessProbe.initialDelaySeconds |
LivenessProbe initial delay | 30 |
nexus.livenessProbe.periodSeconds |
Seconds between polls | 30 |
nexus.livenessProbe.failureThreshold |
Number of attempts before failure | 6 |
nexus.livenessProbe.timeoutSeconds |
Time in seconds after liveness probe times out | nil |
nexus.livenessProbe.path |
Path for LivenessProbe | / |
nexus.readinessProbe.initialDelaySeconds |
ReadinessProbe initial delay | 30 |
nexus.readinessProbe.periodSeconds |
Seconds between polls | 30 |
nexus.readinessProbe.failureThreshold |
Number of attempts before failure | 6 |
nexus.readinessProbe.timeoutSeconds |
Time in seconds after readiness probe times out | nil |
nexus.readinessProbe.path |
Path for ReadinessProbe | / |
nexus.hostAliases |
Aliases for IPs in /etc/hosts | [] |
nexusProxy.enabled |
Enable nexus proxy | true |
nexusProxy.svcName |
Nexus proxy service name | nil |
nexusProxy.targetPort |
Container Port for Nexus proxy | 8080 |
nexusProxy.port |
Port for exposing Nexus | 8080 |
nexusProxy.imageName |
Proxy image | quay.io/travelaudience/docker-nexus-proxy |
nexusProxy.imageTag |
Proxy image version | 2.6.0 |
nexusProxy.imagePullPolicy |
Proxy image pull policy | IfNotPresent |
nexusProxy.resources |
Proxy resource requests and limits | {} |
nexusProxy.env.nexusHttpHost |
Nexus url to access Nexus | nil |
nexusProxy.env.nexusDockerHost |
Containers url to be used with docker | nil |
nexusProxy.env.enforceHttps |
Allow only https access or not | false |
nexusProxy.env.cloudIamAuthEnabled |
Enable GCP IAM authentication in Nexus proxy | false |
nexusProxyRoute.enabled |
Set to true to create route for additional service | false |
nexusProxyRoute.labels |
Labels to be added to proxy route | {} |
nexusProxyRoute.annotations |
Annotations to be added to proxy route | {} |
nexusProxyRoute.path |
Host name of Route e.g jenkins.example.com | nil |
persistence.enabled |
Create a volume for storage | true |
persistence.accessMode |
ReadWriteOnce or ReadOnly | ReadWriteOnce |
persistence.storageClass |
Storage class of Nexus PVC | nil |
persistence.storageSize |
Size of Nexus data volume | 8Gi |
persistence.annotations |
Persistent Volume annotations | {} |
persistence.existingClaim |
Existing PVC name | nil |
nexusBackup.enabled |
Nexus backup process | false |
nexusBackup.imageName |
Nexus backup image | quay.io/travelaudience/docker-nexus-backup |
nexusBackup.imageTag |
Nexus backup image version | 1.5.0 |
nexusBackup.imagePullPolicy |
Backup image pull policy | IfNotPresent |
nexusBackup.env.targetBucket |
Required if nexusBackup is enabled. Google Cloud Storage bucker for backups format gs://BACKUP_BUCKET |
nil |
nexusBackup.nexusAdminPassword |
Nexus admin password used by the backup container to access Nexus API. This password should match the one that gets chosen by the user to replace the default admin password after the first login | admin123 |
nexusBackup.persistence.enabled |
Create a volume for backing Nexus configuration | true |
nexusBackup.persistence.accessMode |
ReadWriteOnce or ReadOnly | ReadWriteOnce |
nexusBackup.persistence.storageClass |
Storage class of Nexus backup PVC | nil |
nexusBackup.persistence.storageSize |
Size of Nexus backup data volume | 8Gi |
nexusBackup.persistence.annotations |
PV annotations for backup | {} |
nexusBackup.persistence.existingClaim |
Existing PVC name for backup | nil |
nexusBackup.resources |
Backup resource requests and limits | {} |
ingress.enabled |
Create an ingress for Nexus | false |
ingress.annotations |
Annotations to enhance ingress configuration | {} |
ingress.tls.enabled |
Enable TLS | true |
ingress.tls.secretName |
Name of the secret storing TLS cert, false to use the Ingress' default certificate |
nexus-tls |
ingress.path |
Path for ingress rules. GCP users should set to /* |
/ |
tolerations |
tolerations list | [] |
config.enabled |
Enable configmap | false |
config.mountPath |
Path to mount the config | /sonatype-nexus-conf |
config.data |
Configmap data | nil |
deployment.annotations |
Annotations to enhance deployment configuration | {} |
deployment.initContainers |
Init containers to run before main containers | nil |
deployment.postStart.command |
Command to run after starting the nexus container | nil |
deployment.additionalContainers |
Add additional Container | nil |
deployment.additionalVolumes |
Add additional Volumes | nil |
deployment.additionalVolumeMounts |
Add additional Volume mounts | nil |
secret.enabled |
Enable secret | false |
secret.mountPath |
Path to mount the secret | /etc/secret-volume |
secret.readOnly |
Secret readonly state | true |
secret.data |
Secret data | nil |
service.enabled |
Enable additional service | nil |
service.name |
Service name | nil |
service.portName |
Service port name | nil |
service.labels |
Service labels | nil |
service.annotations |
Service annotations | nil |
service.loadBalancerSourceRanges |
Service LoadBalancer source IP whitelist | nil |
service.loadBalancerIP |
Custom loadBalancerIP | nil |
service.targetPort |
Service port | nil |
service.port |
Port for exposing service | nil |
serviceAccount.create |
Automatically create a service account | true |
serviceAccount.name |
Service account to use | nil |
serviceAccount.annotations |
Service account annotations | nil |
route.enabled |
Set to true to create route for additional service | false |
route.name |
Name of route | docker |
route.portName |
Target port name of service | docker |
route.labels |
Labels to be added to route | {} |
route.annotations |
Annotations to be added to route | {} |
route.path |
Host name of Route e.g jenkins.example.com | nil |
additionalConfigMaps |
List of ConfigMap data containing Name, Data and Labels | nil |
If nexusProxy.env.cloudIamAuthEnabled is set to true the following variables need to be configured
| Parameter | Description | Default |
|---|---|---|
nexusProxy.env.clientId |
GCP OAuth client ID | nil |
nexusProxy.env.clientSecret |
GCP OAuth client Secret | nil |
nexusProxy.env.organizationId |
GCP organization ID | nil |
nexusProxy.env.redirectUrl |
OAuth callback url. example https://nexus.example.com/oauth/callback |
nil |
nexusProxy.env.requiredMembershipVerification |
Whether users presenting valid JWT tokens must still be verified for membership within the GCP organization. | true |
nexusProxy.secrets.keystore |
base-64 encoded value of the keystore file needed for the proxy to sign user tokens. Example: cat keystore.jceks | base64 | nil |
nexusProxy.secrets.password |
Password to the Java Keystore file | nil |
helm install --set persistence.enabled=false my-release stable/sonatype-nexusThe above example turns off the persistence. Data will not be kept between restarts or deployments
Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,
helm install -f my-values.yaml sonatype-nexus stable/sonatype-nexusBy default a PersistentVolumeClaim is created and mounted into the /nexus-data directory. In order to disable this functionality
you can change the values.yaml to disable persistence which will use an emptyDir instead.
"An emptyDir volume is first created when a Pod is assigned to a Node, and exists as long as that Pod is running on that node. When a Pod is removed from a node for any reason, the data in the emptyDir is deleted forever."
You must enable StatefulSet (statefulset.enabled=true) for true data persistence. If using Deployment approach, you can not recover data after restart or delete of helm chart. Statefulset will make sure that it picks up the same old volume which was used by the previous life of the nexus pod, helping you recover your data. When enabling statefulset, its required to enable the persistence.
As a minimum for running in production, the following settings are advised:
nexusProxy:
env:
nexusDockerHost: container.example.com
nexusHttpHost: nexus.example.com
nexusBackup:
env:
targetBucket: "gs://my-nexus-backup"
persistence:
storageClass: standard
ingress:
enabled: true
annotations:
kubernetes.io/ingress.class: gce
kubernetes.io/tls-acme: true
persistence:
storageClass: standard
storageSize: 1024Gi
resources:
requests:
cpu: 250m
# Based on https://support.sonatype.com/hc/en-us/articles/115006448847#mem
# and https://twitter.com/analytically/status/894592422382063616:
# Xms == Xmx
# Xmx <= 4G
# MaxDirectMemory >= 2G
# Xmx + MaxDirectMemory <= RAM * 2/3 (hence the request for 4800Mi)
# MaxRAMFraction=1 is not being set as it would allow the heap
# to use all the available memory.
memory: 4800MiAfter installing the chart a couple of actions need still to be done in order to use nexus. Please follow the instructions below.
The following steps need to be executed in order to use Nexus:
and if GCP IAM authentication is enabled, please also check:
To see how to use Nexus with different tools like Docker, Maven, Python, and so on please check:
In a disaster recovery scenario, the latest backup made by the nexus-backup container should be restored. In order to achieve this please follow the procedure described below: