Esta página foi traduzida pela API Cloud Translation.

Passo 4: configure o cluster

Especifique substituições de configuração

O instalador híbrido do Apigee usa predefinições para muitas definições. No entanto, existem algumas definições que não têm predefinições. Tem de fornecer valores para estas definições, conforme explicado em seguida.

Certifique-se de que está no diretório hybrid-base-directory/hybrid-files/overrides/.
```
cd hybrid-base-directory/hybrid-files/overrides
```
Crie um novo ficheiro denominado overrides.yaml no seu editor de texto favorito. For example:
```
vi overrides.yaml
```
O overrides.yaml fornece a configuração para a sua instalação híbrida do Apigee exclusiva. O ficheiro de substituições neste passo fornece uma configuração básica para uma instalação de tempo de execução híbrido de pequena dimensão, adequada para a sua primeira instalação.

Em overrides.yaml, adicione os valores das propriedades obrigatórias, apresentados abaixo. Também é fornecida uma descrição detalhada de cada propriedade abaixo:

Sintaxe

Certifique-se de que o ficheiro overrides.yaml tem a seguinte estrutura e sintaxe. Os valores em red, bold italics são valores de propriedades que tem de fornecer. Estão descritas na tabela abaixo.


gcp:
  region: analytics-region
  projectID: gcp-project-id

k8sCluster:
  name: cluster-name
  region: cluster-region # Must be the same region where the cluster is running.

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
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

Exemplo

O exemplo seguinte mostra um ficheiro de substituições concluído com valores de propriedades 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 `true` for GKE-On Prem 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
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

Quando terminar, guarde o ficheiro.

A tabela seguinte descreve cada um dos valores das propriedades que tem de fornecer no ficheiro de substituições. Para mais informações, consulte a referência da propriedade de configuração.

Variável	Descrição
`analytics-region`	Tem de definir este valor para a mesma região onde o cluster está a ser executado. Este é o valor que atribuiu à variável de ambiente `ANALYTICS_REGION` anteriormente durante a criação do cluster O `apigee-logger` e o `apigee-metrics` enviam os respetivos dados para esta região.
`gcp-project-id`	Identifica o projeto do Google Cloud onde o `apigee-logger` e o `apigee-metrics` enviam os respetivos dados. Este é o valor atribuído à variável de ambiente `PROJECT_ID`.
`cluster-name`	O nome do cluster do Kubernetes. Este é o valor atribuído à variável de ambiente `CLUSTER_NAME`.
`org-name`	O ID da sua organização do Apigee Hybrid. Este é o valor atribuído à variável de ambiente `ORG_NAME`.
`unique-instance-identifier`	Uma string exclusiva para identificar esta instância. Pode ser qualquer combinação de letras e números com um máximo de 63 carateres. Nota: pode criar várias organizações no mesmo cluster, mas o `instanceId` tem de ser o mesmo para todas as organizações no mesmo cluster do Kubernetes. Para instalações em várias regiões, cada região requer o seu próprio cluster (os clusters individuais não abrangem regiões). Pode criar várias organizações no mesmo cluster, mas o `instanceId` tem de ser o mesmo para todas as organizações no mesmo cluster do Kubernetes
`environment-group-name`	O nome do grupo de ambientes ao qual os seus ambientes estão atribuídos. Este é o grupo que criou em Configuração do projeto e da organização – Passo 6: crie um grupo de ambientes. Este é o valor atribuído à variável de ambiente `ENV_GROUP`. Nota: se quiser colocar instâncias de cluster em várias regiões, tem de ter cuidado com a forma como define os seus ambientes e anfitriões virtuais. Se tiver um ou mais ambientes anexados a um grupo de ambientes, tem de incluir essa mesma configuração do grupo de ambientes no ficheiro de substituições de cada instância do cluster.
`cert-name` `key-name`	Introduza o nome dos ficheiros de certificado e chave TLS autoassinados que gerou anteriormente no Passo 3: instale o apigeectl. Estes ficheiros têm de estar localizados no diretório `base_directory/hybrid-files/certs`. Por exemplo: sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`environment-name`	Use o mesmo nome que usou quando criou um ambiente na IU, conforme explicado em Configuração do projeto e da organização – Passo 6: crie um grupo de ambientes.
`synchronizer-service-account-name`	O nome do ficheiro de chave da conta de serviço `synchronizer` que gerou com a ferramenta `create-service-account`. Por exemplo: serviceAccountPath: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	O nome do ficheiro de chave da conta de serviço `udca` que gerou com a ferramenta `create-service-account`. Por exemplo: serviceAccountPath: udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-service-account-name`	O nome do ficheiro JSON da chave da conta de serviço `mart` que gerou com a ferramenta `create-service-account`.
`metrics-service-account-name`	O nome do ficheiro JSON da conta de serviço de métricas que gerou com a ferramenta `create-service-account`. Por exemplo: metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
`mart-service-account-name`	O nome da `mart`conta de serviço (à qual foi atribuída a função Agente do Apigee Connect) que criou no Passo 3: instale o apigeectl. O MART e o agente do Apigee Connect usam a mesma conta de serviço.
`watcher-service-account-name`	O nome do ficheiro JSON da conta de serviço que gerou com a ferramenta `create-service-account`.`watcher` Por exemplo: watcher: serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json

Resumo

O ficheiro de configuração indica ao Kubernetes como implementar os componentes híbridos num cluster. Em seguida, aplica esta configuração ao cluster.

1 2 3 4 (NEXT) Passo 5: instale o tempo de execução híbrido