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.

La versión más reciente de SDK de Azure para crate de Rust es la versión estable más reciente de 1.x para ese contenedor.

cargo add <crate_name>

Reemplace <crate_name> por el nombre de la instancia de Azure crate que desea instalar. Por ejemplo, para instalar el Azure estable actual y Key Vault contenedores de secretos:

cargo add azure_identity azure_security_keyvault_secrets

Puede encontrar nombres de crates disponibles en el índice de crates para Azure.

Importante

Use la SDK de Azure estable 1.x para las versiones de contenedor de Rust para cargas de trabajo de producción. Las versiones preliminares y beta están disponibles para algunas cajas, pero cargo add <crate_name> se resuelve en la versión estable más reciente de forma predeterminada.

Instala una versión específica del crate del SDK de Azure

A veces, debe usar un requisito de versión específico para una caja para pruebas de compatibilidad o para mantener la coherencia entre entornos. Cargo resuelve el requisito de una versión compatible y registra la versión resuelta exacta en Cargo.lock.

cargo add <crate_name>@1

Por ejemplo, para usar la versión estable 1.x más reciente:

cargo add azure_storage_blob@1

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 = "1", features = ["<feature_name_1>", "<feature_name_2>"] }

Recursos adicionales

  • Last updated on