Inizia

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

Se hai completato la Guida rapida, hai già completato alcuni di questi passaggi. Consulta questa pagina per assicurarti di poter utilizzare i contenuti pronti per l'uso 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. 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

Informazioni sugli account di servizio e sui ruoli predefiniti

Quando esegui una pipeline per la prima volta (utilizzando gcloud CLI 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 di 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 completamento delle pipeline e ti verranno addebitati i relativi costi Google Cloud. Per risolvere il problema, consulta la sezione Risoluzione dei problemi.

Configurare Google Cloud CLI e Google Cloud

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

  1. Scarica e installa Google Cloud CLI.

  2. Inizializza Google Cloud CLI.

  3. Dopo aver inizializzato l'SDK, installa il Componenti di Cloud Life Sciences:

    gcloud components update beta

    Se utilizzi una VM Compute Engine con l'installazione predefinita dell'interfaccia a riga di comando gcloud, 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
    

Scarica le credenziali per l'accesso API

Devi scaricare un file delle chiavi dell'account di servizio per il tuo progetto, se utilizzando 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 dell'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, completa i seguenti passaggi:

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

    Vai al servizio Pagina Account

  2. Trova 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, quindi su Crea nuova chiave.

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

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

Passaggi successivi