Introduzione ai pacchetti npm in Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Con Azure Artifacts è possibile pubblicare e scaricare i pacchetti npm da feed e registri pubblici, ad esempio npmjs.com. Questa guida introduttiva illustra come creare il feed, configurare il progetto e gestire i pacchetti npm con il feed Azure Artifacts.

Prerequisiti

• Un'organizzazione Azure DevOps. Crearne una gratuitamente.

• Un progetto Azure DevOps. Creare un nuovo progetto se non ne è già disponibile uno.

• Scaricare e installare Node.js e npm.

Creare un feed

1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

2. Selezionare Artefatti e quindi crea feed per creare un nuovo feed.

3. Immettere un nome descrittivo per il feed e definirne la visibilità (che indica chi può visualizzare i pacchetti all'interno del feed). Specificare l'ambito del feed e, se si desidera includere pacchetti da origini pubbliche, contrassegnare la casella di controllo Origini upstream.

4. Al termine, fare clic su Crea.

   

Nota

Per impostazione predefinita, i feed appena creati hanno il servizio di compilazione del progetto impostato su Feed e lettore upstream (collaboratore).

Connessione a un feed

Nota

vsts-npm-auth non è supportato in Azure DevOps Server.

Azure Artifacts consiglia di usare due file con estensione npmrc. Il primo deve essere inserito nella directory $home (Linux/macOS) o $env. HOME (Windows) per archiviare in modo sicuro le credenziali. In questo modo il client npm può individuare il file e recuperare le credenziali per l'autenticazione, consentendo di condividere il file di configurazione senza esporre le credenziali. In questa sezione verrà configurato il secondo file con estensione npmrc , che deve essere inserito nella stessa directory del file package.json .

1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

2. Selezionare Artefatti e quindi selezionare Connessione da inserire.

3. Selezionare npm nell'area di spostamento a sinistra. Se è la prima volta che si usa Azure Artifacts con npm, assicurarsi di aver installato i prerequisiti.

4. Seguire le istruzioni nella sezione Configurazione progetto per configurare il file di configurazione e connettersi al feed.

   

Importante

npm supporta un singolo registry file con estensione npmrc. Sono possibili più registri con ambiti e origini upstream.

Pubblicare pacchetti

Eseguire il comando seguente nella directory del progetto per pubblicare i pacchetti npm:

npm publish

Importante

L'uso della proprietà per eseguire l'override publishConfig del parametro di configurazione del Registro di sistema in fase di pubblicazione non è supportato.

Ripristinare pacchetti

Eseguire il comando seguente nella directory del progetto per ripristinare i pacchetti npm:

npm install

Per ripristinare un pacchetto npm specifico, eseguire il comando seguente dalla directory del progetto:

npm install --save <PACKAGE_NAME>

Articoli correlati

• Pubblicare pacchetti npm (YAML/classic)
• Usare pacchetti da npmjs.com
• Usare gli ambiti npm