Tutoriel : Utilisation de sources amont

Article
09/27/2024

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

L’utilisation de sources en amont dans votre flux vous permet de gérer vos dépendances d’application à partir d’un seul flux. L’utilisation de sources en amont 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 des sources en amont 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 les sources en amont.
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 des sources en amont

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é. Vérifiez que vous cochez la case Inclure des packages à partir de sources publiques courantes pour activer les sources en amont, puis sélectionnez Créer lorsque vous avez terminé.

Remarque

Pour ajouter un flux à partir d’une autre organisation en tant que source en amont, le propriétaire du flux cible doit partager l’affichage cible avec tous les flux et les personnes dans les organisations associées à mon locataire Microsoft Entra en accédant au bouton Paramètres> de flux>Sélectionner le bouton de sélection à droite de l’affichage >Spécifié.

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 connectez-vous au flux.
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 Se connecter au flux, 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 Se connecter au flux, 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 Se connecter au flux, 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é les sources en amont et configuré votre fichier de configuration, nous pouvons exécuter la commande de restauration de package pour interroger la source en amont et récupérer les packages en 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