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 pacchetti npm da feed e registri pubblici, ad esempio npmjs.com. Questa guida introduttiva illustra il processo di creazione del feed, la configurazione del progetto e la pubblicazione e il download di pacchetti npm da e verso il feed di Azure Artifacts.

Creare un feed

Un feed è un costrutto aziendale che consente agli utenti di archiviare i pacchetti e controllare chi può accedervi. Azure Artifacts supporta l'archiviazione di diversi tipi di pacchetti in un singolo feed, ad esempio NuGet, npm, Maven, Python, Cargo e pacchetti universali.

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).

Configurare i file con estensione npmrc

Nota

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

È consigliabile usare due file con estensione npmrc. Il primo deve trovarsi nella stessa directory del file package.json. Il secondo deve essere inserito nella directory $home (Linux/macOS) o $env. HOME (Windows) per archiviare in modo sicuro le credenziali. Il client npm sarà quindi in grado di cercare questo file e recuperare le credenziali per l'autenticazione. In questo modo è possibile condividere il file di configurazione mantenendo le credenziali protette.

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

2. Selezionare Artefatti e quindi selezionare Connessione da inserire.

3. Selezionare npm nel riquadro di spostamento a sinistra. Se è la prima volta che si usa Azure Artifacts con npm, selezionare Recupera gli strumenti e seguire la procedura per scaricare Node.js e configurare il computer.

4. Inserire il frammento di codice seguente nel file con estensione npmrc, quello che si trova nella stessa directory del file package.json. Sostituire i segnaposto con i valori appropriati.

   • Feed con ambito organizzazione:

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

   • Feed con ambito progetto:

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

Configurare le credenziali

Importante

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

Windows

Se si sviluppa in Windows, è consigliabile usare vsts-npm-auth per eseguire l'autenticazione con Azure Artifacts. Assicurarsi di avere installato vsts-npm-auth da Ottenere gli strumenti e quindi eseguire vsts-npm-auth per ottenere un token di Azure Artifacts aggiunto al file npmrc a livello di utente:

vsts-npm-auth -config .npmrc

Altro

Se si sviluppa in una piattaforma non Windows ed è necessario eseguire l'autenticazione con Azure Artifacts, è necessario creare un token di accesso personale, codificarlo in Base 64 e aggiungerlo al file npmrc a livello di utente.

1. Generare un token di accesso personale con ambiti di lettura e scrittura per la creazione di pacchetti.

2. Codificare il token di accesso personale appena generato come segue:

   1. Eseguire il comando seguente in una finestra del prompt dei comandi per codificare il pat:

      node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
      

   2. Incollare il token di accesso personale e quindi premere INVIO.

   3. Copiare il token di accesso personale con codifica Base 64.

3. Copiare il frammento di codice seguente nel file npmrc a livello di utente e sostituire il segnaposto con il [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] token di accesso personale Base 64:

   • Feed con ambito organizzazione:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Feed con ambito progetto:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

---

Pubblicare pacchetti

Per pubblicare il pacchetto npm, eseguire il comando seguente nella directory del progetto:

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

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

npm install --save <package>

Per ripristinare tutti i pacchetti npm, eseguire il comando seguente dalla directory del progetto:

npm install

Articoli correlati

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