Comienza ahora

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. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

  4. Habilita la API de Cloud Life Sciences.

    Habilita la API

  5. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  6. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

  7. Habilita la API de Cloud Life Sciences.

    Habilita la API

Información sobre las cuentas de servicio y las funciones predeterminadas

Cuando ejecutas una canalización por primera vez (con la CLI de gcloud o las API de RPC y REST), se producen 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 la función predeterminada lifesciences.workflowsRunner. La función permite iniciar y detener instancias de Compute Engine dentro de tu proyecto.

Si luego quitas la función predeterminada de la cuenta de servicio del proyecto correspondiente, es posible que encuentres los siguientes errores:

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

Configure la CLI de Google Cloud y la de Google Cloud

Instala la CLI de Google Cloud para usar las herramientas y las 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 la CLI de Google Cloud.

  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 la CLI de gcloud, no puedes instalar los componentes con el comando anterior. Para habilitar la API de Cloud Life Sciences en una VM de Compute Engine, vuelve a instalar la CLI de gcloud mediante la ejecución de 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 la CLI de Google Cloud que accede a la API de Cloud Life Sciences directamente

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

  1. Ve a la página Credenciales de Console.

    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, ingrese un nombre para la cuenta de servicio y, luego, haga clic en Crear.

  4. En la pestaña Otorga a esta cuenta de servicio acceso al proyecto, selecciona la función para la cuenta de servicio. Para obtener el acceso más amplio a Cloud Life Sciences, selecciona Cloud Life Sciences > Cloud Life Sciences Workflows Runner y haz clic en Continuar.

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

  6. Haga 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.

    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. Seleccione JSON para el Tipo de clave y haga 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?