Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El SDK de Azure para Rust le permite acceder a los servicios de Azure en los proyectos de Rust mediante la instalación de contenedores de SDK individuales con Cargo. En este artículo se muestra cómo instalar, actualizar y administrar el SDK de Azure para contenedores de Rust, por lo que solo puede agregar las características que necesita y mantener actualizados los proyectos.
Requisitos previos para desarrollar con crates
- Rust 1.85.0 o posterior. La versión se especifica en el SDK de Azure para Rust Cargo.toml.
- Una suscripción de Azure. Puede crear una de forma gratuita.
Sugerencia
Para obtener la mejor experiencia de desarrollo, asegúrese de que tiene instalada la versión estable más reciente de Rust.
Instala la última versión del crate del SDK de Azure
Obtenga los crates del SDK de Azure en crates.io. Instala los crates individuales que necesites.
cargo add <crate_name>
Reemplace <crate_name> por el nombre de la instancia de Azure crate que desea instalar. Por ejemplo, para instalar las cajas de secretos de Azure Identity y Key Vault:
cargo add azure_identity azure_security_keyvault_secrets
Puede encontrar nombres de crates disponibles en el índice de crates para Azure.
Instala una versión específica del crate del SDK de Azure
A veces, es necesario instalar una versión determinada de un contenedor para probar la compatibilidad o mantener la coherencia entre entornos. Cuando especificas una versión, fijas tu dependencia. El proyecto sigue usando esa versión y no recibe automáticamente actualizaciones principales o secundarias, pero todavía puede recibir actualizaciones de revisión. Aunque el anclaje puede ser útil en determinados escenarios, se recomienda usar la versión más reciente para beneficiarse de las mejoras continuas y las actualizaciones de seguridad.
cargo add <crate_name>@<version_number>
Por ejemplo:
cargo add azure_storage_blob@0.20.0
También puede especificar los requisitos de versión en el Cargo.toml archivo. Para más información sobre la sintaxis de requisitos de versión, consulte la documentación de Rust.
Actualización de crates del SDK de Azure
Para actualizar todas las cajas a sus versiones compatibles más recientes, ejecute:
cargo update
Para actualizar un crate específico, ejecute:
cargo update <crate_name>
Quitar un crate específico del SDK de Azure
Para eliminar un crate de tu proyecto, incluido el Cargo.toml archivo, ejecuta:
cargo remove <crate_name>
Compila el proyecto para actualizar tu archivo Cargo.lock:
cargo build
Configure las funcionalidades del crate del SDK de Azure
El azure_core contenedor proporciona características para todas las cajas del SDK de Azure, como:
-
reqwest: implementación del cliente HTTP. -
tokio: compatibilidad con el entorno de ejecución asincrónico.
Active las funciones del SDK al agregar un crate:
cargo add <crate_name> --features <feature_name_1>,<feature_name_2>
O bien, especifique las características en Cargo.toml:
[dependencies]
<crate_name> = { version = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }
Recursos adicionales
- Crates del SDK de Azure en Crates.io : lista de contenedores de SDK de Azure disponibles
- Directrices de diseño del SDK de Azure : principios y patrones de diseño
- Repositorio de GitHub del SDK de Azure para Rust : problemas y código fuente
- Documentación de Cargo : Referencia completa de carga