Comienza a usar Rust

Antes de comenzar, debes cumplir con los siguientes requisitos previos:

  • Instala Rust. Si aún no instalaste Rust, consulta la documentación de Rust sobre cómo comenzar.

    Puedes confirmar que tienes instalado Rust (y tu versión de Rust) con el siguiente comando:

    cargo --version
    
  • Instala un editor o IDE.

  • Instala Google Cloud CLI.

Crea un proyecto nuevo de Rust

Para crear un proyecto nuevo de Rust, ejecuta el siguiente comando:

cargo new my-project

Para cambiar tu directorio al proyecto nuevo, ejecuta el siguiente comando:

cd my-project

Instala una Google Cloud biblioteca cliente

Las bibliotecas cliente de Cloud para Rust son la forma idiomática en que los desarrolladores de Rust se integran con los servicios de Google Cloud , como Secret Manager y Workflows.

  1. Agrega la biblioteca cliente de Secret Manager a tu proyecto nuevo:

    cargo add google-cloud-secretmanager-v1
    
  2. Si aún no habilitaste la API de Secret Manager, hazlo en APIs y servicios o ejecuta el siguiente comando:

    gcloud services enable secretmanager.googleapis.com
    
  3. Agrega el crate google-cloud-gax al proyecto nuevo:

    cargo add google-cloud-gax
    
  4. Agrega el crate de Tokio al proyecto nuevo:

    cargo add tokio --features macros
    
  5. Edita src/main.rs en tu proyecto para usar la biblioteca cliente de 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 último, compila tu programa:

    cargo build
    

El programa debería compilarse sin errores.

Cómo ejecutar tu aplicación de Rust

Para usar las bibliotecas cliente de Cloud en un entorno de desarrollo local, configura las credenciales predeterminadas de la aplicación.

Para configurar las credenciales predeterminadas de la aplicación, ejecuta el siguiente comando:

gcloud auth application-default login

Ejecuta tu programa y proporciona el ID del proyecto Google Cloud :

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

El programa imprimirá los secretos asociados con el ID de tu proyecto. Si no ves ningún secreto, es posible que no tengas ninguno en Secret Manager. Crea un secreto, vuelve a ejecutar el programa y deberías ver el secreto impreso en el resultado.