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 クレートを取得します。 必要な個々のクレートをインストールします。
cargo add <crate_name>
<crate_name>を、インストールする Azure クレートの名前に置き換えます。 たとえば、Azure Identity シークレットと Key Vault シークレット クレートをインストールするには、次のようにします。
cargo add azure_identity azure_security_keyvault_secrets
使用可能なクレート名は 、Azure のクレート インデックスで確認できます。
特定の Azure SDK クレート バージョンをインストールする
互換性テストのために、または環境間で一貫性を維持するために、特定 のバージョンのクレート をインストールする必要がある場合があります。 バージョンを指定する場合は、依存関係を ピン留めします 。 プロジェクトでは引き続きそのバージョンが使用され、メジャー更新プログラムやマイナー更新プログラムは自動的に受信されませんが、引き続き修正プログラムの更新プログラムを受け取ることができます。 ピン留めは特定のシナリオで役立ちますが、最新バージョンを使用して、継続的な機能強化とセキュリティ更新プログラムの恩恵を受けることをお勧めします。
cargo add <crate_name>@<version_number>
例えば次が挙げられます。
cargo add azure_storage_blob@0.20.0
Cargo.toml ファイルでバージョン要件を指定することもできます。 バージョン要件の構文の詳細については、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 = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }
その他のリソース
- Crates.io 上の Azure SDK クレート - 使用可能な Azure SDK クレートの一覧
- Azure SDK の設計ガイドライン - 設計の原則とパターン
- Azure SDK for Rust GitHub リポジトリ - 問題とソース コード
- Cargo ドキュメント - 完全な Cargo リファレンス