Passaggio 3: configura il cluster GKE

Specifica gli override della configurazione

Il programma di installazione ibrido Apigee utilizza i valori predefiniti per molte impostazioni; tuttavia, ci sono alcune impostazioni senza valori predefiniti. Devi fornire i valori per queste impostazioni, come spiegato di seguito.

  1. Assicurati di essere nella directory hybrid-base-directory/hybrid-files.
  2. 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 modello ibrido di piccole dimensioni runtime, una configurazione adatta alla prima installazione.

  3. cd nella directory overrides:
  4. cd overrides
  5. Apri overrides.yaml e aggiungi i valori delle proprietà richiesti, come mostrato di seguito. Una dettagliata di seguito viene fornita anche la descrizione di ciascuna proprietà:

    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
    
    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 aggiunto:

    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
    
    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
  6. Al termine, salva il file.

La tabella seguente descrive ciascuno dei valori della proprietà che devi fornire nel file delle sostituzioni.

Variabile Descrizione
project-id L'ID del tuo progetto Google Cloud.
cluster-name Il nome del cluster Kubernetes.
org-name Il nome della tua organizzazione Apigee hybrid.
environment-name Utilizza lo stesso nome che hai utilizzato per creare un ambiente nell'interfaccia utente, come spiegato nel Passaggio 5: aggiungi un nuovo ambiente nell'interfaccia utente ibrida.
test-host-alias

(Obbligatorio) Per la guida rapida, utilizza il carattere jolly "*".

L'utilizzo di * è consigliato solo per un'installazione di prova quando si utilizzano credenziali TLS autofirmate. In seguito, man mano che sviluppi Le configurazioni ibride di Apigee, come la creazione di più ambienti, utilizzare un nome di dominio qualificato per questo valore.

test-cert-name
test-key-name
Inserisci il nome dei file della chiave e del certificato TLS autofirmati che hai generato in precedenza nel passaggio Crea le credenziali TLS per il gateway di runtime. Questi file devono trovarsi in 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 sincronizzatore 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
mart-host-alias Un nome DNS qualificato per l'endpoint del server MART. Questo nome deve corrispondere il nome comune (CN) utilizzato nel certificato TLS autorizzato richiesto per questa configurazione. Ad esempio: mart.mydomain.com
mart-service-account-name Il nome del file della chiave dell'account di servizio del marketplace 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 le 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 la 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. Successivamente, applicherai questa configurazione al cluster.

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