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. Di seguito è riportata anche una descrizione dettagliata di ogni proprietà:

    Sintassi

    Il file overrides.yaml ha la seguente struttura e sintassi. I valori in red, bold italics sono che devi fornire. Sono descritti nella tabella riportata di seguito.

    gcp:
      region: gcp-region
      projectID: gcp-project-id
    
    k8sCluster:
      name: cluster-name
      region: cluster-region
    
    org: org-name
    
    virtualhosts:
      - name: virtual-host-name
        hostAliases:
          - "host-alias-1"
          - "host-alias-2"
          - "host-alias-n"
        sslCertPath: ./certs/cert-name.pem
        sslKeyPath: ./certs/key-name.key
        routingRules:
          - paths:
            - /path-1
            - /path-2
            - /path-n
            env: environment-name
    
    envs:
      - name: environment-name          # The same name of the env you created in the UI
        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 delle sostituzioni completato con valori di proprietà di esempio aggiunti:

    gcp:
      region: us-central1
      projectID: my-gcp-project
    
    k8sCluster:
      name: apigee-hybrid
      region: us-central1
    
    org: hybrid-org
    
    virtualhosts:
      - name: default
        hostAliases:
          - "*.acme.com"
        sslCertPath: ./certs/keystore.pem
        sslKeyPath: ./certs/keystore.key
        routingRules:
          # - paths:
          - env: my-environment
    
    envs:
      - name: test
        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 delle proprietà che devi fornire nel file delle sostituzioni. Per ulteriori informazioni, consulta Riferimento per le proprietà di configurazione.

Variabile Descrizione
gcp-region Identifica la regione della piattaforma Google Cloud in cui apigee-logger e apigee-metrics inviano i dati.
gcp-project-id Identifica il progetto Google Cloud in cui apigee-logger e apigee-metrics inviano i propri dati.
cluster-name Il nome del tuo cluster Kubernetes.
cluster-region La regione in cui è stato creato il cluster.
org-name Il nome della tua organizzazione Apigee ibrida.
virtual-host-name Un nome per identificare l'host virtuale.
host-alias (1 - n)

(Obbligatorio) Un nome DNS qualificato per l'ambiente. Puoi usare un modello come *.foo.com. Il carattere jolly generico "*" non è consentito.

cert-name
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 nella directory base_directory/hybrid-files/certs. Ad esempio:
sslCertPath: ./certs/keystore.pem
sslKeyPath: ./certs/keystore.key
path (1 - n) Le regole di routing indirizzano le chiamate API ai percorsi forniti per l'ambiente menzionato. Da path-1 a path-n sono i percorsi di base dei proxy API di cui è stato eseguito il deployment nell'ambiente denominato in environment-name.
paths: è facoltativo. Il percorso predefinito è /. Vedi anche Configurare gli host virtuali. Nota: paths: non è obbligatorio al momento. Elimina o commenta paths: e le eventuali voci del percorso.
environment-name
(in routingRules)
È l'ambiente a cui verranno instradate le chiamate API. 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.
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.
synchronizer-service-account-name Il nome del file della chiave dell'account di servizio della sincronizzazione che hai generato con 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 Strumento create-service-account. Ad esempio:
udca: ./service-accounts/hybrid-project-apigee-udca.json
mart-host-alias Un nome DNS completo 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
mart-service-account-name Il nome del file della chiave dell'account di servizio mart che hai generato Strumento create-service-account.
mart-cert-name
mart-key-name
Inserisci il nome dei file della chiave e del certificato TLS autorizzati che hai generato in precedenza nel passaggio Crea le credenziali TLS per il gateway MART. Questi file devono trovarsi in 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 per le 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. Successivamente, dovrai applicare questa configurazione al tuo cluster.

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