Começar a usar o Rust

Antes de começar, atenda aos seguintes pré-requisitos:

  • Instale o Rust. Se você ainda não instalou o Rust, consulte a documentação em Como começar.

    Para confirmar se o Rust está instalado (e qual versão), use o seguinte comando:

    cargo --version

  • Instale um editor ou ambiente de desenvolvimento integrado.

  • Instale a CLI do Google Cloud.

Criar um novo projeto do Rust

Para criar um novo projeto do Rust, execute o seguinte comando:

cargo new my-project

Mude o diretório para o novo projeto executando o seguinte comando:

cd my-project

Instalar uma Google Cloud biblioteca de cliente

As bibliotecas de cliente do Cloud para Rust são a maneira idiomática para os desenvolvedores Rust se integrarem aos serviços do Google Cloud , como o Secret Manager e o Workflows.

  1. Adicione a biblioteca de cliente do Secret Manager ao novo projeto:

    cargo add google-cloud-secretmanager-v1

  2. Se você ainda não ativou a API Secret Manager, faça isso em APIs e serviços ou executando o seguinte comando:

    gcloud services enable secretmanager.googleapis.com

  3. Adicione o crate google-cloud-gax ao novo projeto:

    cargo add google-cloud-gax

  4. Adicione o crate tokio ao novo projeto:

    cargo add tokio --features macros

  5. Edite src/main.rs no seu projeto para usar a biblioteca de cliente do 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. Por fim, crie o programa:

    cargo build

O programa precisa ser criado sem erros.

Como executar o aplicativo Rust

Para usar as bibliotecas de cliente do Cloud em um ambiente de desenvolvimento local, configure o Application Default Credentials.

Para configurar as Application Default Credentials, execute o seguinte comando:

gcloud auth application-default login

Execute o programa, fornecendo o ID do projeto Google Cloud :

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

O programa vai imprimir os secrets associados ao ID do projeto. Se você não encontrar nenhum secret, talvez não tenha nenhum no Secret Manager. Crie um secret e execute o programa novamente. O secret vai aparecer na saída.