Installer des crates de SDK Azure pour Rust

Le Kit de développement logiciel (SDK) Azure pour Rust vous permet d’accéder aux services Azure dans vos projets Rust en installant des caisses de SDK individuelles avec Cargo. Cet article explique comment installer, mettre à jour et gérer les caisses du Kit de développement logiciel (SDK) Azure pour Rust. Vous pouvez donc ajouter uniquement les fonctionnalités dont vous avez besoin et maintenir vos projets à jour.

Prérequis pour développer avec des crates

  • Rust 1.85.0 ou version ultérieure. La version est spécifiée dans le Kit de développement logiciel (SDK) Azure pour Rust Cargo.toml.
  • Un abonnement Azure. Vous pouvez en créer un gratuitement.

Conseil / Astuce

Pour une expérience de développement optimale, vérifiez que vous disposez de la dernière version stable de Rust installée.

Installer la dernière version du Kit de développement logiciel (SDK) Azure

Obtenez les crates du SDK Azure sur crates.io. Installez les caisses individuelles dont vous avez besoin.

La dernière Kit de développement logiciel (SDK) Azure pour la version de la caisse Rust est la dernière version stable de 1.x pour cette caisse.

cargo add <crate_name>

Remplacez <crate_name> par le nom de la caisse Azure que vous souhaitez installer. Par exemple, pour installer les caisses de secrets Azure stable et Key Vault actuelles :

cargo add azure_identity azure_security_keyvault_secrets

Vous pouvez trouver les noms des crates disponibles dans l’index des crates pour Azure.

Important

Utilisez des Kit de développement logiciel (SDK) Azure stables 1.x pour les versions de caisse Rust pour les charges de travail de production. Les versions préliminaires et bêta sont disponibles pour certaines caisses, mais cargo add <crate_name> sont résolues par défaut vers la dernière version stable.

Installer une version spécifique d’un crate du SDK Azure

Parfois, vous devez utiliser une exigence de version spécifique pour une caisse de test de compatibilité ou maintenir la cohérence entre les environnements. Cargo résout l’exigence d’une version compatible et enregistre la version résolue exactement dans Cargo.lock.

cargo add <crate_name>@1

Par exemple, pour utiliser la dernière version stable de 1.x :

cargo add azure_storage_blob@1

Pour plus d’informations sur la syntaxe des exigences de version, consultez la documentation Rust.

Mettre à jour les crates du SDK Azure

Pour mettre à jour tous les crates vers leurs dernières versions compatibles, exécutez :

cargo update

Pour mettre à jour une crate spécifique, exécutez :

cargo update <crate_name>

Supprimer une caisse spécifique du Kit de développement logiciel (SDK) Azure

Pour supprimer un crate de votre projet, y compris le fichier Cargo.toml, exécutez :

cargo remove <crate_name>

Générez le projet pour mettre à jour votre Cargo.lock fichier :

cargo build

Configurer les fonctionnalités du crate du SDK Azure

Le crate azure_core fournit des fonctionnalités pour tous les crates du SDK Azure, telles que :

  • reqwest: implémentation du client HTTP.
  • tokio: prise en charge du runtime asynchrone.

Activez les fonctionnalités du Kit de développement logiciel (SDK) lors de l’ajout d’une caisse :

cargo add <crate_name> --features <feature_name_1>,<feature_name_2>

Ou spécifiez des fonctionnalités dans votre Cargo.toml:

[dependencies]
<crate_name> = { version = "1", features = ["<feature_name_1>", "<feature_name_2>"] }

Ressources supplémentaires

  • Last updated on