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. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  4. Activez l'API Cloud Life Sciences

    Activer l'API

    5.

  5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  6. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  7. Activez l'API Cloud Life Sciences

    Activer l'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

Installez Google Cloud CLI pour utiliser les outils et les bibliothèques de 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 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 de 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.

Étapes suivantes