This is a lightweight artifacts repository with low memory footprint which can be used as a minimal replacement for Nexus. It is able to cache artifacts from a remote repository on a local filesystem volume and also to store them on a cloud storage bucket via go-cloud.
It can be deployed either as a side-car container to a Kubernetes build pod or as a standalone service.
The default configuration enables only the local file cache:
http:
addr: ":8080"
storage:
enabled: false
bucket_url: "gs://bucketrepo"
cache:
base_dir: "/tmp/bucketrepo"
repositories:
- url: "https://repo1.maven.org/maven2"
- url: "http://uk.maven.org/maven2/"
The header (for example Bearer token authentication) and timeout can be modified for every remote repository:
...
repositories:
- url: "https://repo1.maven.org/maven2"
timeout: "30s"
- url: "http://uk.maven.org/maven2/"
- url: "http://my.private.maven.repo"
timeout: "10s"
header:
Authorization: "Bearer <Token>"
The cloud storage can be enabled by providing a bucket URL:
storage:
enabled: true
bucket_url: "gs://mybucket"
# if necessary is possible to use Path prefix
prefix: "myfolder"
Also the TLS and basic authentication can be configured with:
http:
addr: ":8080"
https: true
crt: "/certs/domain.crt"
key: "/certs/domain.key"
username: "myuser"
password: "mypassword"
Note that the basic authentication is turned off when HTTPS is disabled.
This repository has been tested with maven
and helm
tools, but it can also store other artifacts.
The repository service can be installed in a Kubernetes cluster using helm. First, you need to add the jenkins-x chart repository to your helm repositories:
helm repo add jenkins-x http://chartmuseum.jenkins-x.io
helm repo update
You can now install the chart with:
helm install jenkins-x/bucketrepo --name bucketrepo
The repository can be started in a docker container usinged the latest released image:
docker run -v $(pwd)/config:/config -p 8080:8080 gcr.io/jenkinsxio/bucketrepo:0.1.12 -config-path=/config
Or it can be built and run with:
make build
bin/bucketrepo -config-path=config -log-level=debug
bucketrepo
can be configured as a mirror by adding the following in ~/.m2/settings.xml
file:
<settings>
<mirrors>
<mirror>
<id>bucketrepo</id>
<name>bucketrepo- mirror</name>
<url>http://localhost:8080/bucketrepo/</url>
<mirrorOf>*</mirrorOf>
</mirror>
</mirrors>
</settings>
And as a repository by adding the following in the pom.xml
file:
<repositories>
<repository>
<id>bucketrepo</id>
<url>http://localhost:8080/bucketrepo/</url>
</repository>
</repositories>
<distributionManagement>
<snapshotRepository>
<id>snapshots</id>
<url>http://localhost:8080/bucketrepo/deploy/maven-snapshots/</url>
</snapshotRepository>
<repository>
<id>releases</id>
<url>http://localhost:8080/bucketrepo/deploy/maven-releases/</url>
</repository>
</distributionManagement>
This project is originally based on nexus-minimal. Thank you atsman for creating that project.