Compartir vía


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 cajas

Sugerencia

Para obtener la mejor experiencia de desarrollo, asegúrese de que tiene instalada la versión estable más reciente de Rust.

Instalación de la versión más reciente del contenedor del SDK de Azure

Obtenga las cajas del SDK de Azure de crates.io. Instale las cajas individuales que necesita.

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 contenedor disponibles en el índice de crate para Azure.

Instalación de una versión específica de 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. Al especificar una versión, ancle la 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 contenedor específico, ejecute:

cargo update <crate_name>

Eliminación de un contenedor específico del SDK de Azure

Para quitar un contenedor del proyecto, incluido el Cargo.toml archivo, ejecute:

cargo remove <crate_name>

Compile el proyecto para actualizar Cargo.lock el archivo:

cargo build

Configuración de las características de contenedor 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.

Habilite las características del SDK al agregar un contenedor:

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