Instalar o SDK do Azure para crates de Rust

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

Pré-requisitos para desenvolver com crates

Sugestão

Para obter a melhor experiência de desenvolvimento, certifique-se de ter a versão estável mais recente do Rust instalada.

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

Obtenha os pacotes SDK do Azure em crates.io. Instale as caixas individuais que você precisa.

A versão mais recente do SDK do Azure para Rust Crate é a mais recente versão estável 1.x dessa caixa.

cargo add <crate_name>

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

cargo add azure_identity azure_security_keyvault_secrets

Pode encontrar nomes de crates disponíveis no índice de crates do Azure.

Importante

Use o SDK do Azure estável 1.x para lançamentos de caixas Rust para cargas de trabalho de produção. As versões de pré-visualização e beta estão disponíveis para algumas caixas, mas cargo add <crate_name> resolvem para a versão estável mais recente por defeito.

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

Por vezes, é preciso usar um requisito de versão específico para uma caixa para testes de compatibilidade ou para manter a consistência entre ambientes. Carga resolve o requisito para uma versão compatível e regista exatamente a versão resolvida em Cargo.lock.

cargo add <crate_name>@1

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

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 pacotes do SDK do Azure

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

cargo update

Para atualizar um crate específico, execute:

cargo update <crate_name>

Remova um crate específico do SDK do Azure

Para remover uma caixa do seu projeto, incluindo o Cargo.toml arquivo, execute:

cargo remove <crate_name>

Crie o projeto para atualizar seu Cargo.lock arquivo:

cargo build

Configurar funcionalidades do crate do SDK do Azure

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

  • reqwest: Implementação de cliente HTTP.
  • tokio: Suporte de tempo de execução assíncrono.

Habilite os recursos do SDK ao adicionar uma caixa:

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

Ou especifique as funcionalidades em Cargo.toml:

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

Recursos adicionais