Tutoriel : Utilisation de sources amont

Article
04/04/2024

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

L’utilisation de amont sources dans votre flux vous permet de gérer les dépendances de votre application à partir d’un seul flux. L’utilisation de amont sources facilite l’utilisation de packages à partir de registres publics tout en ayant une protection contre les pannes ou les packages compromis. Vous pouvez également publier vos propres packages dans le même flux et gérer toutes vos dépendances dans un emplacement unique.

Ce tutoriel vous explique comment activer amont sources sur votre flux et consommer des packages à partir de registres publics tels que NuGet.org ou npmjs.com.

Ce didacticiel présente les procédures suivantes :

Créez un flux et activez amont sources.
Configurez votre fichier de configuration.
Exécutez une restauration de package initiale pour remplir votre flux.
Vérifiez votre flux pour afficher la copie enregistrée des packages que vous avez consommés à partir du registre public.

Créer un flux et activer amont sources

Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, puis créez un flux pour créer un flux.
Fournissez un nom pour votre flux et choisissez sa visibilité. Veillez à case activée les packages Include à partir de sources publiques courantes case activée box pour activer amont sources, puis sélectionnez Créer lorsque vous avez terminé.

Configurer le fichier de configuration

Maintenant que nous avons créé notre flux, nous devons mettre à jour le fichier config pour qu’il pointe vers notre flux. Pour ce faire, nous devons :

Obtenir l’URL de la source
Mettre à jour le fichier de configuration

Sélectionnez Artefacts, puis sélectionnez Connecter à alimenter.
Sur le côté gauche de la page, sélectionnez l’onglet npm .
Suivez les instructions de la section Configuration de Project pour configurer votre fichier de configuration.

Si vous n’avez pas encore de fichier .npmrc , créez-en un à la racine de votre projet (dans le même dossier que votre package.json). Ouvrez votre nouveau fichier .npmrc et collez l’extrait de code que vous venez de copier à l’étape précédente.

Sélectionnez Artefacts, puis sélectionnez votre flux dans la liste déroulante.
Sélectionnez Connecter à alimenter, puis sélectionnez pip sous la section Python.
Créez un environnement virtuel si vous ne l’avez pas déjà fait.
Ajoutez un fichier pip.ini (Windows) ou pip.conf (Mac/Linux) à votre virtualenv et collez l’extrait de code suivant :
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Sélectionnez Artefacts, puis sélectionnez votre flux dans la liste déroulante.
Sélectionnez Connecter à alimenter, puis sélectionnez Maven.

Ajoutez l’extrait de code suivant aux <repositories> sections de <distributionManagement> votre 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>

Ajoutez un <server> à votre fichier 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>

Créez un jeton d’accès personnel avec des>étendues de lecture et d’écriture d’empaquetage et collez votre jeton d’accès personnel dans la <password> balise de votre fichier settings.xml.

Sélectionnez Artefacts, puis sélectionnez votre flux dans la liste déroulante.
Sélectionnez Connecter à alimenter, puis sélectionnez Gradle.

Ajoutez l’extrait de code suivant aux référentiels et sections de publication dans votre fichier build.gradle :

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

Ajoutez un <server> à votre fichier 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>

Créez un jeton d’accès personnel avec des étendues de lecture et d’écriture d’empaquetage>. Collez votre jeton d’accès personnel dans la <password> balise dans votre fichier settings.xml.

Restaurer des packages

Maintenant que vous avez activé amont sources et configuré votre fichier de configuration, nous pouvons exécuter la commande de restauration de package pour interroger la source amont et récupérer les packages amont.

Supprimez le dossier node_modules de votre projet et exécutez la commande suivante dans une fenêtre d’invite de commandes avec élévation de privilèges :

npm install --force

Remarque

L’argument --force force les extractions distantes même si une copie locale existe.