A verdaccio plugin for storing data in Minio
npm install verdaccio-minio!GitHub
!GitHub issues



!npm
A verdaccio plugin for storing data in Minio.
You can use this plugin by installing it globally:
``shInstall the package globally
$ yarn global add verdaccio-minio
Then you'll need to provide a configuration file for the minio storage :
`yaml
This points to the plugin folder above
plugins: /verdaccio/pluginsThis is mandatory, otherwise verdaccio won't boot
storage: /verdaccio/storage/dataHere's the plugin configuration option
store:
minio:
# The HTTP port of your minio instance
port: 9000 # The endpoint on which verdaccio will access minio (without scheme)
endPoint: minio.minio.svc.cluster.local
# The minio access key
accessKey: this-is-not-so-secret
# The minio secret key
secretKey: this-is-not-so-secret
# Disable SSL if you're accessing minio directly through HTTP
useSSL: false
# The region used by your minio instance (optional, default to "us-east-1")
region: eu-west-1
# A bucket where verdaccio will store it's database & packages (optional, default to "verdaccio")
bucket: 'npm'
# Number of retry when a request to minio fails (optional, default to 10)
retries: 3
# Delay between retries (optional, default to 100)
delay: 50
The rest of the verdaccio configuration
`Once this is done you can start your Verdaccio instance, and check minio to see that the bucket as been created automatically
Docker
A docker image is also available for easy deployments. With docker compose :
`yaml
version: '3.7'services:
verdaccio:
image: barolab/verdaccio
ports:
- 4873:4873
volumes:
- ./config.yaml:/verdaccio/conf/config.yaml
- ./htpasswd:/verdaccio/storage/htpasswd
depends_on:
- minio
environment:
VERDACCIO_PROTOCOL: http
VERDACCIO_PORT: 4873
minio:
image: minio/minio:RELEASE.2020-02-07T23-28-16Z
command: server /data
volumes:
- minio:/data
ports:
- 9000:9000
environment:
MINIO_ACCESS_KEY: this-is-not-so-secret
MINIO_SECRET_KEY: this-is-not-so-secret
volumes: minio:
`> You'll need to write your config file and your htpasswd for the above to work.
If you'd like to check K8S resources I highly recommend you look at the Minio and Verdaccio Helm charts.
Contributing
It's highly recommended that you install the git hooks in your workstation before committing anything to this repository. You can run
yarn hooks to install them.
There's some documentation for contributors that you should read first :- Code of Conduct
- Contribution Guide
You'll need docker & yarn for a better development experience with this module. You can run
yarn start to start a minio & verdaccio containers on ports 9000 and 4873. Then using the /example` folder you can install dependencies using verdaccio as a proxy.