create-service-account

Crea account di servizio della piattaforma Google Cloud con ruoli che consentono ai singoli componenti ibridi Apigee di effettuare chiamate API autorizzate e scarica i file chiave degli account di servizio associati. Puoi utilizzare i file delle chiavi degli account di servizio generati da questo comando nel file degli override della configurazione.

Lo strumento create-service-account si trova nella directory HYBRID_ROOT_DIR/tools.

Prerequisiti

Lo strumento create-service-account richiede l'installazione dell'interfaccia a riga di comando gcloud. Gli utenti che richiamano l'utilità devono avere il ruolo Service Account Admin.

Per iniziare, assicurati che la configurazione del progetto gcloud sia impostata sul progetto che hai creato nel Passaggio 2. Crea un progetto Google Cloud:

gcloud config list project

Se devi modificare l'ID progetto attuale, usa il comando seguente: 

gcloud config set project GC_PROJECT_ID

Dove GC_PROJECT_ID è il progetto creato nel Passaggio 2: crea un progetto Google Cloud.

sintassi create-service-account

Lo strumento create-service-account utilizza la seguente sintassi:

create-service-account HYBRID_SERVICE OUTPUT_DIR [GC_PROJECT_ID]

Dove:

  • HYBRID_SERVICE: specifica il servizio ibrido che utilizza l'account di servizio. I valori validi sono:
    • apigee-cassandra
    • apigee-distributed-trace
    • apigee-logger
    • apigee-mart
    • apigee-metrics
    • apigee-synchronizer
    • apigee-udca
    • apigee-watcher

    Tieni presente che lo strumento create-service-account non può creare l'account di servizio apigee-org-admin. Devi crearlo con le API gcloud, come descritto in Creare account di servizio.

  • OUTPUT_DIR: la directory di output in cui archiviare la chiave dell'account di servizio scaricata.
  • GCP_PROJECT_ID (facoltativo) specifica l'ID del progetto Google Cloud associato alla tua organizzazione con abilitazione ibrida. Se l'ID progetto Google Cloud non viene fornito, lo strumento tenta di recuperarlo dalla configurazione gcloud attuale.

Descrizione dettagliata

Lo strumento create-service-account:

  • Crea account di servizio Google Cloud utilizzati dai componenti ibridi. All'account di servizio creato viene concesso il ruolo richiesto dal componente specifico per il funzionamento.
  • Scarica la chiave dell'account di servizio nel sistema. Devi inserire le chiavi dell'account di servizio nel file degli override della configurazione ibrida, come spiegato nelle istruzioni di installazione ibride.

Lo strumento crea account di servizio per i seguenti componenti:

Componente* Ruolo Necessaria per l'installazione di base? Descrizione
apigee-cassandra Amministratore oggetti Storage
roles/storage.objectAdmin		 Consente a Cassandra di eseguire backup in Cloud Storage, come descritto in Backup e ripristino.
apigee-distributed-trace Agente Cloud Trace
roles/cloudtrace.agent		 Consente al piano di runtime ibrido di partecipare al tracciamento delle richieste distribuite in un formato compatibile con sistemi come Google Cloud Trace e Jaeger.
apigee-logger Writer log
roles/logging.logWriter		 Consente la raccolta dei dati di logging, come descritto in Logging. Obbligatorio solo per le installazioni di cluster non GKE.
apigee-mart Agente Apigee Connect
roles/apigeeconnect.Agent		 Consente l'autenticazione del servizio MART. Il ruolo Agente Apigee Connect gli consente di comunicare in modo sicuro con il processo Apigee Connect, come descritto in Utilizzo di Apigee Connect.
apigee-metrics Writer metriche Monitoring
roles/monitoring.metricWriter		 Consente la raccolta dei dati delle metriche, come descritto in Panoramica della raccolta delle metriche.
apigee-synchronizer Gestore della sincronizzazione di Apigee
roles/apigee.synchronizerManager		 Consente al sincronizzatore di scaricare bundle proxy e dati di configurazione dell'ambiente. Consente inoltre di utilizzare la funzionalità di traccia.
apigee-udca Agente Apigee Analytics
roles/apigee.analyticsAgent		 Consente il trasferimento dei dati di traccia, analisi e stato del deployment nel piano di gestione.
apigee-watcher Agente di runtime Apigee
roles/apigee.runtimeAgent		 Apigee Watcher estrae le modifiche relative agli host virtuali per un'organizzazione dal sincronizzatore e apporta le modifiche necessarie per configurare il traffico Istio in entrata.
* Questo nome viene utilizzato nel nome file della chiave dell'account di servizio scaricata.

Puoi anche creare account di servizio nella console Google Cloud. Vedi anche Creazione e gestione degli account di servizio.

Esempio

L'esempio seguente crea un nuovo account di servizio per il servizio apigee-logger e inserisce la chiave scaricata nella directory ./service-accounts.

./my-hybrid-root/tools/create-service-account apigee-logger ./service-accounts