Etapa 4: configurar o cluster

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.

Verifique se você está no diretório hybrid-base-directory/hybrid-files/overrides/.
```
cd hybrid-base-directory/hybrid-files/overrides
```
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.

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.


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

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 `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, 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.

Variável	Descrição
`analytics-region`	Defina esse valor para a mesma região em que o cluster está em execução. Este é o valor atribuído à variável de ambiente `ANALYTICS_REGION` anteriormente durante a criação do cluster O`apigee-logger` e o`apigee-metrics` envia os dados para esta região.
`gcp-project-id`	Identifica o projeto do Google Cloud em que `apigee-logger` e `apigee-metrics` enviam os dados. Esse é o valor atribuído à variável de ambiente `PROJECT_ID`.
`cluster-name`	O nome do cluster do Kubernetes. Esse é o valor atribuído à variável de ambiente `CLUSTER_NAME`.
`org-name`	É o ID da sua organização da Apigee híbrida. Esse é o valor atribuído à variável de ambiente `ORG_NAME`.
`unique-instance-identifier`	Uma string exclusiva para identificar a instância. Pode ser qualquer combinação de letras e números, com até 63 caracteres. Observação: é possível criar várias organizações no mesmo cluster, mas o `instanceId` precisa ser o mesmo para todas as organizações que estiverem no mesmo cluster do Kubernetes. No caso de instalações multirregionais, cada região requer o próprio cluster. Os clusters individuais não abrangem regiões. É possível criar várias organizações no mesmo cluster, mas o `instanceId` precisa ser o mesmo para todas as organizações que estiverem no mesmo cluster do Kubernetes
`environment-group-name`	Nome do grupo a que os ambientes são atribuídos. Este é o grupo que você criou em Configuração do projeto e da organização - Etapa 6: criar um grupo de ambiente. Esse é o valor atribuído à variável de ambiente `ENV_GROUP`. Observação: se você quiser colocar instâncias de cluster em várias regiões, tenha cuidado ao definir os ambientes e os hosts virtuais. Se você tiver um ou mais ambientes anexados a um grupo, será necessário incluir a mesma configuração para cada arquivo de cluster no arquivo de modificações.
`cert-name` `key-name`	Digite o nome da chave TLS autoassinada e dos arquivos de certificado gerados anteriormente na Etapa 3: instalar o Apigeectl. Esses arquivos precisam 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 usado para criar um ambiente na IU, conforme explicado em Configuração de projeto e organização - Etapa 6: criar um grupo de ambiente.
`synchronizer-service-account-name`	O nome do arquivo da chave da conta de serviço `synchronizer` que você 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 arquivo da chave da conta de serviço `udca` que você 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 arquivo JSON da chave da conta de serviço `mart` que você gerou com a ferramenta `create-service-account`.
`metrics-service-account-name`	O nome do arquivo JSON da conta de serviço de métricas gerado com a ferramenta `create-service-account`. Por exemplo: metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
`mart-service-account-name`	O nome da conta de serviço `mart` (que tem o papel do Agente do Apigee Connect atribuído a ele) criado por você Etapa 3: instalar o apigeectl. O Mart e o agente do Apigee Connect usam a mesma conta de serviço.
`watcher-service-account-name`	O nome do arquivo JSON da conta de serviço `watcher` que você gerou com a ferramenta `create-service-account`. Por exemplo: watcher: serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json

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.

1 2 3 4 (PRÓXIMA) Etapa 4: instalar o ambiente de execução híbrido