verdaccio/website/translated_docs/it/docker.md

id	title
docker	Docker


Per scaricare la più recente immagine docker pre costruita:

docker pull verdaccio/verdaccio

Versioni taggate

Dalla versione v2.x si possono ottenere immagini docker per tag, come segue:

Per una versione maggiore:

docker pull verdaccio/verdaccio:3

Per una versione minore:

docker pull verdaccio/verdaccio:3.0

Per una specifica (patch) versione:

docker pull verdaccio/verdaccio:3.0.1

Per la successiva maggiore release che utilizzi la versione beta (ramo master).

docker pull verdaccio/verdaccio:beta

Se si è interessati ad un elenco dei tag, si prega di visitare il sito Docker Hub.

Eseguire verdaccio utilizzando Docker

Per avviare il contenitore Docker:

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

L'ultimo argomento definisce quale immagine si utilizza. La riga sopra citata scaricherà da dockerhub l'ultima immagine pre costruita disponibile, se non ne è ancora stata creata una.

Se è stata costruita un'immagine localmente utilizzare verdaccio come ultimo argomento.

È possibile utilizzare -v per montare conf, storage e plugins nel filesystem degli host:

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

Nota: Verdaccio viene eseguito all'interno del contenitore come un utente non-root (uid=100, gid=101), se si utilizza bind mount per non tener conto delle impostazioni predefinite, è necessario assicurarsi che la cartella di mount venga assegnata all'utente corretto. Nell'esempio precedente, è necessario eseguire sudo chown -R 100:101 /opt/verdaccio altrimenti si presenteranno errori di permesso durante l'esecuzione. Si consiglia di utilizzare il volume di docker al posto di bind mount.

Estensioni

I plugin possono essere installati in una cartella separata e montati utilizzando Docker o Kubernetes, ad ogni modo assicurarsi di costruire plugin con dipendenze native adoperando la stessa immagine di base del Dockerfile di Verdaccio.

Configurazione di Docker e della porta personalizzata

Ogni host:port configurato in conf/config.yaml sotto a listen viene attualmente ignorato quando si utilizza docker.

Se si desidera raggiungere l'istanza docker di verdaccio da una porta differente, diciamo 5000, nel comando docker run sostituire -p 4873:4873 con -p 5000:4873.

Nel caso in cui sia necessario specificare quale porta ascoltare nel contenitore docker, dalla versione 2.?.? ciò è possibile fornendo argomenti supplementari a docker run: --env PORT=5000 Questo sostituisce la porta che il contenitore docker offre e la porta che verdaccio ascolta.

Naturalmente i numeri che vengono forniti al parametro -p devono combaciare, quindi, supponendo di volerli tutti uguali, questo è ciò che è possibile copiare, incollare ed adottare:

PORT=5000; docker run -it --rm --name verdaccio \
  --env PORT -p $PORT:$PORT
  verdaccio/verdaccio

Utilizzare HTTPS con Docker

È possibile configurare il protocollo che verdaccio andrà ad ascoltare, analogamente a come si configura la porta. È necessario sovrascrivere il valore predefinito ("http") della variabile ambientale del PROTOCOL con "https", dopo aver specificato i certificati nel config.yaml.

PROTOCOL=https; docker run -it --rm --name verdaccio \
  --env PROTOCOL -p 4873:4873
  verdaccio/verdaccio

Utilizzare docker-compose

1. Scaricare l'ultima versione di docker-compose.
2. Creare ed eseguire il contenitore:

$ docker-compose up --build

Si può definire la porta da utilizzare (sia per il contenitore che per l'host) anteponendo al comando precedente il prefisso PORT=5000.

Docker genererà un volume nominato nel quale immagazzinare i dati persistenti dell'applicazione. È possibile utilizzare docker inspect o docker volume inspect per rivelare l'ubicazione fisica del volume e modificare la configurazione, in questo modo:

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

Creare la propria immagine Docker

docker build -t verdaccio .

Esiste inoltre uno script npm per creare l'immagine docker, quindi si può anche fare:

npm run build:docker

Nota: Il primo build necessita di qualche minuto per creare perché ha bisogno di avviare npm install, e potrebbe impiegare lo stesso tempo ogni volta che si cambia un file che non sia elencato in .dockerignore.

Se si desidera utilizzare l'immagine docker su un raspberry pi o su un dispositivo compatibile, è altresì disponibile un dockerfile. Per creare un'immagine docker per raspberry pi eseguire:

npm run build:docker:rpi

Si prega di notare che per ognuno dei comandi docker sopra citati è necessario avere docker installato sul pc e l'eseguibile docker dovrebbe essere disponibile su $PATH.

Esempi Docker

Esiste una cartella separata che ospita configurazioni multiple per comporre immagini Docker con verdaccio, per esempio, come proxy inverso:

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

Build personalizzati di Docker

• docker-verdaccio-gitlab
• docker-verdaccio
• docker-verdaccio-s3 Contenitore privato di NPM che può eseguire il back up in s3
• docker-verdaccio-ldap
• verdaccio-ldap
• verdaccio-compose-local-bridge
• docker-verdaccio
• verdaccio-docker
• verdaccio-server
• coldrye-debian-verdaccio immagine docker che esegue verdaccio da coldrye-debian-nodejs.