Instalar os crates do SDK do Azure para Rust

O SDK do Azure para Rust permite que você acesse os serviços do Azure em seus projetos do Rust instalando crates individuais do SDK com Cargo. Este artigo mostra como instalar, atualizar e gerenciar o SDK do Azure para crates do Rust, para que você possa adicionar apenas os recursos necessários e manter seus projetos atualizados.

Pré-requisitos para desenvolver com crates

Dica

Para obter a melhor experiência de desenvolvimento, verifique se você tem a versão estável mais recente do Rust instalada.

Instalar a versão mais recente do crate do SDK do Azure

Obtenha os crates do SDK do Azure de crates.io. Instale os crates individuais de que você precisa.

O último SDK do Azure para a versão de crate rust é a versão 1.x estável mais recente para esse crate.

cargo add <crate_name>

Substitua <crate_name> pelo nome do crate do Azure que você deseja instalar. Por exemplo, para instalar as caixas de segredos Azure Identity e Key Vault estáveis atuais:

cargo add azure_identity azure_security_keyvault_secrets

Você pode encontrar nomes de crates disponíveis no índice de crates do Azure.

Importante

Use o SDK do Azure estável 1.x para versões de crate do Rust para cargas de trabalho de produção. Versões prévias e beta estão disponíveis para alguns crates, mas cargo add <crate_name> são resolvidas para a versão estável mais recente por padrão.

Instalar uma versão específica de um crate do SDK do Azure

Às vezes, você precisa usar um requisito de versão específico para um crate para teste de compatibilidade ou para manter a consistência entre ambientes. A carga resolve o requisito para uma versão compatível e registra a versão exata resolvida em Cargo.lock.

cargo add <crate_name>@1

Por exemplo, para usar a versão 1.x estável mais recente:

cargo add azure_storage_blob@1

Para obter mais informações sobre a sintaxe do requisito de versão, consulte a documentação do Rust.

Atualizar os crates do SDK do Azure

Para atualizar todos os crates para suas versões compatíveis mais recentes, execute:

cargo update

Para atualizar um crate específico, execute:

cargo update <crate_name>

Remover um crate específico do SDK do Azure

Para remover um crate do seu projeto, incluindo o arquivo Cargo.toml, execute:

cargo remove <crate_name>

Crie o projeto para atualizar seu Cargo.lock arquivo:

cargo build

Configurar recursos de crate do SDK do Azure

O azure_core crate fornece recursos para todos os crates do SDK do Azure, como:

  • reqwest: implementação do cliente HTTP.
  • tokio: Suporte para ambiente de execução assíncrono.

Habilite os recursos do SDK ao adicionar um crate:

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

Ou especifique recursos em seu Cargo.toml:

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

Recursos adicionais