Comenzar

Esta página te guiará a través de los pasos de configuración necesarios para usar la API de Cloud Life Sciences.

(Si completaste la Guía de inicio rápido, ya has realizado alguno de estos pasos. Revisa esta página a fin de asegurarte de que estás listo para usar la API de Cloud Life Sciences).

Antes de comenzar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Life Sciences API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Life Sciences API.

    Enable the API

    8.

Comprende las cuentas de servicio y los roles predeterminados

Cuando ejecutas una canalización por primera vez (con gcloud CLI o las APIs de RPC y REST), se realizan los siguientes pasos de autenticación:

  1. Se crea una cuenta de servicio llamada Agente de servicio de Cloud Life Sciences.
  2. A la cuenta de servicio se le asigna automáticamente el rol predeterminado lifesciences.workflowsRunner. El rol permite iniciar y detener instancias de Compute Engine dentro de tu proyecto.

Si luego quitas el rol predeterminado de la cuenta de servicio del proyecto pertinente, es posible que se produzcan los siguientes errores:

  • Los intentos de ejecutar canalizaciones con la API generan errores de permiso. Para solucionar este problema, consulta Solución de problemas.
  • La API no puede cerrar las instancias en ejecución cuando se completan las canalizaciones y se seguirán facturando estos recursos. Para solucionar este problema, consulta Solución de problemas.

Configura Google Cloud CLI

Instala Google Cloud CLI para usar las herramientas y bibliotecas en Cloud Life Sciences, Compute Engine, Cloud Storage y BigQuery. El SDK incluye las herramientas de línea de comandos gcloud, gsutil y bq.

  1. Descarga e instala Google Cloud CLI.

  2. Inicializa Google Cloud CLI.

  3. Después de inicializar el SDK, instala los comandos de Cloud Life Sciences:

    gcloud components update beta

    Si usas una VM de Compute Engine con la instalación predeterminada de gcloud CLI, no puedes instalar los componentes con el comando anterior. Para habilitar la API de Cloud Life Sciences en una VM de Compute Engine, reinstala gcloud CLI. Para ello, ejecuta los siguientes comandos: 

    sudo apt-get remove google-cloud-sdk
    curl https://sdk.cloud.google.com | bash
    exec -l $SHELL
    gcloud init

Descarga credenciales para el acceso a la API

Debes descargar un archivo de claves de cuenta de servicio para tu proyecto si usas alguno de los siguientes métodos a fin de acceder a la API de Cloud Life Sciences:

  • Una muestra de código del repositorio de GitHub de Cloud Life Sciences
  • Una herramienta que no sea Google Cloud CLI, que accede directamente a la API de Cloud Life Sciences

Completa los siguientes pasos para crear un archivo de clave de cuenta de servicio:

  1. Ve a la página Credenciales en la consola de Google Cloud.

    Ir a la página Credenciales

  2. Haz clic en Crear credenciales > Cuenta de servicio.

  3. En la página Detalles de la cuenta de servicio, ingresa un nombre para la cuenta de servicio y, luego, haz clic en Crear.

  4. En la pestaña Otorga a esta cuenta de servicio acceso al proyecto, selecciona el rol de la cuenta de servicio. Para obtener el acceso más amplio a Cloud Life Sciences, selecciona Cloud Life Sciences > Ejecutor de flujos de trabajo de Cloud Life Sciences y, luego, haz clic en Continuar.

  5. (Opcional) Llena la pestaña Otorgar a los usuarios acceso a esta cuenta de servicio.

  6. Haz clic en Listo.

Para descargar la clave de la cuenta de servicio, completa los siguientes pasos:

  1. Ve a la página Cuentas de servicio en la consola de Google Cloud.

    Ir a la página Cuentas de servicio

  2. Busca la fila de la cuenta de servicio para la que quieres crear una clave. En esa fila, haz clic en y, luego, en Administrar claves.

  3. En la página Claves, haz clic en Agregar clave y, luego, en Crear clave nueva.

  4. Selecciona JSON para el Tipo de clave y haz clic en Crear.

Si haces clic en Crear, se descargará un archivo de claves de cuenta de servicio. Asegúrate de almacenar este archivo de forma segura, ya que lo puedes usar para autenticarte como tu cuenta de servicio. Puedes mover y cambiar el nombre de este archivo.

¿Qué sigue?