Publier des packages Cargo avec Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2022

Azure Pipelines permet aux développeurs de publier des packages Cargo sur des flux Azure Artifacts et des registres publics tels que Crates.io. Cet article vous explique comment publier vos packages Cargo sur des flux Azure Artifacts avec des pipelines YAML et classiques.

Prérequis

• Une organisation Azure DevOps et un projet. Créez une organisation ou un projet si ce n’est déjà fait.

• Flux de données Azure Artifacts. Créer un flux si vous n’en avez pas déjà.

S’authentifier avec un flux

1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

2. Sélectionnez Artefacts, puis sélectionnez votre flux.

3. Sélectionnez Se connecter au flux, puis sélectionnez Cargo dans le volet gauche.

4. Copiez l’extrait de code fourni à partir de la section configuration de Project et ajoutez-le à votre fichier config.toml dans votre référentiel source. Votre fichier devrait ressembler à ceci :

   • Flux à l'échelle du projet :

     [registries]
     <FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }
     
     [source.crates-io]
     replace-with = "<FEED_NAME>"
     

   • Flux à l'échelle de l'organisation :

     [registries]
     <FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }
     
     [source.crates-io]
     replace-with = "<FEED_NAME>"
     

5. Créez un jeton d’accès personnel avec des portées de Mise en package>Lecture et écriture pour vous authentifier auprès de votre flux.

YAML

1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

2. Sélectionnez pipelines, puis sélectionnez votre définition de pipeline.

3. Sélectionnez Modifier, puis ajoutez l’extrait de code suivant à votre pipeline YAML.

   - task: CargoAuthenticate@0
     displayName: 'Cargo Authenticate'
     inputs:
       configFile: '.cargo/config.toml'    ## Path to the config.toml file that specifies the registries you want to work with. Select the file, not the folder e.g. "/.cargo/config.toml"
   

Classique

1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

2. Sélectionnez Pipelines, sélectionnez votre définition de pipeline, puis sélectionnez Modifier.

3. Sélectionnez le signe + pour ajouter une nouvelle tâche. Recherchez la tâche Cargo Authenticate, puis sélectionnez Ajouter pour l’ajouter à votre pipeline.

4. Sélectionnez l’icône de points de suspension pour ouvrir une nouvelle fenêtre affichant le contenu de votre référentiel, puis choisissez votre fichier config.toml.

   

Publier des crates vers un flux

YAML

1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

2. Sélectionnez pipelines, puis sélectionnez votre définition de pipeline.

3. Sélectionnez Modifier, puis ajoutez l’extrait de code suivant à votre pipeline YAML.

   - powershell: |
      cargo publish --registry <FEED_NAME>        ## Replace the placeholder with your feed name
     env:
       SYSTEM_ACCESSTOKEN: $(system.accesstoken)
   

Classique

1. Dans votre projet Azure DevOps, sélectionnez Pipelines, votre définition de pipeline puis Édition.

2. Sélectionnez le signe + pour ajouter une nouvelle tâche, puis ajoutez la tâche de ligne de commande à votre définition de pipeline.

3. Attribuez un nom à votre tâche, puis collez la commande suivante dans la zone de texte script de , en remplaçant l’espace réservé par le nom de votre flux :

   cargo publish --registry <FEED_NAME>
   

4. Sélectionnez votre tâche d'agent, faites défiler jusqu’à Options supplémentaires, puis cochez la case Autoriser les scripts à accéder au jeton OAuth.

Exemple

L’exemple suivant montre comment installer Rustup sur l’agent, configurer la variable d’environnement PATH, générer le projet, s’authentifier auprès de CargoAuthenticate et publier sur un flux Azure Artifacts :

Windows

trigger:
- main

pool:
  vmImage: windows-latest

steps:
- powershell: |
   Invoke-WebRequest -Uri https://sh.rustup.rs -OutFile rustup-init.sh
   bash .\rustup-init.sh -y
   echo "##vso[task.prependpath]$env:USERPROFILE\.cargo\bin"
  displayName: Install

- task: CargoAuthenticate@0
  displayName: 'cargo Authenticate'
  inputs:
    configFile: '.cargo/config.toml'

- script: |
   cargo build --all
  displayName: Build

- powershell: |
   cargo publish --registry CargoInternalFeed
  displayName: Publish

Linux

trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
- script: |
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
   echo "##vso[task.prependpath]$HOME/.cargo/bin"
  displayName: Install

- task: CargoAuthenticate@0
  displayName: 'cargo Authenticate'
  inputs:
    configFile: '.cargo/config.toml'

- script: |
   cargo build --all
  displayName: Build

- powershell: |
   cargo publish --registry CargoInternalFeed
  displayName: Publish

Une fois l’exécution de votre pipeline terminée, votre crate devrait être disponible dans votre flux, comme indiqué ci-dessous :

Articles connexes

• Supprimer/packages Yank Cargo
• Promouvoir un package dans une vue
• Autorisations de flux