Pubblicare e ripristinare pacchetti Cargo

servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Usando Azure Artifacts, è possibile pubblicare e ripristinare pacchetti Cargo dai propri feed e registri pubblici, ad esempio crates.io. Usare Azure Artifacts per ospitare crate interne, connettersi ai registri upstream e gestire l'accesso ai pacchetti da un singolo feed. Questa guida introduttiva illustra come creare un feed, configurare il progetto Cargo e pubblicare e usare pacchetti Cargo usando Azure Artifacts.

Prerequisiti

Creare un feed

Se si dispone già di un feed di Azure Artifacts, passare alla sezione successiva. In caso contrario, seguire questa procedura per creare un feed. Azure Artifacts consiglia di usare un feed per usare crate provenienti da registri pubblici come crates.io e un feed separato per pubblicare i crate interni.

1. Accedere a Azure DevOps e quindi passare al progetto.

2. Selezionare Artefatti, quindi selezionare Crea feed.

3. Immettere un nome per il feed, scegliere visibilità e quindi selezionare un ambito. Assicurarsi di selezionare la casella di controllo Origini upstream per includere i pacchetti dai registri pubblici.

4. Al termine, fare clic su Crea.

Connettersi a un feed

Prima di poter pubblicare o ripristinare pacchetti dal feed, è necessario configurare il progetto per l'autenticazione e la connessione al feed.

1. Accedere a Azure DevOps e quindi passare al progetto.

2. Selezionare Artefatti e quindi selezionare il proprio feed dal menu a discesa.

3. Selezionare Connetti al feed e quindi selezionare Cargo nella barra di navigazione a sinistra.

4. Seguire la procedura descritta nella sezione Project setup per configurare il config.toml file.

5. Nella stessa pagina seguire le istruzioni riportate nelle sezioni Configurare un provider di credenziali e Accedere al Registro di sistema per configurare il provider di credenziali e connettersi al feed. Per i passaggi dettagliati, vedere Cargo - configurazione del progetto.

[unstable]
registry-auth = true

rustup default nightly

Pubblicare pacchetti

Prima di pubblicare un pacchetto Cargo, assicurarsi di aver completato i passaggi descritti in Connettersi a un feed in modo da poter eseguire l'autenticazione con il feed Azure Artifacts.

Dalla directory contenente il file Cargo.toml eseguire il comando seguente per pubblicare il pacchetto:

cargo publish

Se si verifica GLib-GObject-CRITICAL - libsecret-CRITICAL un errore, assicurarsi di seguire questa procedura:

1. Verificare che libsecret sia installato:

   sudo apt update && sudo apt install libsecret-1-0
   

2. Assicurarsi che gnome-keyring sia in esecuzione:

   gnome-keyring-daemon --start --components=secrets
   

3. Aggiornare Rust alla versione stabile più recente e impostare stabile come toolchain predefinita:

   rustup update  
   rustup default stable  
   

4. Se il problema persiste, eseguire cargo publish di nuovo con la registrazione dettagliata per raccogliere altri dettagli:

   RUST_LOG=debug cargo publish --registry <REGISTRY_NAME>
   

Ripristinare i pacchetti

Prima di ripristinare le dipendenze, assicurarsi di aver completato i passaggi descritti in Connettersi a un feed in modo da poter eseguire l'autenticazione con il feed Azure Artifacts.

1. Assicurarsi che le dipendenze siano elencate nella [dependencies] sezione del Cargo.toml file.

2. Se si usano direttamente i crate dal feed privato di Azure Artifacts, specificare esplicitamente il registro come indicato di seguito:

   [dependencies]
   CRATE_NAME = { version = "VERSION_NUMBER", registry = "FEED_NAME" }
   

3. Se fai riferimento a crate da crates.io tramite il feed upstream usando la configurazione replace-with, specificale come segue:

   [dependencies]
   CRATE_NAME = "VERSION_NUMBER"
   

4. Eseguire il comando seguente nella directory del progetto per compilare il progetto e ripristinare le dipendenze dal feed:

   cargo build
   

I crate scaricati vengono memorizzati nella cache locale in ~/.cargo/registry/cache/<registry-hash>/, dove registry-hash è un identificatore univoco basato sull'URL del feed.

Contenuti correlati

• Eliminare/ritirare i pacchetti Cargo

• A monte dei feed interni

• Autorizzazioni del feed