Tutorial: come usare le origini upstream

Articolo
04/04/2024

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

L'uso delle origini upstream nel feed consente di gestire le dipendenze dell'applicazione da un singolo feed. L'uso di origini upstream semplifica l'utilizzo di pacchetti da registri pubblici, pur avendo protezione da interruzioni o pacchetti compromessi. È anche possibile pubblicare i propri pacchetti nello stesso feed e gestire tutte le dipendenze in un'unica posizione.

Questa esercitazione illustra come abilitare le origini upstream nel feed e usare pacchetti da registri pubblici, ad esempio NuGet.org o npmjs.com.

Questa esercitazione illustra come:

Creare un nuovo feed e abilitare le origini upstream.
Configurare il file di configurazione.
Eseguire un ripristino iniziale del pacchetto per popolare il feed.
Controllare il feed per visualizzare la copia salvata dei pacchetti utilizzati dal Registro di sistema pubblico.

Creare un feed e abilitare le origini upstream

Accedere all'organizzazione di Azure DevOps e passare al progetto.
Selezionare Artefatti e quindi crea feed per creare un nuovo feed.
Specificare un nome per il feed e sceglierne la visibilità. Assicurarsi di selezionare la casella di controllo Includi pacchetti da origini pubbliche comuni per abilitare le origini upstream e quindi selezionare Crea al termine.

Configurare il file di configurazione

Ora che è stato creato il feed, è necessario aggiornare il file di configurazione in modo che punti al feed. A tale scopo, è necessario:

Ottenere l'URL dell'origine
Aggiornare il file di configurazione

Selezionare Artefatti e quindi selezionare Connessione da inserire.
Sul lato sinistro della pagina selezionare la scheda npm .
Seguire le istruzioni nella sezione Configurazione progetto per configurare il file di configurazione.

Se non si dispone già di un file con estensione npmrc, crearne uno nuovo nella radice del progetto (nella stessa cartella del package.json). Aprire il nuovo file con estensione npmrc e incollare il frammento appena copiato nel passaggio precedente.

Selezionare Artefatti e quindi selezionare il feed dall'elenco a discesa.
Selezionare Connessione da inserire e quindi selezionare pip nella sezione Python.
Se non è già stato fatto, creare un ambiente virtuale.
Aggiungere un file pip.ini (Windows) o pip.conf (Mac/Linux) al proprio virtualenv e incollare il frammento di codice seguente:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Selezionare Artefatti e quindi selezionare il feed dall'elenco a discesa.
Selezionare Connessione da inserire e quindi selezionare Maven.

Aggiungere il frammento di codice seguente alle <repositories> sezioni e <distributionManagement> nella pom.xml:

<repository>
  <id>[FEED-NAME]</id>
  <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

Aggiungere un oggetto <server> al file settings.xml:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Creare un token di accesso personale con i pacchetti>di ambiti di lettura e scrittura e incollare il <password> token di accesso personale nel tag nel file settings.xml.

Selezionare Artefatti e quindi selezionare il feed dall'elenco a discesa.
Selezionare Connessione da inserire e quindi selezionare Gradle.

Aggiungere il frammento di codice seguente ai repository e alle sezioni di pubblicazione nel file build.gradle:

maven {
    url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
    name '[FEED-NAME]'
    authentication {
        basic(BasicAuthentication)
    }
}

Aggiungere un oggetto <server> al file settings.xml:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Creare un token di accesso personale con ambiti di lettura e scrittura per la creazione di pacchetti>. Incollare il token di accesso personale nel <password> tag nel file di settings.xml.

Ripristinare pacchetti

Dopo aver abilitato le origini upstream e configurato il file di configurazione, è possibile eseguire il comando di ripristino del pacchetto per eseguire query sull'origine upstream e recuperare i pacchetti upstream.

Rimuovere la cartella node_modules dal progetto ed eseguire il comando seguente in una finestra del prompt dei comandi con privilegi elevati:

npm install --force

Nota

L'argomento --force forza il pull dei remote anche se esiste una copia locale.