Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Rust を使ってみる

このドキュメントでは、ローカルの Rust 開発環境を設定し、Rust 用の Cloud クライアントライブラリのいずれかをインストールして、最初の Google CloudAPI リクエストを実行する方法について説明します。

始める前に

このドキュメントのコマンドを実行する前に、次の前提条件を満たしてください。

公式の Rust スタートガイドに沿って Rust をインストールします。インストールされたことを確認します。
```
cargo --version
```
エディタまたは IDE をインストールします。
課金が有効になっている Google Cloud プロジェクトを選択または作成します。
Google Cloud CLI をインストールして初期化し、アクティブなアカウントとデフォルトプロジェクトが構成されるようにします。

Rust プロジェクトを作成する

プログラムのバイナリクレートを作成する手順は次のとおりです。

バイナリクレートを作成します。
```
cargo new my-project
```
新しいプロジェクトディレクトリに移動します。
```
cd my-project
```

Google Cloud クライアントライブラリをインストールする

Rust 用 Cloud クライアントライブラリは、Secret Manager などのGoogle Cloud サービスに慣用的な Rust クライアントを提供します。Secret Manager クライアントライブラリを追加してビルドする手順は次のとおりです。

プロジェクトで Secret Manager API を有効にします。
```
gcloud services enable secretmanager.googleapis.com
```
Secret Manager クライアントライブラリをプロジェクトに追加します。
```
cargo add google-cloud-secretmanager-v1
```
ページネーションヘルパーの google-cloud-gax クレートを追加します。
```
cargo add google-cloud-gax
```
非同期ランタイム用の tokio クレートを追加します。
```
cargo add tokio --features macros,rt-multi-thread
```

src/main.rs の内容を次のコードに置き換えて、プロジェクト内のシークレットを一覧表示します。

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    use google_cloud_gax::paginator::ItemPaginator as _;
    use google_cloud_secretmanager_v1::client::SecretManagerService;
    let project_id = std::env::args().nth(1).unwrap();
    let client = SecretManagerService::builder().build().await?;

    let mut items = client
        .list_secrets()
        .set_parent(format!("projects/{project_id}"))
        .by_item();
    while let Some(item) = items.next().await {
        println!("{}", item?.name);
    }
    Ok(())
}

プログラムをビルドして、エラーなくコンパイルされることを確認します。
```
cargo build
```

Rust プログラムを実行する

ローカル環境を認証して、サンプルプログラムを実行します。

ローカル環境のアプリケーションのデフォルト認証情報を構成します。
```
gcloud auth application-default login
```
注: 認証の詳細については、クライアントライブラリを使用して認証するをご覧ください。
Google Cloud プロジェクト ID を引数として渡して、プログラムを実行します。
```
PROJECT_ID=$(gcloud config get project)
cargo run -- "${PROJECT_ID}"
```
プログラムは、プロジェクト内のシークレットの名前を出力します。プロジェクトにまだシークレットがない場合は、シークレットを作成し、コマンドを再度実行して出力に表示します。

クリーンアップ

このドキュメントで使用したリソースについて Google Cloud アカウントに課金されないようにするには、作成したテストシークレットを削除し、完了したらローカルの my-project ディレクトリを削除します。