Use pacotes de Crates.io

Serviços de DevOps do Azure | Azure DevOps Server 2022

As fontes upstream dos Artefatos do Azure permitem que os desenvolvedores consumam pacotes de registros públicos, como Crates.io e nuget.org. Este artigo irá guiá-lo através da configuração do seu projeto e usando a linha de comando para consumir Crates de Crates.io.

Este artigo irá guiá-lo através de como:

• Criar um feed de Artefatos do Azure
• Conecte-se ao seu feed
• Consumir caixas a montante

Pré-requisitos

• Uma organização Azure DevOps. Crie uma organização , caso ainda não o tenha feito.

• Um projeto de DevOps do Azure. Crie um projeto se não tiver um.

• Baixe e instale o rustup.

Criar um feed

O Azure Artifacts recomenda ter um feed dedicado para consumir caixas de crates.io e um feed separado exclusivamente para publicar caixas internas.

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

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

3. Introduza um Nome para o feed, defina a respetiva Visibilidade e, em seguida, selecione o seu Âmbito. Certifique-se de marcar a caixa de seleção Fontes upstream para incluir pacotes de registros públicos.

4. Selecione Criar quando terminar.

   

Conecte-se ao seu feed

Alimentação privada

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

2. Selecione Artefatos e, em seguida, selecione seu feed no menu suspenso.

3. Selecione Conectar ao feed e, em seguida, selecione Carga no painel de navegação esquerdo.

4. Se esta for a primeira vez que utiliza o Cargo com Artefactos do Azure, certifique-se de que instalou o rustup.

5. Adicione o trecho fornecido da seção Configuração do projeto ao arquivo .cargo/config.toml no repositório de origem:

   • Feed com escopo do projeto:

     [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 com escopo da organização:

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

Alimentação pública

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

2. Selecione Artefatos e, em seguida, selecione seu feed no menu suspenso.

3. Selecione Conectar ao feed e, em seguida, selecione Carga no painel de navegação esquerdo.

4. Se esta for a primeira vez que utiliza o Cargo com Artefactos do Azure, certifique-se de que instalou o rustup.

5. Adicione o trecho fornecido da seção Configuração do projeto ao arquivo .cargo/config.toml no repositório de origem, dependendo do cenário. Consulte a tabela Permissões para saber mais sobre as diferentes funções e suas permissões:

   • Leitores de feed e utilizadores anónimos:

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

   • Leitores de feed e upstream, editores de feed e proprietários de feed: certifique-se de incluir o sinalizador adicional (~force-auth) para autenticação adequada com seu feed, conforme mostrado abaixo:

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

Configurar um provedor de credenciais

Para usar o Cargo com o Azure Artifacts, você precisa configurar um provedor de credenciais. As configurações fornecidas configurarão um auxiliar de credenciais padrão para o usuário atual:

Windows

Cole o seguinte trecho em seu %USERPROFILE%.cargo\config.toml:

[registry]
global-credential-providers = ["cargo:token", "cargo:wincred"]

Linux

Cole o seguinte trecho em seu ~/.cargo/config.toml:

[registry]
global-credential-providers = ["cargo:token", "cargo:libsecret"]

macOS

Cole o seguinte trecho em seu ~/.cargo/config.toml:

[registry]
global-credential-providers = ["cargo:token", "cargo:macos-keychain"]

Inicie sessão no seu registo

1. Crie um token de acesso pessoal com Packaging>Read & escreva escopos para autenticar com seu feed.

2. Execute o seguinte comando para iniciar sessão no registo. Substitua o espaço reservado pelo nome do feed e cole o token de acesso pessoal criado na etapa anterior quando solicitado:

   PowerShell

   "Basic " + [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("PAT:" + (Read-Host -MaskInput "Enter PAT"))) | cargo login --registry <FEED_NAME>
   

   Bash

   read -p "Enter PAT: " PAT; echo Basic $(echo -n PAT:$PAT | base64) | cargo login --registry <FEED_NAME>
   

   CLI do Azure

   az login
   az account get-access-token --query "join(' ', ['Bearer', accessToken])" --output tsv | cargo login --registry <FEED_NAME>
   

Salvar pacotes do Crates.io

Nota

Para salvar pacotes de upstreams, você deve ter a função Feed e Upstream Reader (Colaborador) ou superior. Consulte Gerenciar permissões para obter mais detalhes.

Agora que configuramos nosso projeto, configuramos um provedor de credenciais e fazemos login em nosso feed, podemos começar a consumir pacotes do upstream. O Azure Artifacts salva uma cópia de qualquer pacote que você instalar do upstream para o seu feed.

Neste exemplo, consumimos o serde crate, uma estrutura de serialização/desserialização:

1. Execute o seguinte comando no diretório do projeto para adicionar a caixa ao seu cargo.toml:

   cargo add serde
   

2. Execute o seguinte comando para construir seu projeto e consumir sua caixa:

   cargo build
   

Assim que o pacote estiver instalado, uma cópia será salva no seu feed. Navegue até o feed para verificar sua presença. Seu pacote deve estar disponível em seu feed, como mostrado abaixo:

Artigos relacionados

• Publicar pacotes de carga com o Azure Pipelines
• Excluir e recuperar pacotes
• Configurar permissões