Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
- Rust 1.85.0 ou mais recente. A versão é especificada no SDK do Azure para Rust Cargo.toml.
- Uma assinatura do Azure. É possível criar uma gratuitamente.
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 caixas do SDK do Azure de crates.io. Instale os crates individuais de que você precisa.
cargo add <crate_name>
Substitua <crate_name> pelo nome do crate do Azure que você deseja instalar. Por exemplo, para instalar os crates de segredos do Azure Identity e do Key Vault:
cargo add azure_identity azure_security_keyvault_secrets
Você pode encontrar nomes de caixa disponíveis no índice crate do Azure.
Instalar uma versão específica do SDK do Azure
Às vezes, você precisa instalar uma versão específica de um crate para teste de compatibilidade ou para manter a consistência entre ambientes. Quando você especifica uma versão, fixa sua dependência. Seu projeto continua usando essa versão e não recebe automaticamente atualizações principais ou secundárias, mas ainda pode receber atualizações de patch. Embora a fixação possa ser útil em determinados cenários, recomendamos usar a versão mais recente para se beneficiar de melhorias contínuas e atualizações de segurança.
cargo add <crate_name>@<version_number>
Por exemplo:
cargo add azure_storage_blob@0.20.0
Você também pode especificar os requisitos de versão em seu Cargo.toml arquivo. Para obter mais informações sobre a sintaxe do requisito de versão, consulte a documentação do Rust.
Atualizar caixas 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 Cargo.toml arquivo, 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 a runtime assíncrono.
Habilite os recursos do SDK ao adicionar um crate:
cargo add <crate_name> --features <feature_name_1>,<feature_name_2>
Ou especifique os recursos em seu Cargo.toml:
[dependencies]
<crate_name> = { version = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }
Recursos adicionais
- Caixas do SDK do Azure no Crates.io – Lista de crates disponíveis do SDK do Azure
- Diretrizes de design do SDK do Azure – Princípios e padrões de design
- Repositório gitHub do SDK do Azure para Rust – Problemas e código-fonte
- Documentação de carga – Referência completa de carga