Premiers pas avec Rust

Avant de commencer, vous devez remplir les conditions préalables suivantes :

  • Installez Rust. Si vous n'avez pas encore installé Rust, consultez la documentation Rust sur Premiers pas.

    Vous pouvez vérifier que Rust est installé (et connaître votre version de Rust) à l'aide de la commande suivante :

    cargo --version

  • Installez un éditeur ou un IDE.

  • Installez Google Cloud CLI.

Créer un projet Rust

Pour créer un projet Rust, exécutez la commande suivante :

cargo new my-project

Accédez au nouveau projet en exécutant la commande suivante :

cd my-project

Installer une bibliothèque cliente Google Cloud

Les bibliothèques clientes Cloud pour Rust sont le moyen idiomatique dont disposent les développeurs Rust pour intégrer les services Google Cloud , tels que Secret Manager et Workflows.

  1. Ajoutez la bibliothèque cliente Secret Manager à votre nouveau projet :

    cargo add google-cloud-secretmanager-v1

  2. Si vous ne l'avez pas déjà fait, activez l'API Secret Manager dans API et services ou en exécutant la commande suivante :

    gcloud services enable secretmanager.googleapis.com

  3. Ajoutez le crate google-cloud-gax au nouveau projet :

    cargo add google-cloud-gax

  4. Ajoutez la crate tokio au nouveau projet :

    cargo add tokio --features macros

  5. Modifiez src/main.rs dans votre projet pour utiliser la bibliothèque cliente Secret Manager :

    #[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. Enfin, créez votre programme :

    cargo build

Le programme doit se compiler sans erreur.

Exécuter votre application Rust

Pour utiliser les bibliothèques clientes Cloud dans un environnement de développement local, configurez les Identifiants par défaut de l'application.

Pour configurer les Identifiants par défaut de l'application, exécutez la commande suivante :

gcloud auth application-default login

Exécutez votre programme en fournissant l'ID de votre projet Google Cloud  :

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

Le programme affichera les secrets associés à votre ID de projet. Si vous ne voyez aucun secret, cela signifie peut-être que vous n'en avez pas dans Secret Manager. Créez un secret, réexécutez le programme et le secret devrait s'afficher dans le résultat.