Установка пакета SDK Azure для Rust

Пакет SDK Azure для Rust позволяет получить доступ к службам Azure в проектах Rust, установив отдельные ящики пакета SDK с помощью Cargo. В этой статье показано, как установить, обновить и управлять пакетами SDK Azure для Rust, чтобы можно было добавлять только необходимые функции и поддерживать актуальность проектов.

Предварительные требования для разработки с ящиками

Подсказка

Для оптимальной разработки убедитесь, что установлена последняя стабильная версия Rust.

Установка последней версии пакета SDK Для Azure

Получите crates Azure SDK на crates.io. Установите необходимые отдельные ящики.

Последний Azure SDK для выпуска crate rust является последним стабильным выпуском 1.x для этого ящика.

cargo add <crate_name>

Замените <crate_name> на имя пакета Azure, который вы хотите установить. Например, чтобы установить текущую стабильную Azure Identity и Key Vault секреты, выполните следующие действия:

cargo add azure_identity azure_security_keyvault_secrets

Вы можете найти доступные имена пакетов в индексе пакетов для Azure.

Important

Используйте стабильный выпуск 1.x Azure SDK для выпусков crate Rust для рабочих нагрузок. Предварительные версии и бета-версии доступны для некоторых контейнеров, но cargo add <crate_name> по умолчанию разрешается до последней стабильной версии.

Установка определенной версии пакета SDK Для Azure

Иногда необходимо использовать определенное требование к версии для параметра crate для тестирования совместимости или обеспечения согласованности в разных средах. Cargo разрешает требование к совместимой версии и записывает точную разрешенную версию.Cargo.lock

cargo add <crate_name>@1

Например, чтобы использовать последнюю стабильную версию версии 1.x:

cargo add azure_storage_blob@1

Дополнительные сведения о синтаксисе требований к версии см. в документации Rust.

Обновление контейнеров Azure SDK

Чтобы обновить все crates до их последних совместимых версий, выполните:

cargo update

Чтобы обновить определенный ящик, выполните следующую команду:

cargo update <crate_name>

Удалите определенный пакет SDK Azure

Чтобы удалить crate из проекта, включая файл Cargo.toml, выполните:

cargo remove <crate_name>

Создайте проект для обновления Cargo.lock файла:

cargo build

Настройка функций кэширования пакета SDK Для Azure

Крейт azure_core предоставляет возможности для всех крейтов Azure SDK, например:

  • reqwest: реализация клиента HTTP.
  • tokio: поддержка асинхронной среды выполнения.

Включение функций ПАКЕТА SDK при добавлении ящика:

cargo add <crate_name> --features <feature_name_1>,<feature_name_2>

Или укажите функции в Cargo.toml:

[dependencies]
<crate_name> = { version = "1", features = ["<feature_name_1>", "<feature_name_2>"] }

Дополнительные ресурсы