Publicar pacotes Cargo com o Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2022

O Azure Pipelines permite que os desenvolvedores publiquem pacotes Cargo em feeds do Azure Artifacts e em registros públicos, como o Crates.io. Neste artigo, você aprenderá como publicar seus pacotes Cargo em um feed do Azure Artifacts usando pipelines YAML e Clássico.

Este artigo orientará você sobre como:

• Criar um feed do Azure Artifacts
• Autenticar com o Azure Artifacts
• Publicar pacotes Cargo

Pré-requisitos

• Uma organização do Azure DevOps. Criar uma organização, caso ainda não tenha criado.

• Um projeto do Azure DevOps. Criar um projeto, caso ainda não tenha um.

Criar um feed

O Azure Artifacts recomenda ter um feed dedicado para consumir crates do crates.io e um feed separado exclusivamente para publicar crates internos. Se você já tiver um feed, prossiga para a próxima seção.

1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Artefatos e, em seguida, selecione Criar Feed.

3. Forneça um Nome para o seu feed, especifique sua Visibilidade e, em seguida, escolha um Escopo para o seu feed.

4. Selecione Criar quando terminar.

   

Autenticar com o Azure Artifacts

1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Artefatos e, em seguida, selecione o feed.

3. Selecione Conectar ao feed e, em seguida, selecione Cargo no painel esquerdo.

4. Siga as instruções na seção Configuração do projeto adicionando o trecho fornecido ao arquivo config.toml no repositório de origem:

   • Feed do projeto com escopo:

     [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>"
     

   • Feed da organização com escopo:

     [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. Crie um Token de acesso pessoal com escopos de Empacotamento>Leitura e gravação para autenticar com seu feed.

6. Use a tarefa CargoAuthenticate para autenticar pelo seu pipeline:

   Clássico

   1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

   2. Selecione Pipelines, selecione sua definição de pipeline e depois selecione Editar.

   3. Selecione o sinal + para adicionar uma nova tarefa. Localize a tarefa CargoAuthenticate e selecione Adicionar para adicioná-la ao pipeline.

   4. Selecione o ícone de reticências para abrir uma nova janela que exibe o conteúdo do repositório e escolha o arquivo config.toml.

      

   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"
   

Publicar crates no seu feed

Clássico

1. No projeto Azure DevOps, selecione Pipelines, selecione a definição do seu pipeline e, em seguida, selecione Editar.

2. Selecione o sinal + no trabalho do agente para adicionar uma nova tarefa. Procure a tarefa PowerShell por meio da função de pesquisa e selecione Adicionar para adicioná-la ao pipeline.

3. Dê um nome à sua tarefa, por exemplo, Publicar e, em seguida, selecione Embutido como o tipo. Cole o comando de publicação embutido, substituindo o espaço reservado pelo nome do feed:

   cargo publish --registry <FEED_NAME>
   

YAML

- powershell: |
   cargo publish --registry <FEED_NAME>        ## Replace the placeholder with your feed name
  displayName: Publish

Exemplo

Neste exemplo, instalaremos o rustup no agente, configuraremos a variável de ambiente PATH, criaremos nosso projeto, autenticaremos com o CargoAuthenticate e, finalmente, publicaremos nosso crate em nosso feed do 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

Depois que a execução de pipeline for concluída, o crate deverá ser disponibilizado em seu feed, conforme mostrado abaixo:

Artigos relacionados

• Excluir/Pacotes Cargo Yank
• Promover um pacote para uma exibição
• Permissões do feed