Azure SDK for Rust を使用すると、Cargo を使用して個々の SDK クレートをインストールすることで、Rust プロジェクト内の Azure サービスにアクセスできます。 この記事では、必要な機能のみを追加し、プロジェクトを最新の状態に保つために、Azure SDK for Rust クレートをインストール、更新、管理する方法について説明します。
クレートを使用して開発するための前提条件
- Rust 1.85.0 以降。 バージョンは、Azure SDK for Rust Cargo.toml で指定されています。
- Azure サブスクリプション。 無料で作成できます。
ヒント
最適な開発エクスペリエンスを実現するために、最新の安定したバージョンの Rust がインストールされていることを確認します。
最新の Azure SDK クレート バージョンをインストールする
crates.io から Azure SDK クレートを取得します。 必要な個々のクレートをインストールします。
Rust クレートの最新のAzure SDKは、そのクレートの最新の安定した 1.x リリースです。
cargo add <crate_name>
<crate_name>を、インストールする Azure クレートの名前に置き換えます。 たとえば、現在の安定したAzure ID とKey Vaultシークレット クレートをインストールするには、次のようにします。
cargo add azure_identity azure_security_keyvault_secrets
使用可能なクレート名は 、Azure のクレート インデックスで確認できます。
Important
運用ワークロードの Rust クレート リリースには、安定した 1.x Azure SDKを使用します。 一部のクレートではプレビューリリースとベータリリースを利用できますが、 cargo add <crate_name> は既定で最新の安定版リリースに解決されます。
特定の Azure SDK クレート バージョンをインストールする
互換性テストのためにクレートに特定の バージョン要件を 使用したり、環境間で一貫性を維持したりする必要がある場合があります。 Cargo は要件を互換性のあるバージョンに解決し、解決された正確なバージョンを Cargo.lockに記録します。
cargo add <crate_name>@1
たとえば、最新の安定した 1.x リリースを使用するには、次のようにします。
cargo add azure_storage_blob@1
バージョン要件の構文の詳細については、Rust の ドキュメントを参照してください。
Azure SDK クレートを更新する
すべてのクレートを最新の互換性のあるバージョンに更新するには、次のコマンドを実行します。
cargo update
特定のクレートを更新するには、次のコマンドを実行します。
cargo update <crate_name>
特定の Azure SDK クレートを削除する
Cargo.toml ファイルを含む、プロジェクトからクレートを削除するには、次のコマンドを実行します。
cargo remove <crate_name>
プロジェクトをビルドして、 Cargo.lock ファイルを更新します。
cargo build
Azure SDK クレート機能を構成する
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>"] }
その他のリソース
- Crates.io 上の Azure SDK クレート - 使用可能な Azure SDK クレートの一覧
- Azure SDK の設計ガイドライン - 設計の原則とパターン
- Azure SDK for Rust GitHub リポジトリ - 問題とソース コード
- Cargo のドキュメント - Cargo の完全リファレンス