Skip to main content

Docker

alt Docker Pulls Count

Para descargar la última imagen de Docker:

docker pull verdaccio/verdaccio

Docker pull

Versiones con Etiquetas

Desde la versión `` puedes obtener imagenes de docker por tag, de la siguiente manera:

Para usar una versión "major":

docker pull verdaccio/verdaccio:4

Para usar una versión "minor":

docker pull verdaccio/verdaccio:4.0

Para un (parche) especifico:

docker pull verdaccio/verdaccio:4.0.0

Si estas interesado en un listado de todos tags, por favor visite el sitio web de Docker Hub.

Running Verdaccio using Docker

Para ejecutar el contenedor docker:

docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio

The last argument defines which image to use. The above line will pull the latest prebuilt image from dockerhub, if you haven't done that already.

Si has construido una imagen localmente usa verdaccio como el último argumento.

Puede usar -v para montar conf, storage and plugins a archivos de sistema alojados:

V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \
-p 4873:4873 \
-v $V_PATH/conf:/verdaccio/conf \
-v $V_PATH/storage:/verdaccio/storage \
-v $V_PATH/plugins:/verdaccio/plugins \
verdaccio/verdaccio

if you are running in a server, you might want to add -d to run it in the background Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run sudo chown -R 10001:65533 /opt/verdaccio otherwise you will get permission errors at runtime. Usar el volumen docker es recomendado antes que usar el montaje de unión.

Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list:

PropiedaddefaultDescripción
VERDACCIO_APPDIR/opt/verdaccio-buildthe docker working directory
VERDACCIO_USER_NAMEverdacciothe system user
VERDACCIO_USER_UID10001the user id being used to apply folder permissions
VERDACCIO_PORT4873the verdaccio port
VERDACCIO_PROTOCOLhttpthe default http protocol

SELinux

If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files.

 fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file

If verdaccio can't read files on a bind-mounted directory and you are unsure, please check /var/log/audit/audit.log to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial.

type=AVC msg=audit(1606833420.789:9331): avc:  denied  { read } for  pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0

chcon can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to container_file_t.

$ chcon -Rt container_file_t ./conf

If you want to make the directory accessible only to a specific container, use chcat to specify a matching SELinux category.

An alternative solution is to use z and Z flags. To add the z flag to the mountpoint ./conf:/verdaccio/conf simply change it to ./conf:/verdaccio/conf:z. The z flag relabels the directory and makes it accessible by every container while the Z flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting /home/user or /var can mess up the labels on those directories and make the system unbootable.

Extensiones

Extensiones pueden ser instaladas en un directorio separado y montado usando Docker o Kubernetes, de todos modos debes asegurarte que construyes extensiones con dependencias nativas usando como base la imagen de Dockerfile Verdaccio.

FROM verdaccio/verdaccio

USER root

ENV NODE_ENV=production

RUN npm i && npm install verdaccio-s3-storage

USER verdaccio

Configuración de Docker y puerto de escucha por defecto

Any host:port configured in conf/config.yaml under listen is currently ignored when using docker.

Existe tambien un comando npm para construir la imagen de Docker, tambien puede hacerlo así:

V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \
-e "VERDACCIO_PORT=8080" -p 8080:8080 \
verdaccio/verdaccio

Of course the numbers you give to the -p parameter need to match.

Usando HTTPS con Docker

Puedes configurar el protocolo que verdaccio va a escuchar, similarmente que con la configuración del puerto. Tienes que anular el valor por defecto ("http") de la variable de ambiente a "https" de PROTOCOL, despues debe especificar los certificados en el config.yaml.

docker run -it --rm --name verdaccio \
--env "VERDACCIO_PROTOCOL=https" -p 4873:4873
verdaccio/verdaccio

Usando docker-compose

  1. Obtén la última versión de docker-compose.
  2. Construye y ejecuta el contenedor:
$ docker-compose up --build

You can set the port to use (for both container and host) by prefixing the above command with VERDACCIO_PORT=5000.

version: '3.1'

services:
verdaccio:
image: verdaccio/verdaccio
container_name: "verdaccio"
networks:
- node-network
environment:
- VERDACCIO_PORT=4873
ports:
- "4873:4873"
volumes:
- "./storage:/verdaccio/storage"
- "./config:/verdaccio/conf"
- "./plugins:/verdaccio/plugins"
networks:
node-network:
driver: bridge

Docker generará un volumen con nombre que persistira con los datos de la aplicación. Puedes usar docker inspect o docker volume inspect para revelar la ubicación física del volumen y editar la configuración, de la siguiente manera:

$ docker volume inspect verdaccio_verdaccio
[
{
"Name": "verdaccio_verdaccio",
"Driver": "local",
"Mountpoint": "/var/lib/docker/volumes/verdaccio_verdaccio/_data",
"Labels": null,
"Scope": "local"
}
]

Construye tu propia imagen de Docker

docker build -t verdaccio .

Existe un repositorio separado que aloja multiples configuraciones de imagenes Docker con verdaccio, por ejemplo, un servidor proxy a la inversa:

yarn run build:docker

Note: El primer build podria tomar algunos minutos para construir porque necesita ejecutar npm install, y podría tardar mas cuando los archivos no estan listados en .dockerignore.

Please note that for any of the above docker commands you need to have docker installed on your machine and the docker executable should be available on your $PATH.

Ejemplos con Docker

There is a separate repository that hosts multiple configurations to compose Docker images with verdaccio, for instance, as reverse proxy:

https://github.com/verdaccio/docker-examples

Imágenes de Docker Personalizadas

If you have made an image based on Verdaccio, feel free to add it to this list.