Instalación del SDK de Azure para crates de Rust

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

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