Etapa 6: configurar o ambiente de execução híbrido

Especificar modificações de configuração

O instalador híbrido da Apigee usa padrões para muitas configurações. No entanto, existem algumas configurações sem padrões. É preciso fornecer valores para essas configurações, conforme explicado a seguir.

1. Verifique se você está no diretório hybrid-base-directory/hybrid-files/overrides/.

   cd hybrid-base-directory/hybrid-files/overrides

2. Crie um novo arquivo chamado overrides.yaml em seu editor de texto favorito. Por exemplo:

   vi overrides.yaml

   O overrides.yaml fornece a configuração para sua instalação híbrida exclusiva da Apigee. O arquivo de modificações nesta etapa fornece uma configuração básica para uma instalação de tempo de execução híbrido de pouco espaço, adequada para sua primeira instalação.

3. Em overrides.yaml, adicione os valores de propriedade obrigatórios, mostrados abaixo. Veja abaixo uma descrição detalhada de cada propriedade:

   Sintaxe

   Verifique se o arquivo overrides.yaml tem a seguinte estrutura e sintaxe: Os valores em red, bold italics são valores de propriedade que você precisa fornecer. Eles estão descritos na tabela abaixo.

   Há diferenças entre as diferentes plataformas dependendo da região do projeto do Google Cloud e a região do cluster do Kubernetes. Escolha a plataforma em que você está instalando o Apigee híbrido.

   gcp:
     region: analytics-region
     projectID: gcp-project-id
   
   k8sCluster:
     name: cluster-name
     region: analytics-region # Must be the closest Google Cloud region to your cluster
   org: org-name
   
   instanceID: "unique-instance-identifier"
   
   cassandra:
     hostNetwork: false #Set this to `true` for GKE On-prem installations.
   
   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 # set to "false" for GKE.
     serviceAccountPath: ./service-accounts/logger-service-account-name.json
   

   Exemplo

   No exemplo a seguir, mostramos um arquivo de modificações concluído com valores de propriedade de exemplo adicionados:

   gcp:
     region: us-central1
     projectID: hybrid-example
   
   k8sCluster:
     name: apigee-hybrid
     region: us-central1
   
   org: hybrid-example
   
   instanceID: "my_hybrid_example"
   
   cassandra:
     hostNetwork: false # Set this to:
                        #   false for GKE installations.
                        #   true for GKE On-prem GKE on AWS, Anthos on bare metal,
                        #            AKS, EKS, and OpenShift installations.
   
   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 # set to "false" for GKE.
     serviceAccountPath: ./service-accounts/logger-service-account-name.json
   
   

4. Quando terminar, salve o arquivo.

A tabela a seguir descreve cada um dos valores de propriedade que você precisa fornecer no arquivo de modificações. Para mais informações, consulte Referência da propriedade de configuração.

sslCertPath: ./certs/keystore.pem
sslKeyPath: ./certs/keystore.key

ls ../service-accounts/

Resumo

O arquivo de configuração informa ao Kubernetes como implantar os componentes híbridos em um cluster. Em seguida, você aplicará essa configuração ao cluster.