Salta al contenuto principale
Versione: 5.x

Installazione

Verdaccio è un registro proxy privato in Node.js. Per installarla, necessiti di alcuni prerequisiti fondamentali.

Prerequisiti​

  1. Node.js v14 or higher.

  2. Il tuo Gestore di Pacchetti di Node npm, pnpm o yarn (classic e berry).

Consigliamo vivamente di usare le ultimi versioni dei client del Gestore di Pacchetti di Node > npm@6.x | yarn@1.x | | yarn@2.x | pnpm@6.x. Non supportiamo npm@5.x o precedente.

  1. Un browser web moderno per eseguire l'interfaccia web. Correntemente supportiamo Chrome, Firefox ed Edge.

Verdaccio supporterà l'ultima versione di Node.js in base ai consigli del Gruppo di Lavoro della Release di Node.js.

Usi ancora Verdaccio 4?. Controlla la guida di migrazione.

Introduzione Rapida​

Impara le basi prima di iniziare, come installarlo, dov'è la posizione del file di configurazione e altro.

Installare la CLI​

Prima di usare Verdaccio in produzione, sei pregato di leggere ed esser consapevole delle migliori pratiche.

Verdaccio dev'essere installato globalmente utilizzando uno dei seguenti metodi:

Utilizzando npm

npm install --location=global verdaccio

o utilizzando yarn

yarn global add verdaccio

o utilizzando pnpm

pnpm install -g verdaccio

install verdaccio

Prossima release principale (Verdaccio 6 alpha)​

La prossima release principale è in via di sviluppo, ma puoi già provarla, per scopi di test o per aiutarci a trovare qualsiasi possibile bug; se trovi qualcosa, segnalalo sotto l'etichetta 6.x bugs.

npm install --location=global verdaccio@7-next

o con l'immagine del docker

docker pull verdaccio/verdaccio:nightly-master

L'immagine del docker verdaccio/verdaccio:nightly-master è allineata agli ultimi commit nel ramo principale, mentre la versione di npmjs ha un ciclo di release di durata maggiore. Consigliamo vivamente di non utilizzare le versioni alpha per la produzione.

Uso di Base​

Una volta installata, devi soltanto eseguire il seguente comando della CLI:

$> verdaccio
warn --- config file  - /home/.config/verdaccio/config.yaml
warn --- http address - http://localhost:4873/ - verdaccio/5.0.0

Per ulteriori informazioni sulla CLI, sei pregato di leggere la sezione dedicata.

Puoi impostare il registro utilizzando il seguente comando.

npm set registry http://localhost:4873/

puoi passare un flag a --registry, quando necessario.

npm install --registry http://localhost:4873

definisci un campo registry nel tuo .npmrc.

.npmrc
registry=http://localhost:4873

O un publishConfig nel tuo package.json

{
  "publishConfig": {
    "registry": "http://localhost:4873"
  }
}

Per le configurazioni alternative, sei pregato di leggere la sezione Utilizzare un registro privato.

Tutorial Creare il Tuo Pacchetto NPM Privato​

Se vorresti una spiegazione più ampia, non perderti il tutorial creato da thedevlife su come Creare il Tuo Pacchetto NPM Privato utilizzando Verdaccio.

Immagine del Docker​

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

Verdaccio ha un'immagine del docker ufficiale che puoi utilizzare e, in gran parte dei casi, la configurazione predefinita va abbastanza bene. Per ulteriori informazioni su come installare l'immagine ufficiale, leggi la sezione dedicata; inoltre, puoi imparare di più sulla combinazione delle immagini del Docker nella nostra repository docker-examples.

Chart di Helm​

$ helm repo add verdaccio https://charts.verdaccio.org
$ helm repo update
$ helm install verdaccio/verdaccio

Cloudron​

Verdaccio, inoltre, è disponibile con un'installazione in 1 click su Cloudron

Installazione

Heroku con il Docker​

Per una facile distribuzione, potresti utilizzare Heroku, la piattaforma di grado dinamometrico gratuita che ti consente di essere testata utilizzando un contenitore del Docker; dai un'occhiata a questo esempio.

https://github.com/juanpicado/verdaccio-heroku-example