Cargo-pakketten publiceren en herstellen

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

Met behulp van Azure-artefacten kunt u Cargo-pakketten publiceren en herstellen vanuit uw eigen feeds en openbare registers, zoals crates.io. Gebruik Azure-artefacten om interne kratten te hosten, verbinding te maken met upstreamregisters en pakkettoegang te beheren vanuit één feed. In deze quickstart wordt u begeleid bij het maken van een feed, het configureren van uw Cargo-project en het publiceren en gebruiken van Cargo-pakketten met behulp van Azure-artefacten.

Prerequisites

Een feed maken

Als u al een Azure-artefacten feed hebt, gaat u naar de volgende sectie. Volg anders deze stappen om een feed te maken. Azure-artefacten raadt aan om één feed te gebruiken voor het verbruik van kratten uit openbare registers, zoals crates.io en een afzonderlijke feed voor het publiceren van interne kratten.

1. Meld u aan bij Azure DevOps en ga naar uw project.

2. Selecteer Artefacten en selecteer Feed maken.

3. Voer een naam in voor uw feed, kies de zichtbaarheid en selecteer vervolgens een bereik. Zorg ervoor dat u het selectievakje Upstream-bronnen inschakelt om pakketten uit openbare registers op te nemen.

4. Selecteer Maken wanneer u klaar bent.

Verbinding maken met een feed

Voordat u pakketten vanuit uw feed kunt publiceren of herstellen, moet u eerst uw project configureren om de feed te verifiëren en er verbinding mee te maken.

1. Meld u aan bij Azure DevOps en ga naar uw project.

2. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

3. Kies Verbinding maken met feed en selecteer daarna Cargo in het linkernavigatievenster.

4. Volg de stappen in de sectie Project setup om uw config.toml bestand te configureren.

5. Volg op dezelfde pagina de instructies in de secties Een referentieprovider configureren en meld u aan bij de registersecties om de referentieprovider in te stellen en verbinding te maken met uw feed. Zie Cargo - projectinstallatie voor gedetailleerde stappen.

[unstable]
registry-auth = true

rustup default nightly

Pakketten publiceren

Voordat u een Cargo-pakket publiceert, moet u ervoor zorgen dat u de stappen in Verbinding maken met een feed hebt voltooid, zodat u zich kunt verifiëren met uw Azure-artefacten feed.

Voer vanuit de map met uw Cargo.toml-bestand de volgende opdracht uit om uw pakket te publiceren:

cargo publish

Als u GLib-GObject-CRITICAL - libsecret-CRITICAL fout tegenkomt, zorg ervoor dat u de volgende stappen volgt:

1. Controleer of libsecret is geïnstalleerd:

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

2. Zorg ervoor dat gnome-keyring actief is:

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

3. Werk Rust bij naar de nieuwste stabiele versie en stel 'stable' in als de standaard toolchain:

   rustup update  
   rustup default stable  
   

4. Als het probleem zich blijft voordoen, voert u cargo publish opnieuw uit met uitgebreide logregistratie om meer details te verzamelen:

   RUST_LOG=debug cargo publish --registry <REGISTRY_NAME>
   

herstellen van pakketten

Voordat u afhankelijkheden herstelt, moet u ervoor zorgen dat u de stappen in Verbinding maken met een feed hebt voltooid, zodat u zich kunt verifiëren met uw Azure-artefacten feed.

1. Zorg ervoor dat uw afhankelijkheden worden vermeld in de [dependencies] sectie van het Cargo.toml bestand.

2. Als u crates rechtstreeks uit uw privéfeed in Azure-artefacten afneemt, specificeert u het register als volgt:

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

3. Als u verwijst naar crates van crates.io via uw upstream-feed met behulp van de configuratie replace-with, geeft u deze als volgt op:

   [dependencies]
   CRATE_NAME = "VERSION_NUMBER"
   

4. Voer de volgende opdracht uit in uw projectmap om uw project te bouwen en uw afhankelijkheden te herstellen vanuit de feed:

   cargo build
   

De gedownloade crates worden lokaal opgeslagen in de cache op ~/.cargo/registry/cache/<registry-hash>/, waarbij registry-hash een unieke ID is die is gebaseerd op uw feed-URL.

Verwante inhoud

• Pakketten verwijderen/Yank Cargo

• Aanvoer vanuit interne feeds

• Toegangsrechten voor feed