Cette page a été traduite par l'API Cloud Translation.
Switch to English

Commencer

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. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez l'API Cloud Life Sciences.

    Activer l'API

Lorsque vous exécutez un pipeline pour la première fois (à l'aide de l'outil gcloud ou des API RPC et REST) d'un projet Google Cloud, un nouveau compte de service pour le projet se voient automatiquement attribuer un rôle (lifesciences.workflowsRunner) qui permet de démarrer et d'arrêter des instances Compute Engine dans votre projet.

Si vous supprimez ultérieurement ce rôle par défaut du compte de service du projet concerné, vous risquez de rencontrer des erreurs. Plus précisément, les tentatives d'exécution de pipelines à l'aide de l'API entraîneront des erreurs d'autorisation. L'API sera également incapable d'arrêter les instances en cours d'exécution lorsque les pipelines seront terminés, et ces ressources continueront de vous être facturées. Pour en savoir plus sur la résolution de ce problème, consultez la page Dépannage.

Configurer le SDK Cloud et l'outil de ligne de commande gcloud

Installez le SDK Cloud afin d'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 le SDK Cloud.

  2. Initialisez le SDK Cloud.

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

    gcloud components update beta
    

    Si vous utilisez une VM Compute Engine avec l'installation par défaut de l'outil gcloud, vous ne pouvez pas mettre à jour ses composants. Pour activer l'API Cloud Life Sciences sur une VM Compute Engine, réinstallez l'outil de ligne de commande gcloud 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

Si vous utilisez un exemple de code du dépôt GitHub de Cloud Life Sciences, ou un outil autre que l'outil de ligne de commande gcloud qui accède à Cloud Life Sciences API, procédez comme suit pour télécharger un fichier de clé de compte de service pour votre projet.

  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. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activer les API Cloud Life Sciences and Cloud Storage JSON.

    Activer les API

  5. Accédez à la page Identifiants dans la console d'API.
  6. Cliquez sur Créer des identifiants > Compte de service.
  7. Sur la page Détails du compte de service, saisissez un nom de compte de service, puis cliquez sur Créer.
  8. Dans l'onglet Autoriser ce compte de service à accéder au projet, sélectionnez le rôle associé au 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.
  9. Facultatif: Remplissez l'onglet Autoriser les utilisateurs à accéder à ce compte de service.
  10. Cliquez sur OK.

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

  1. Dans Cloud Console, accédez à la page Comptes de service.

    Accéder à la page "Comptes de service"

  2. Recherchez la ligne du compte de service pour lequel vous souhaitez créer une clé. Sur cette ligne, cliquez sur le bouton , puis cliquez sur Gérer 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 comme vous le souhaitez.

Étape suivante