Erste Schritte mit Rust

Bevor Sie beginnen, sollten Sie die folgenden Voraussetzungen erfüllen:

  • Installieren Sie Rust. Wenn Sie Rust noch nicht installiert haben, lesen Sie die Rust-Dokumentation unter Erste Schritte.

    Mit dem folgenden Befehl können Sie prüfen, ob Rust installiert ist und welche Version Sie haben:

    cargo --version

  • Installieren Sie einen Editor oder eine IDE.

  • Installieren Sie die Google Cloud CLI.

Neues Rust-Projekt erstellen

Führen Sie den folgenden Befehl aus, um ein neues Rust-Projekt zu erstellen:

cargo new my-project

Wechseln Sie mit dem folgenden Befehl in das neue Projektverzeichnis:

cd my-project

Clientbibliothek installieren Google Cloud

Die Cloud-Clientbibliotheken für Rust bieten Rust-Entwicklern eine idiomatische Möglichkeit zur Integration in Google Cloud -Dienste wie Secret Manager und Workflows.

  1. Fügen Sie Ihrem neuen Projekt die Secret Manager-Clientbibliothek hinzu:

    cargo add google-cloud-secretmanager-v1

  2. Wenn Sie die Secret Manager API noch nicht aktiviert haben, aktivieren Sie sie unter APIs und Dienste oder führen Sie den folgenden Befehl aus:

    gcloud services enable secretmanager.googleapis.com

  3. Fügen Sie dem neuen Projekt das google-cloud-gax-Crate hinzu:

    cargo add google-cloud-gax

  4. Fügen Sie dem neuen Projekt die Tokio-Crate hinzu:

    cargo add tokio --features macros

  5. Bearbeiten Sie src/main.rs in Ihrem Projekt, um die Secret Manager-Clientbibliothek zu verwenden:

    #[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(())
}

  6. Erstellen Sie zum Schluss Ihr Programm:

    cargo build

Das Programm sollte ohne Fehler kompiliert werden.

Rust-Anwendung ausführen

Wenn Sie die Cloud-Clientbibliotheken in einer lokalen Entwicklungsumgebung verwenden möchten, richten Sie Standardanmeldedaten für Anwendungen ein.

Führen Sie den folgenden Befehl aus, um Standardanmeldedaten für Anwendungen einzurichten:

gcloud auth application-default login

Führen Sie Ihr Programm aus und geben Sie Ihre Google Cloud Projekt-ID an:

PROJECT_ID=$(gcloud config get project)
cargo run ${PROJECT_ID}

Das Programm gibt die Secrets aus, die Ihrer Projekt-ID zugeordnet sind. Wenn Sie keine Secrets sehen, haben Sie möglicherweise keine in Secret Manager. Erstellen Sie ein Secret und führen Sie das Programm noch einmal aus. Das Secret sollte in der Ausgabe angezeigt werden.