Per iniziare

Questa pagina illustra i passaggi di configurazione necessari per utilizzare l'API Cloud Life Sciences.

Se hai completato la guida rapida, hai già eseguito alcuni di questi passaggi. Consulta questa pagina per assicurarti di essere pronto a utilizzare l'API Cloud Life Sciences.

Prima di iniziare

  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.

Informazioni sugli account di servizio e sui ruoli predefiniti

Quando esegui una pipeline per la prima volta (utilizzando l'interfaccia a riga di comando gcloud o le API RPC e REST), vengono eseguiti i seguenti passaggi di autenticazione:

  1. Viene creato un account di servizio denominato Agente di servizio Cloud Life Sciences.
  2. All'account di servizio viene assegnato automaticamente il ruolo predefinito lifesciences.workflowsRunner. Il ruolo consente di avviare e arrestare le istanze Compute Engine all'interno del progetto.

Se in un secondo momento rimuovi il ruolo predefinito dall'account di servizio del progetto pertinente, potresti riscontrare i seguenti errori:

  • I tentativi di eseguire pipeline utilizzando l'API generano errori di autorizzazione. Per risolvere il problema, consulta la sezione Risoluzione dei problemi.
  • L'API non può arrestare le istanze in esecuzione al termine delle pipeline e continuerai a ricevere la fattura per queste risorse. Per risolvere il problema, consulta la sezione Risoluzione dei problemi.

Configura Google Cloud CLI e Google Cloud CLI

Installa Google Cloud CLI per utilizzare gli strumenti e le librerie in Cloud Life Sciences, Compute Engine, Cloud Storage e BigQuery. L'SDK include gli strumenti a riga di comando gcloud, gsutil e bq.

  1. Scarica e installa Google Cloud CLI.

  2. Esegui l'inizializzazione di Google Cloud CLI.

  3. Dopo aver inizializzato l'SDK, installa i componenti Cloud Life Sciences:

    gcloud components update beta

    Se utilizzi una VM Compute Engine con l'installazione predefinita dell'interfaccia alla gcloud CLI, non puoi installare i componenti utilizzando il comando precedente. Per abilitare l'API Cloud Life Sciences su una VM Compute Engine, reinstalla gcloud CLI eseguendo i seguenti comandi: 

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

Scaricare le credenziali per l'accesso alle API

Devi scaricare un file della chiave del account di servizio per il tuo progetto se utilizzi uno dei seguenti metodi per accedere all'API Cloud Life Sciences:

  • Un esempio di codice dal repository GitHub di Cloud Life Sciences
  • Uno strumento diverso da Google Cloud CLI che accede direttamente all'API Cloud Life Sciences

Per creare un file della chiave del account di servizio, completa i seguenti passaggi:

  1. Vai alla pagina Credenziali nella console Google Cloud.

    Vai alla pagina Credenziali

  2. Fai clic su Crea credenziali > Account di servizio.

  3. Nella pagina Dettagli account di servizio, inserisci un nome per l'account di servizio e fai clic su Crea.

  4. Nella scheda Concedi a questo account di servizio l'accesso al progetto, seleziona il ruolo per l'account di servizio. Per l'accesso più ampio a Cloud Life Sciences, seleziona Cloud Life Sciences > Esecutore flussi di lavoro Cloud Life Sciences e poi fai clic su Continua.

  5. (Facoltativo) Compila la scheda Concedi agli utenti l'accesso a questo account di servizio.

  6. Fai clic su Fine.

Per scaricare la chiave dell'account di servizio:

  1. Vai alla pagina Account di servizio nella console Google Cloud.

    Vai alla pagina Account di servizio

  2. Individua la riga dell'account di servizio per cui vuoi creare una chiave. In quella riga, fai clic su e poi su Gestisci chiavi.

  3. Nella pagina Chiavi, fai clic su Aggiungi chiave e poi su Crea nuova chiave.

  4. Seleziona JSON per il Tipo di chiave e fai clic su Crea.

Facendo clic su Crea viene scaricato un file della chiave del service account. Assicurati di archiviare questo file in modo sicuro perché può essere utilizzato per l'autenticazione come account di servizio. Puoi spostare e rinominare il file.

Passaggi successivi