Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
- Rust 1.85.0 ou posterior. A versão é especificada no SDK do Azure para Rust Cargo.toml.
- Uma assinatura do Azure. Você pode criar um gratuitamente.
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.
cargo add <crate_name>
Substitua <crate_name> pelo nome da crate do Azure que pretende instalar. Por exemplo, para instalar as caixas de segredos do Azure Identity e Key Vault:
cargo add azure_identity azure_security_keyvault_secrets
Pode encontrar nomes de crates disponíveis no índice de crates do Azure.
Instalar uma versão específica de um crate do SDK do Azure
Às vezes, você precisa instalar uma versão específica de uma caixa para testes de compatibilidade ou para manter a consistência entre ambientes. Ao especificar uma versão, você 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 o uso da 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 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 = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }
Recursos adicionais
- Crates 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
- SDK do Azure for Rust GitHub repository - Problemas e código-fonte
- Documentação da carga - Referência completa da carga