Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 3: configura il cluster utente GKE On-Prem

Specifica gli override della configurazione

Il programma di installazione ibrido Apigee utilizza i valori predefiniti per molte impostazioni, tuttavia alcune non hanno valori predefiniti. Devi specificare i valori per queste impostazioni, come spiegato di seguito.

Assicurati di essere nella directory hybrid-base-directory/hybrid-files.
Copia il file overrides-small.yaml dalla directory $APIGEECTL_HOME/examples alla directory overrides:
```
cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides.yaml
```
Questo file di esempio fornisce una configurazione di base per un'installazione del runtime ibrida di dimensioni ridotte, una configurazione adatta alla prima installazione.
cd nella directory overrides:

cd overrides

Apri overrides.yaml e aggiungi i valori della proprietà obbligatori, come mostrato di seguito. Di seguito è riportata anche una descrizione dettagliata di ciascuna proprietà:

NOTA: assicurati di disabilitare il logging impostando logger:enabled:false nel file degli override. Il logging è fornito per impostazione predefinita come parte di GKE On-Prem.

Sintassi

Il file overrides.yaml ha la struttura e la sintassi seguenti. I valori in red, bold italics sono valori delle proprietà che devi fornire:

gcpProjectID: project-id
k8sClusterName: cluster-name
org: org-name

envs:
  - name: environment-name  # The same name of the env you created in the UI
    hostAlias: test-host-alias
    sslCertPath: ./certs/test-cert-name.pem
    sslKeyPath: ./certs/test-key-name.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/synchronizer-service-account-name.json
      udca: ./service-accounts/udca-service-account-name.json

cassandra:
  hostNetwork: true
  dnsPolicy: ClusterFirstWithHostNet

ingress:
  runtime:
    loadBalancerIP: virtual_IP_runtime
  mart:
    loadBalancerIP: virtual_IP_mart


mart:
  hostAlias: mart-host-alias
  serviceAccountPath: ./service-accounts/mart-service-account-name.json
  sslCertPath: ./certs/mart-cert-name.pem
  sslKeyPath: ./certs/mart-key-name.key

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

logger:
  enabled: false

Esempio

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

gcpProjectID: hybrid-project
k8sClusterName: apigee-hybrid
org: hybrid-org

envs:
  - name: test
    hostAlias: "*"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
      udca: ./service-accounts/hybrid-project-apigee-udca.json

cassandra:
  hostNetwork: true
  dnsPolicy: ClusterFirstWithHostNet

ingress:
  runtime:
    loadBalancerIP: 21.0.124.13
  mart:
    loadBalancerIP: 21.0.124.14

mart:
  hostAlias: "mart.apigee-hybrid-docs.net"
  serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json
  sslCertPath: ./certs/fullchain.pem
  sslKeyPath: ./certs/privkey.key

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

logger:
  enabled: false

Al termine, salva il file.

La seguente tabella descrive tutti i valori delle proprietà da fornire nel file degli override.

Variabile	Descrizione
`project-id`	L'ID del tuo progetto Google Cloud.
`cluster-name`	Il nome del tuo cluster Kubernetes.
`org-name`	Il nome della tua organizzazione Apigee ibrida.
`environment-name`	Utilizza lo stesso nome che hai utilizzato quando hai creato un ambiente nella UI, come spiegato nel Passaggio 5: aggiungi un nuovo ambiente nella UI ibrida.
`test-host-alias`	(Obbligatorio) Per la guida rapida, utilizza il carattere jolly "``". Si consiglia di utilizzare `` solo per un'installazione di prova quando si utilizzano credenziali TLS autofirmate. In seguito, man mano che sviluppi configurazioni ibride di Apigee più complesse, ad esempio creando più ambienti, dovrai utilizzare un nome di dominio qualificato per questo valore.
`test-cert-name` `test-key-name`	Inserisci il nome della chiave TLS autofirmata e dei file dei certificati che hai generato in precedenza nel passaggio Crea le credenziali TLS per il gateway di runtime. Questi file devono trovarsi nella directory `base_directory/hybrid-files/certs`. Ad esempio: sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key .
`synchronizer-service-account-name`	Il nome del file della chiave dell'account di servizio del servizio di sincronizzazione che hai generato con lo strumento `create-service-account`. Ad esempio: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	Il nome del file della chiave dell'account di servizio udca che hai generato con lo strumento `create-service-account`. Ad esempio: udca: ./service-accounts/hybrid-project-apigee-udca.json
`virtual_IP_runtime, virtual_IP_mart`	Per utilizzare il bilanciamento del carico integrato di GKE On-Prem, devi fornire IP virtuali per i bilanciatori del carico sui servizi MART e di runtime ibridi. GKE On-Prem configura automaticamente l'IP virtuale sul bilanciatore del carico BIG-IP di F5. Per maggiori informazioni, consulta Configurare il bilanciatore del carico per GKE On-Prem
`mart-host-alias`	Un nome DNS qualificato per l'endpoint del server MART. Questo nome deve corrispondere al nome comune (CN) utilizzato nel certificato TLS autorizzato richiesto per questa configurazione. Ad esempio: `mart.mydomain.com` NOTA: il nome comune (CN) nel certificato deve corrispondere al valore specificato nella proprietà `mart.hostAlias`. Se il CN è `*.hybrid-domain.net` e hai registrato l'host `mart.hybrid-domain.net`, devi impostare `mart.hostAlias` sul valore `mart.hybrid-domain.net`.
`mart-service-account-name`	Il nome del file della chiave dell'account di servizio mart che hai generato con lo strumento `create-service-account`.
`mart-cert-name` `mart-key-name`	Inserisci il nome della chiave TLS autorizzata e dei file dei certificati che hai generato in precedenza nel passaggio Crea credenziali TLS per il gateway MART. Questi file devono trovarsi nella directory `base_directory/hybrid-files/certs`. Ad esempio: sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key .
`metrics-service-account-name`	Il nome del file della chiave dell'account di servizio delle metriche che hai generato con lo strumento `create-service-account`. Ad esempio: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

Riepilogo

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

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