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

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

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

Подсказка

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

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

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

cargo add <crate_name>

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

cargo add azure_identity azure_security_keyvault_secrets

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

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

Иногда требуется установить определённую версию пакета для тестирования совместимости или поддержания согласованности в различных средах. При указании версии вы закрепляете зависимость. Проект продолжает использовать такую версию и не получает основных или незначительных обновлений, но по-прежнему может получать обновления исправлений. Хотя закрепление может оказаться полезным в некоторых сценариях, рекомендуется использовать последнюю версию, чтобы воспользоваться текущими улучшениями и обновлениями системы безопасности.

cargo add <crate_name>@<version_number>

Рассмотрим пример.

cargo add azure_storage_blob@0.20.0

Вы также можете указать требования к версии в файле Cargo.toml. Дополнительные сведения о синтаксисе требований к версии см. в документации 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 = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }

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