Premiers pas

Cette page vous guide à travers les étapes de configuration requises pour utiliser l'API Cloud Life Sciences.

(Si vous avez terminé le Guide de démarrage rapide, vous avez déjà réalisé certaines de ces étapes. Passez en revue les étapes présentées ici pour vous assurer que vous êtes prêt à utiliser l'API Cloud Life Sciences).

Avant de commencer

  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.

Comprendre les comptes de service et les rôles par défaut

Lorsque vous exécutez un pipeline pour la première fois (à l'aide de gcloud CLI ou des API RPC et REST), les étapes d'authentification suivantes se produisent:

  1. Un compte de service appelé agent de service Cloud Life Sciences est créé.
  2. Le compte de service se voit automatiquement attribuer le rôle lifesciences.workflowsRunner par défaut. Ce rôle permet de démarrer et d'arrêter des instances Compute Engine dans votre projet.

Si vous supprimez par la suite le rôle par défaut du compte de service du projet concerné, vous pouvez rencontrer les erreurs suivantes :

  • Les tentatives d'exécution de pipelines à l'aide de l'API génèrent des erreurs d'autorisation. Pour savoir comment résoudre ce problème, consultez la section Dépannage.
  • L'API ne peut pas arrêter les instances en cours d'exécution lorsque les pipelines se terminent, et ces ressources continuent de vous être facturées. Pour savoir comment résoudre ce problème, consultez la section Dépannage.

Configurer Google Cloud CLI et Google Cloud CLI

Installez la Google Cloud CLI pour utiliser les outils et les bibliothèques Cloud Life Sciences, Compute Engine, Cloud Storage et BigQuery. Le SDK comprend les outils de ligne de commande gcloud, gsutil et bq.

  1. Téléchargez et installez Google Cloud CLI.

  2. Initialisez Google Cloud CLI.

  3. Après avoir initialisé le SDK, installez les composants Cloud Life Sciences :

    gcloud components update beta

    Si vous utilisez une VM Compute Engine avec l'installation par défaut de gcloud CLI, vous ne pouvez pas installer les composants à l'aide de la commande précédente. Pour activer l'API Cloud Life Sciences sur une VM Compute Engine, réinstallez gcloud CLI en exécutant les commandes suivantes : 

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

Télécharger les identifiants d'accès à l'API

Vous devez télécharger un fichier de clé de compte de service pour votre projet si vous utilisez l'une des méthodes suivantes pour accéder à l'API Cloud Life Sciences :

  • Un exemple de code du dépôt GitHub Cloud Life Sciences
  • Un outil autre que la Google Cloud CLI qui accède directement à l'API Cloud Life Sciences

Pour créer un fichier de clé de compte de service, procédez comme suit :

  1. Accédez à la page Identifiants dans la console Google Cloud.

    Accéder à la page Identifiants

  2. Cliquez sur Créer des identifiants > Compte de service.

  3. Sur la page Détails du compte de service, saisissez un nom de compte de service, puis cliquez sur Créer.

  4. Dans l'onglet Autoriser ce compte de service à accéder au projet, sélectionnez le rôle pour le compte de service. Pour un accès plus large à Cloud Life Sciences, sélectionnez Cloud Life Sciences > Exécuteur de workflows Cloud Life Sciences, puis cliquez sur Continuer.

  5. Facultatif : Renseignez l'onglet Autoriser les utilisateurs à accéder à ce compte de service.

  6. Cliquez sur OK.

Pour télécharger la clé du compte de service, procédez comme suit :

  1. Accédez à la page Comptes de service dans Google Cloud Console.

    Accéder à la page "Comptes de service"

  2. Recherchez la ligne du compte de service pour lequel vous souhaitez créer une clé. Cliquez sur sur cette ligne, puis sur Gérer les clés.

  3. Sur la page Clés, cliquez sur Ajouter une clé, puis sur Créer une clé.

  4. Sélectionnez JSON pour le type de clé, puis cliquez sur Créer.

Cliquez sur Créer pour télécharger un fichier de clé de compte de service. Veillez à stocker ce fichier en toute sécurité, car il peut être utilisé pour s'authentifier en tant que compte de service. Vous pouvez déplacer et renommer ce fichier.

Étape suivante