Passaggio 4: configurazione del cluster

Specificare le sostituzioni della configurazione

Il programma di installazione ibrido Apigee utilizza i valori predefiniti per molte impostazioni; tuttavia, esistono alcune impostazioni che non sono predefinite. È necessario fornire valori per queste impostazioni, come spiegato di seguito.

Assicurati di essere nella directory hybrid-base-directory/hybrid-files/overrides/.
```
cd hybrid-base-directory/hybrid-files/overrides
```
Crea un nuovo file denominato overrides.yaml nel tuo editor di testo preferito. Ad esempio:
```
vi overrides.yaml
```
overrides.yaml fornisce la configurazione per la tua installazione unica di Apigee lavoro ibrido. Il file delle sostituzioni in questo passaggio fornisce una configurazione di base per un'installazione con runtime ibrido per ambienti di piccole dimensioni, adatta alla tua prima installazione.

In overrides.yaml, aggiungi i valori delle proprietà obbligatori, mostrati di seguito. Di seguito viene fornita anche una descrizione dettagliata di ogni proprietà:

Syntax

Assicurati che la struttura e la sintassi del file overrides.yaml abbiano la seguente struttura. I valori in red, bold italics sono valori di proprietà che devi fornire. Sono descritti nella tabella seguente.


gcp:
  region: analytics-region # Choose the closest Google Cloud region to your cluster.
  projectID: gcp-project-id

k8sCluster:
  name: cluster-name
  region: analytics-region # Choose the closest Google Cloud region to your cluster.

org: org-name

instanceID: "unique-instance-identifier"

cassandra:
  hostNetwork: true #Set this to `false` for platforms other than GKE On-prem.

virtualhosts:
  - name: environment-group-name
    sslCertPath: ./certs/cert-name.pem
    sslKeyPath: ./certs/key-name.key

envs:
  - name: environment-name
    serviceAccountPaths:
      synchronizer: ./service-accounts/synchronizer-service-account-name.json
      udca: ./service-accounts/udca-service-account-name.json

mart:
  serviceAccountPath: ./service-accounts/mart-service-account-name.json

connectAgent:
  serviceAccountPath: ./service-accounts/mart-service-account-name.json
  # Same account used for mart and connectAgent

metrics:
  serviceAccountPath: ./service-accounts/metrics-service-account-name.json

watcher:
  serviceAccountPath: ./service-accounts/watcher-service-account-name.json

logger:
  enabled: true
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

Esempio

L'esempio seguente mostra un file di override completato con esempi di valori di proprietà aggiunti:

gcp:
  region: us-central1
  projectID: hybrid-example

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-example

instanceID: "my_hybrid_example"

cassandra:
  hostNetwork: true #Set this to `false` for platforms other than GKE-On Prem.

virtualhosts:
  - name: example-env-group
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key

envs:
  - name: test
    serviceAccountPaths:
      synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
      udca: ./service-accounts/hybrid-project-apigee-udca.json

mart:
  serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json

connectAgent:
  serviceAccountPath: ./service-accounts/example-hybrid-apigee-mart.json

metrics:
  serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

watcher:
  serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json

logger:
  enabled: true
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

Al termine, salva il file.

La tabella seguente descrive ciascuno dei valori delle proprietà che devi fornire nel file di override. Per ulteriori informazioni, consulta Riferimento proprietà della configurazione.

Variabile	Descrizione
`analytics-region`	Devi impostare questo valore sulla stessa area geografica in cui è in esecuzione il cluster. Questo è il valore assegnato alla variabile di ambiente `ANALYTICS_REGION` in precedenza durante la creazione del cluster `apigee-logger` e `apigee-metrics` inviano i dati a questa area geografica.
`gcp-project-id`	Identifica il progetto Google Cloud in cui `apigee-logger` e `apigee-metrics` inviano i dati. Questo è il valore assegnato alla variabile di ambiente `PROJECT_ID`.
`cluster-name`	Il nome del cluster Kubernetes. Questo è il valore assegnato alla variabile di ambiente `CLUSTER_NAME`.
`org-name`	L'ID della tua organizzazione ibrida di Apigee. Questo è il valore assegnato alla variabile di ambiente `ORG_NAME`.
`unique-instance-identifier`	Una stringa univoca per identificare questa istanza. Può essere qualsiasi combinazione di lettere e numeri con una lunghezza massima di 63 caratteri.
`environment-group-name`	Il nome del gruppo di ambienti a cui sono assegnati i tuoi ambienti. Si tratta del gruppo che hai creato nella configurazione del progetto e dell'organizzazione - Passaggio 6: crea un gruppo di ambiente. Questo è il valore assegnato alla variabile di ambiente `ENV_GROUP`. Nota: se vuoi posizionare istanze del cluster in più aree geografiche, devi fare attenzione a come definisci i tuoi ambienti e gli host virtuali. Se hai associato uno o più ambienti a un gruppo di ambienti, devi includere la stessa configurazione del gruppo di ambienti in ogni file di override dell'istanza del cluster.
`cert-name` `key-name`	Inserisci il nome della chiave TLS e dei file del certificato autofirmati che hai generato in precedenza nel Passaggio 3: installa Apigeectl. Questi file devono trovarsi nella directory `base_directory/hybrid-files/certs`. Ad esempio: sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`environment-name`	Utilizza lo stesso nome che hai utilizzato quando hai creato un ambiente nell'interfaccia utente, come spiegato nella Configurazione del progetto e dell'organizzazione - Passaggio 6: crea un gruppo di ambiente.
`synchronizer-service-account-name`	Il nome della chiave dell'account di servizio `synchronizer` che hai generato con lo strumento `create-service-account`. Ad esempio: serviceAccountPath: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	Il nome della chiave dell'account di servizio `udca` che hai generato con lo strumento `create-service-account`. Ad esempio: serviceAccountPath: udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-service-account-name`	Il nome del file JSON della chiave dell'account di servizio `mart` che hai generato con lo strumento `create-service-account`.
`metrics-service-account-name`	Il nome del file JSON dell'account di servizio di metriche generato con lo strumento `create-service-account`. Ad esempio: metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
`mart-service-account-name`	Il nome dell'account di servizio `mart` (a cui è assegnato il ruolo Agente Apigee Apigee) creato nel Passaggio 3: installa Apigeectl. MART e l'agente Apigee Connect utilizzano lo stesso account di servizio.
`watcher-service-account-name`	Il nome del file JSON dell'account di servizio `watcher` che hai generato con lo strumento `create-service-account`. Ad esempio: watcher: serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json

Riepilogo

Il file di configurazione indica a Kubernetes come eseguire il deployment dei componenti ibridi in un cluster. Successivamente, applicherai questa configurazione al tuo cluster.

Passaggio successivo

1 2 3 4 (AVANTI) Passaggio 5: installa il runtime di ibrido