Per iniziare

Questa pagina descrive 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. 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 sui service account 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 service account chiamato account di servizio Cloud Life Sciences Service Agent.
    2. Al 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 dal 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 addebiti 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. Inizializza Google Cloud CLI.

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

      gcloud components update beta

      Se utilizzi una VM Compute Engine con l'installazione predefinita della 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

    Scarica le credenziali per l'accesso 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

    Completa i seguenti passaggi per creare un file della chiave del account di servizio:

    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 service account, inserisci un nome per account di servizio e poi fai clic su Crea.

    4. Nella scheda Concedi a questo account di servizio l'accesso al progetto, seleziona il ruolo per il 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 service account.

    6. Fai clic su Fine.

    Per scaricare la chiave del account di servizio, completa i seguenti passaggi:

    1. Vai alla pagina Service account nella console Google Cloud .

      Vai alla pagina Service account

    2. Individua la riga del account di servizio per cui vuoi creare una chiave. In quella riga, fai clic su , quindi fai clic su Gestisci chiavi.

    3. Nella pagina Chiavi, fai clic su Aggiungi chiave, quindi 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 service account. Puoi spostare e rinominare questo file.

    Passaggi successivi