Etapa 1: criar um cluster

Você está visualizando a versão 1.10 da documentação da Apigee híbrida. Para mais informações, consulte Versões compatíveis.

Version 1.10 

Versões com suporte:

• v1.13 (mais recente)                        
• v1.12                         
• v1.11
• Lista de versões com suporte

Versões sem suporte:

• v1.10                                      
• v1.9
• v1.8                                         
• v1.7
• v1.6
• v1.5
• v1.4
• v1.3
• v1.2
• v1.1

Como fazer upgrade: se você estiver fazendo upgrade para a versão 1.10.5 da Apigee híbrida, consulte Como fazer upgrade para a Apigee híbrida para ver instruções. Se você estiver executando uma nova instalação, continue com as configurações descritas abaixo.

Nesta etapa, explicamos como criar o cluster em que você executará a Apigee híbrida. As instruções variam de acordo com a plataforma em que você está executando o híbrido. Antes de começar, leia as seguintes informações:

• Configurações mínimas do cluster
• Como configurar pools de nós dedicados
• Configurar o Cassandra para produção
• Como configurar a autenticação do Cassandra
• Configuração do StorageClass
• Uso de portas seguras

Observação: é possível criar um novo cluster dedicado para a Apigee híbrida ou instalá-lo em um cluster que esteja executando outras cargas de trabalho. A criação de um cluster dedicado para a Apigee híbrida adiciona isolamento e simplifica o esforço geral necessário para manter o cluster e as cargas de trabalho da Apigee híbrida.

Se você instalar o híbrido da Apigee em um cluster que executa outras cargas de trabalho, será necessário fazer upgrade e manter o cluster nas versões e recursos necessários em comum para o híbrido da Apigee e outras cargas de trabalho. Convém desenvolver um plano para migrar uma ou mais cargas de trabalho caso ocorram conflitos entre versões e requisitos compatíveis.

O restante das instruções de instalação presume que você está instalando em um cluster dedicado.

Crie o cluster

Siga as etapas de acordo com a plataforma selecionada.

GKE

Crie um cluster no GKE

Nestas etapas, explicamos como configurar e criar um cluster do GKE no projeto do Google Cloud.

Atenção: a Apigee não é compatível com o GKE Sandbox nem com o gVisor para instalações híbridas no GKE (em inglês).

A Apigee recomenda que você crie um cluster regional em vez de um cluster zonal. Se você não estiver familiarizado com a distinção entre regiões e zonas, consulte Regiões e zonas. As regiões disponíveis estão listadas em Regiões e zonas disponíveis. Observe que, por exemplo, us-west1 é um nome de região válido, enquanto us-west1-a é uma zona na região.

1. Verifique se você está usando uma versão do GKE compatível com a versão híbrida 1.10.5. Consulte Plataformas e versões híbridas compatíveis com a Apigee
2. Verifique se os relógios de todos os nós e servidores de aplicativos estão sincronizados com o Network Time Protocol (NTP), conforme explicado nos Pré-requisitos. O banco de dados do Cassandra depende da sincronização do Network Time Protocol (NTP) para manter a consistência dos dados. Se você planeja instalar um aplicativo híbrido em várias regiões, verifique se elas estão sincronizadas com o NTP em todas as regiões.
3. (Somente clusters particulares do GKE) Se você estiver criando um cluster particular, adicione uma regra de firewall para permitir a comunicação entre os nós mestres do GKE e os nós de trabalho do GKE na porta 9443 e permitir que os mestres do GKE acessem os webhooks de modificação da Apigee. Siga o procedimento em Como adicionar regras de firewall para casos de uso específicos na documentação do Google Kubernetes Engine. Para mais informações, consulte Clusters particulares no GKE.

   Você não precisará adicionar essa regra se estiver criando um cluster padrão ou público.

4. Crie um cluster padrão seguindo as instruções em Criar um cluster regional com um pool de nós de várias zonas. Não há problema em criar o cluster apenas com o pool de nós padrão. Você configurará e criará os pools de nós híbridos da Apigee necessários na próxima etapa.
   Importante: crie um cluster padrão em vez de um cluster do Autopilot. A Apigee híbrida não é compatível com clusters do Autopilot porque não são compatíveis com pools de nós personalizados. Se você estiver usando a interface do Console do Google Cloud, selecione SWITCH TO STANDARD CLUSTER.
   Dica: se você não estiver criando o cluster na rede padrão, siga as instruções em Como criar um cluster em uma sub-rede

   Vá para a próxima etapa somente depois que a criação do cluster for concluída.

5. Crie dois pools de nós seguindo as instruções em Adicionar e gerenciar pools de nós. Configure os pools de nós com os requisitos mínimos listados na tabela abaixo.

   O que você precisa saber sobre pools de nós

   Observação: recomendamos usar os nomes apigee-data e apigee-runtime para os pools de nós. A Apigee híbrida reconhece esses nomes por padrão. Se você não quiser usar os nomes padrão, será necessário configurar mais tarde ao configurar o cluster para a Apigee híbrida. Para mais informações, incluindo instruções para alterar os nomes do pool de nós padrão editando o arquivo de configuração do cluster, consulte Como usar o nodeSelector padrão.

   Recomendamos que você revise as seguintes informações sobre pools de nós e a configuração do pool de nós antes de continuar:

   • Sobre pools de nós
   • Requisitos de rede do Cassandra

   Requisitos mínimos do pool de nós

   Certifique-se de atender a esses requisitos mínimos ao criar os pools de nós. Se você estiver usando o Console do Cloud, configure as seções Detalhes do pool de nós e Nós.

   Observação: os valores de configuração do pool de nós descritos na tabela a seguir representam valores mínimos. Esta configuração mínima é adequada para testes. No entanto, com base nas suas necessidades, é possível aumentar o tamanho dos nós agora ou no futuro. Para mais informações sobre como gerenciar nós de cluster, consulte Adicionar e gerenciar pools de nós.

   Nome do pool de nós	Descrição	Mínimo de nós	Tipo de máquina mínimo
   apigee-data	Um pool de nós com estado usado para o banco de dados do Cassandra.	1 por zona (3 por região)	e2-standard-4 (4 vCPUs, 16 GB de memória)
   apigee-runtime	Um pool de nós sem estado usado pelo processador de mensagens do ambiente de execução.	1 por zona (3 por região)	e2-standard-4 (4 vCPUs, 16 GB de memória)

   Para mais detalhes sobre a configuração do pool de nós, consulte Configurar pools de nós dedicados.

6. (Opcional) Se quiser, exclua o pool de nós default. Consulte Excluir um pool de nós.
7. Crie as variáveis de ambiente a seguir. Essas variáveis são usadas nos comandos gcloud a seguir.

   Linux / MacOS

   export CLUSTER_NAME="YOUR_CLUSTER_NAME"
   export CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"

   Windows

   set CLUSTER_NAME="YOUR_CLUSTER_NAME"
   set CLUSTER_LOCATION=YOUR_CLUSTER_LOCATION
   set PROJECT_ID=YOUR_PROJECT_ID

   Em que:

   • CLUSTER_NAME: o nome do cluster.
   • CLUSTER_LOCATION: a região em que o cluster foi criado.
8. Verifique as configurações do pool de nós:

   Clusters regionais

   gcloud container node-pools list \
   --cluster=${CLUSTER_NAME} \
   --region=${CLUSTER_LOCATION} \
   --project=${PROJECT_ID}

   Clusters zonais

   gcloud container node-pools list \
   --cluster=${CLUSTER_NAME} \
   --zone=${CLUSTER_LOCATION} \
   --project=${PROJECT_ID}

9. Para verificar se o cluster está definido como o padrão para kubectl, acesse o
   Credenciais gcloud do cluster que você acabou de criar:

   Clusters regionais

     gcloud container clusters get-credentials ${CLUSTER_NAME} \
       --region ${CLUSTER_LOCATION} \
       --project ${PROJECT_ID}

   Clusters zonais

     gcloud container clusters get-credentials ${CLUSTER_NAME} \
       --zone ${CLUSTER_LOCATION} \
       --project ${PROJECT_ID}

   Consulte Definir um cluster padrão para os comandos do kubectl.

10. Configurar o armazenamento de disco de estado sólido (SSD) permanente para o Cassandra. Não é possível usar SSDs locais. Para mais informações, consulte Alterar a classe de armazenamento padrão na documentação do Kubernetes.

    1. Consiga o nome da StorageClass padrão atual:

       kubectl get sc

       Exemplo:

       kubectl get sc
         NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
         premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
         standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
         standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

    2. Descreva a StorageClass chamada standard-rwo. Observe que o tipo dela é pd-balanced:

       kubectl describe sc standard-rwo

       Exemplo:

       kubectl describe sc standard-rwo

       Name:                  standard-rwo
         IsDefaultClass:        Yes
         Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
         Provisioner:           pd.csi.storage.gke.io
         Parameters:            type=pd-balanced
         AllowVolumeExpansion:  True
         MountOptions:          <none>
         ReclaimPolicy:         Delete
         VolumeBindingMode:     WaitForFirstConsumer
         Events:                <none>

    3. Crie um novo arquivo chamado storageclass.yaml.
    4. Adicione este código ao arquivo. Observe que o nome da nova classe é apigee-sc. Use o nome que preferir. Além disso, o tipo de armazenamento é pd-ssd:

       ---
       kind: StorageClass
       apiVersion: storage.k8s.io/v1
       metadata:
         name: "apigee-sc"
       provisioner: kubernetes.io/gce-pd
       parameters:
         type: pd-ssd
         replication-type: none
       volumeBindingMode: WaitForFirstConsumer
       allowVolumeExpansion: true

    5. Aplique a nova StorageClass ao cluster do Kubernetes:

       kubectl apply -f storageclass.yaml

    6. Execute os dois comandos a seguir para alterar a StorageClass padrão:

       kubectl patch storageclass standard-rwo \
       -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

       kubectl patch storageclass apigee-sc \
       -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

    7. Execute este comando para verificar se a nova StorageClass padrão é chamada apigee-sc:

       kubectl get sc

       Exemplo:

       kubectl get sc
         NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
         apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
         premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
         standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
         standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

11. Ative a identidade da carga de trabalho para o cluster. A Identidade da carga de trabalho permite que as cargas de trabalho nos clusters do GKE representem contas de serviço de gerenciamento de identidade e acesso (IAM) para acessar serviços do Google Cloud. Esta operação pode levar até 30 minutos:

    Clusters regionais

    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=${PROJECT_ID}.svc.id.goog \
      --project ${PROJECT_ID} \
      --region ${CLUSTER_LOCATION}

    Clusters zonais

    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=${PROJECT_ID}.svc.id.goog \
      --zone ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

    Para mais informações, consulte Ativar a Identidade da carga de trabalho.

12. Verifique se a Identidade da carga de trabalho foi ativada com o seguinte comando:

    Clusters regionais

    gcloud container clusters describe ${CLUSTER_NAME} \
      --project ${PROJECT_ID} \
      --region ${CLUSTER_LOCATION} | grep -i "workload"

    Clusters zonais

    gcloud container clusters describe ${CLUSTER_NAME} \
      --zone ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID} | grep -i "workload"

Quando tiver um cluster instalado e em execução, vá para a próxima etapa.

GKE On-Prem

Criar um cluster no GKE On-Prem

Nestas etapas, explicamos como configurar e criar um cluster do GKE On-Prem para a Apigee híbrida.

1. Verifique se você está usando uma versão do VMWare local do Anthos compatível com a versão híbrida 1.10.5. Consulte Plataformas e versões híbridas compatíveis com a Apigee
2. Verifique se os relógios de todos os nós e servidores de aplicativos estão sincronizados com o Network Time Protocol (NTP), conforme explicado nos Pré-requisitos. O banco de dados do Cassandra depende da sincronização do Network Time Protocol (NTP) para manter a consistência dos dados. Se você planeja instalar um aplicativo híbrido em várias regiões, verifique se ele está sincronizado com o NTP em todas as regiões.
3. Crie o cluster seguindo as instruções em Criar clusters básicos. Não há problema em criar o cluster apenas com o pool de nós padrão. Você configurará e criará os pools de nós híbridos da Apigee necessários na próxima etapa.

   Vá para a próxima etapa somente depois que a criação do cluster for concluída.

4. Crie dois pools de nós seguindo as instruções em Como criar e gerenciar pools de nós. Configure os pools de nós com os requisitos mínimos listados na tabela abaixo.

   O que você precisa saber sobre pools de nós

   Observação: recomendamos usar os nomes apigee-data e apigee-runtime para os pools de nós. A Apigee híbrida reconhece esses nomes por padrão. Se você não quiser usar os nomes padrão, será necessário configurar mais tarde ao configurar o cluster para a Apigee híbrida. Para mais informações, incluindo instruções para alterar os nomes do pool de nós padrão editando o arquivo de configuração do cluster, consulte Como usar o nodeSelector padrão.

   Recomendamos que você revise as seguintes informações sobre pools de nós e a configuração do pool de nós antes de continuar:

   • Sobre pools de nós
   • Requisitos de rede do Cassandra

   Requisitos mínimos do pool de nós

   Certifique-se de atender a esses requisitos mínimos ao criar os pools de nós.

   Observação: os valores de configuração do pool de nós descritos na tabela a seguir representam valores mínimos. Esta configuração mínima é adequada para testes. No entanto, com base nas suas necessidades, é possível aumentar o tamanho dos nós agora ou no futuro. Para mais informações sobre como gerenciar nós de cluster, consulte Adicionar e gerenciar pools de nós.

   Nome do pool de nós	Descrição	Mínimo de nós	Tipo de máquina mínimo
   apigee-data	Um pool de nós com estado usado para o banco de dados do Cassandra.	1 por zona (3 por região)	e2-standard-4 (4 vCPUs, 16 GB de memória)
   apigee-runtime	Um pool de nós sem estado usado pelo processador de mensagens do ambiente de execução.	1 por zona (3 por região)	e2-standard-4 (4 vCPUs, 16 GB de memória)

   Para mais detalhes sobre a configuração do pool de nós, consulte Configurar pools de nós dedicados.

5. (Opcional) Se quiser, exclua o pool de nós default. Consulte Excluir um pool de nós.

6. Configurar o armazenamento de disco de estado sólido (SSD) permanente para o Cassandra. Não é possível usar SSDs locais. Para mais informações, consulte Alterar a classe de armazenamento padrão na documentação do Kubernetes.

   1. Consiga o nome da StorageClass padrão atual:

      kubectl get sc

      Exemplo:

      kubectl get sc
        NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

   2. Descreva a StorageClass chamada standard-rwo. Observe que o tipo dela é pd-balanced:

      kubectl describe sc standard-rwo

      Exemplo:

      kubectl describe sc standard-rwo

      Name:                  standard-rwo
      IsDefaultClass:        Yes
      Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
      Provisioner:           pd.csi.storage.gke.io
      Parameters:            type=pd-balanced
      AllowVolumeExpansion:  True
      MountOptions:          <none>
      ReclaimPolicy:         Delete
      VolumeBindingMode:     WaitForFirstConsumer
      Events:                <none>

   3. Crie um novo arquivo chamado storageclass.yaml.
   4. Adicione este código ao arquivo. Observe que o nome da nova classe é apigee-sc. Use o nome que preferir. Além disso, o tipo de armazenamento é pd-ssd:

      ---
      kind: StorageClass
      apiVersion: storage.k8s.io/v1
      metadata:
        name: "apigee-sc"
      provisioner: kubernetes.io/gce-pd
      parameters:
        type: pd-ssd
        replication-type: none
      volumeBindingMode: WaitForFirstConsumer
      allowVolumeExpansion: true

   5. Aplique a nova StorageClass ao cluster do Kubernetes:

      kubectl apply -f storageclass.yaml

   6. Execute os dois comandos a seguir para alterar a StorageClass padrão:

      kubectl patch storageclass standard-rwo \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

      kubectl patch storageclass apigee-sc \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

   7. Execute este comando para verificar se a nova StorageClass padrão é chamada apigee-sc:

      kubectl get sc

      Exemplo:

      kubectl get sc
        NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
        premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

Quando tiver um cluster instalado e em execução, vá para a próxima etapa.

Anthos em bare metal

Criar um cluster no Anthos em bare metal

Nestas etapas, explicamos como configurar e criar um cluster para a Apigee híbrida no Anthos em bare metal. Com o Anthos em bare metal, você executa os clusters do Kubernetes diretamente nos seus recursos de máquina.

1. Verifique se você está usando uma versão do Anthos em bare metal compatível com a versão híbrida 1.10.5. Consulte Plataformas e versões híbridas compatíveis com a Apigee
2. Verifique se os relógios de todos os nós e servidores de aplicativos estão sincronizados com o Network Time Protocol (NTP), conforme explicado nos Pré-requisitos. O banco de dados do Cassandra depende da sincronização do Network Time Protocol (NTP) para manter a consistência dos dados. Se você planeja instalar um aplicativo híbrido em várias regiões, verifique se elas estão sincronizadas com o NTP em todas as regiões.
3. Consulte a Visão geral dos pré-requisitos de instalação e Como criar clusters: visão geral.
4. Crie o cluster com dois pools de nós configurados conforme descrito abaixo:
   • Siga as instruções de criação do cluster no guia de início rápido de clusters do Anthos em bare metal.
   • Crie no mínimo dois pools de nós. Configure os pools de nós com os requisitos mínimos listados na tabela abaixo.

     O que você precisa saber sobre pools de nós

     Observação: recomendamos usar os nomes apigee-data e apigee-runtime para os pools de nós. A Apigee híbrida reconhece esses nomes por padrão. Se você não quiser usar os nomes padrão, será necessário configurar mais tarde ao configurar o cluster para a Apigee híbrida. Para mais informações, incluindo instruções para alterar os nomes do pool de nós padrão editando o arquivo de configuração do cluster, consulte Como usar o nodeSelector padrão.

     Recomendamos que você revise as seguintes informações sobre pools de nós e a configuração do pool de nós antes de continuar:

     • Configurar pools de nós dedicados
     • Sobre pools de nós
     • Requisitos de rede do Cassandra

     As configurações mínimas do cluster são:

     Observação: os valores de configuração do pool de nós descritos na tabela a seguir representam valores mínimos. Esta configuração mínima é adequada para testes. No entanto, com base nas suas necessidades, é possível aumentar o tamanho dos nós agora ou no futuro.

     Configuração	Pool de nós com estado	Pool de nós sem estado
     Finalidade	Um pool de nós com estado usado para o banco de dados do Cassandra.	Um pool de nós sem estado usado pelo processador de mensagens do ambiente de execução.
     Nome do rótulo	apigee-data	apigee-runtime
     Número de nós	1 por zona (3 por região)	1 por zona (3 por região)
     CPU	4	4
     RAM	15	15
     Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment
     IOPS mínimas do disco	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.
     Largura de banda da rede para cada tipo de instância de máquina	1 Gbps	1 Gbps

     Para mais detalhes sobre a configuração mínima do cluster, consulte: Configurações mínimas do cluster

Quando tiver um cluster instalado e em execução, vá para a próxima etapa.

AKS

Criar um cluster no AKS

Estas etapas explicam como configurar e criar um cluster para a Apigee híbrida no AKS.

1. Verifique se você está usando uma versão do AKS compatível com a versão híbrida 1.10.5. Consulte Plataformas e versões híbridas compatíveis com a Apigee
2. Verifique se os relógios de todos os nós e servidores de aplicativos estão sincronizados com o Network Time Protocol (NTP), conforme explicado nos Pré-requisitos. O banco de dados do Cassandra depende da sincronização do Network Time Protocol (NTP) para manter a consistência dos dados. Se você planeja instalar um aplicativo híbrido em várias regiões, verifique se ele está sincronizado com o NTP em todas as regiões.
3. Crie o cluster usando a CLI do Azure ou o Portal do Azure e crie dois pools de nós, conforme descrito abaixo.

   O que você precisa saber sobre pools de nós

   Observação: recomendamos usar os nomes apigee-data e apigee-runtime para os pools de nós. A Apigee híbrida reconhece esses nomes por padrão. Se você não quiser usar os nomes padrão, será necessário configurar mais tarde ao configurar o cluster para a Apigee híbrida. Para mais informações, incluindo instruções para alterar os nomes do pool de nós padrão editando o arquivo de configuração do cluster, consulte Como usar o nodeSelector padrão.

   Recomendamos que você revise as seguintes informações sobre pools de nós e a configuração do pool de nós antes de continuar:

   • Configurar pools de nós dedicados
   • Sobre pools de nós
   • Requisitos de rede do Cassandra

   As configurações mínimas do cluster são:

   Observação: os valores de configuração do pool de nós descritos na tabela a seguir representam valores mínimos. Esta configuração mínima é adequada para testes. No entanto, com base nas suas necessidades, é possível aumentar o tamanho dos nós agora ou no futuro. Para informações sobre como gerenciar nós do cluster, consulte Adicionar e gerenciar pools de nós do AKS.

   Configuração	Pool de nós com estado	Pool de nós sem estado
   Finalidade	Um pool de nós com estado usado para o banco de dados do Cassandra.	Um pool de nós sem estado usado pelo processador de mensagens do ambiente de execução.
   Nome do rótulo	apigee-data	apigee-runtime
   Número de nós	1 por zona (3 por região)	1 por zona (3 por região)
   CPU	4	4
   RAM	15	15
   Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment
   IOPS mínimas do disco	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.
   Largura de banda da rede para cada tipo de instância de máquina	1 Gbps	1 Gbps

   Para mais detalhes sobre a configuração mínima do cluster, consulte: Configurações mínimas do cluster

Quando tiver um cluster instalado e em execução, vá para a próxima etapa.

EKS

Criar um cluster no EKS

Estas etapas explicam como configurar e criar um cluster para a Apigee híbrida no EKS.

1. Verifique se você está usando uma versão do EKS compatível com a versão híbrida 1.10.5. Consulte Plataformas e versões híbridas compatíveis com a Apigee
2. Verifique se os relógios de todos os nós e servidores de aplicativos estão sincronizados com o Network Time Protocol (NTP), conforme explicado nos Pré-requisitos. O banco de dados do Cassandra depende da sincronização do Network Time Protocol (NTP) para manter a consistência dos dados. Se você planeja instalar um aplicativo híbrido em várias regiões, verifique se elas estão sincronizadas com o NTP em todas as regiões.
3. Se você estiver usando o Kubernetes versão 1.24 ou mais recente, verifique se instalou o driver CSI do Kubernetes para Amazon EBS.
4. Use as instruções a seguir para criar um cluster de usuário e dois pools de nós, conforme descrito abaixo.
   • Documentação da visão geral do EKS.
   • Como criar um cluster do Amazon EKS.

   O que você precisa saber sobre pools de nós

   Observação: recomendamos usar os nomes apigee-data e apigee-runtime para os pools de nós. A Apigee híbrida reconhece esses nomes por padrão. Se você não quiser usar os nomes padrão, será necessário configurar mais tarde ao configurar o cluster para a Apigee híbrida. Para mais informações, incluindo instruções para alterar os nomes do pool de nós padrão editando o arquivo de configuração do cluster, consulte Como usar o nodeSelector padrão.

   Recomendamos que você revise as seguintes informações sobre pools de nós e a configuração do pool de nós antes de continuar:

   • Configurar pools de nós dedicados
   • Sobre pools de nós
   • Requisitos de rede do Cassandra

   As configurações mínimas do cluster são:

   Observação: os valores de configuração do pool de nós descritos na tabela a seguir representam valores mínimos. Esta configuração mínima é adequada para testes. No entanto, com base nas suas necessidades, é possível aumentar o tamanho dos nós agora ou no futuro. Para mais informações sobre como gerenciar nós de cluster, consulte Adicionar e gerenciar pools de nós.

   Configuração	Pool de nós com estado	Pool de nós sem estado
   Finalidade	Um pool de nós com estado usado para o banco de dados do Cassandra.	Um pool de nós sem estado usado pelo processador de mensagens do ambiente de execução.
   Nome do rótulo	apigee-data	apigee-runtime
   Número de nós	1 por zona (3 por região)	1 por zona (3 por região)
   CPU	4	4
   RAM	15	15
   Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment
   IOPS mínimas do disco	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.
   Largura de banda da rede para cada tipo de instância de máquina	1 Gbps	1 Gbps

   Para mais detalhes sobre a configuração mínima do cluster, consulte: Configurações mínimas do cluster

Quando tiver um cluster instalado e em execução, vá para a próxima etapa.

GKE na AWS

Criar um cluster no GKE na AWS

Estas etapas explicam como configurar e criar um cluster para a Apigee híbrida no GKE na AWS.

1. Verifique se você está usando uma versão do GKE compatível com a versão híbrida 1.10.5. Consulte Plataformas e versões híbridas compatíveis com a Apigee
2. Verifique se os relógios de todos os nós e servidores de aplicativos estão sincronizados com o Network Time Protocol (NTP), conforme explicado nos Pré-requisitos. O banco de dados do Cassandra depende da sincronização do Network Time Protocol (NTP) para manter a consistência dos dados. Se você planeja instalar um aplicativo híbrido em várias regiões, verifique se elas estão sincronizadas com o NTP em todas as regiões.
3. Use as instruções a seguir para criar um cluster de usuário e dois pools de nós, conforme descrito abaixo.
   • Documentação da visão geral do GKE na AWS.
   • Implantar um aplicativo no GKE na AWS.

   O que você precisa saber sobre pools de nós

   Observação: recomendamos usar os nomes apigee-data e apigee-runtime para os pools de nós. A Apigee híbrida reconhece esses nomes por padrão. Se você não quiser usar os nomes padrão, será necessário configurar mais tarde ao configurar o cluster para a Apigee híbrida. Para mais informações, incluindo instruções para alterar os nomes do pool de nós padrão editando o arquivo de configuração do cluster, consulte Como usar o nodeSelector padrão.

   Recomendamos que você revise as seguintes informações sobre pools de nós e a configuração do pool de nós antes de continuar:

   • Configurar pools de nós dedicados
   • Sobre pools de nós
   • Requisitos de rede do Cassandra

   As configurações mínimas do cluster são:

   Observação: os valores de configuração do pool de nós descritos na tabela a seguir representam valores mínimos. Esta configuração mínima é adequada para testes. No entanto, com base nas suas necessidades, é possível aumentar o tamanho dos nós agora ou no futuro. Para mais informações sobre como gerenciar nós de cluster, consulte Adicionar e gerenciar pools de nós.

   Configuração	Pool de nós com estado	Pool de nós sem estado
   Finalidade	Um pool de nós com estado usado para o banco de dados do Cassandra.	Um pool de nós sem estado usado pelo processador de mensagens do ambiente de execução.
   Nome do rótulo	apigee-data	apigee-runtime
   Número de nós	1 por zona (3 por região)	1 por zona (3 por região)
   CPU	4	4
   RAM	15	15
   Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment
   IOPS mínimas do disco	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.
   Largura de banda da rede para cada tipo de instância de máquina	1 Gbps	1 Gbps

   Para mais detalhes sobre a configuração mínima do cluster, consulte: Configurações mínimas do cluster

Quando tiver um cluster instalado e em execução, vá para a próxima etapa.

OpenShift

Criar um cluster no OpenShift

Estas etapas explicam como configurar e criar um cluster para a Apigee híbrida no OpenShift.

1. Verifique se você está usando uma versão do OpenShift compatível com a versão híbrida 1.10.5. Consulte Plataformas e versões híbridas compatíveis com a Apigee
2. Verifique se os relógios de todos os nós e servidores de aplicativos estão sincronizados com o Network Time Protocol (NTP), conforme explicado nos Pré-requisitos. O banco de dados do Cassandra depende da sincronização do Network Time Protocol (NTP) para manter a consistência dos dados. Se você planeja instalar um aplicativo híbrido em várias regiões, verifique se elas estão sincronizadas com o NTP em todas as regiões.
3. Crie o cluster do OpenShift para implantar no plano do ambiente de execução, instale a Apigee no cluster de usuário do OpenShift e crie dois pools de nós.
   Encontre mais informações sobre como criar e gerenciar clusters do OpenShift no Google Cloud na documentação do OpenShift, por exemplo: Como instalar um cluster rapidamente no Google Cloud.
   Para ajuda na configuração do cluster do OpenShift nas VMs do Google Cloud, consulte Como configurar a Apigee híbrida no OpenShift em VMs do Google Cloud.

   Como parte da instalação do OpenShift, instale e configure a ferramenta da CLI oc. Consulte Primeiros passos com a CLI do OpenShift na documentação do OpenShift.

   O que você precisa saber sobre pools de nós

   Observação: recomendamos usar os nomes apigee-data e apigee-runtime para os pools de nós. A Apigee híbrida reconhece esses nomes por padrão. Se você não quiser usar os nomes padrão, será necessário configurar mais tarde ao configurar o cluster para a Apigee híbrida. Para mais informações, incluindo instruções para alterar os nomes do pool de nós padrão editando o arquivo de configuração do cluster, consulte Como usar o nodeSelector padrão.

   Recomendamos que você revise as seguintes informações sobre pools de nós e a configuração do pool de nós antes de continuar:

   • Configurar pools de nós dedicados
   • Sobre pools de nós
   • Requisitos de rede do Cassandra

   As configurações mínimas do cluster são:

   Observação: os valores de configuração do pool de nós descritos na tabela a seguir representam valores mínimos. Esta configuração mínima é adequada para testes. No entanto, com base nas suas necessidades, é possível aumentar o tamanho dos nós agora ou no futuro. Para mais informações sobre como gerenciar nós de cluster, consulte Adicionar e gerenciar pools de nós.

   Configuração	Pool de nós com estado	Pool de nós sem estado
   Finalidade	Um pool de nós com estado usado para o banco de dados do Cassandra.	Um pool de nós sem estado usado pelo processador de mensagens do ambiente de execução.
   Nome do rótulo	apigee-data	apigee-runtime
   Número de nós	1 por zona (3 por região)	1 por zona (3 por região)
   CPU	4	4
   RAM	15	15
   Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment
   IOPS mínimas do disco	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.	2.000 IOPS com SAN ou armazenamento anexado diretamente. O NFS não é recomendado, mesmo que seja compatível com as IOPS necessárias.
   Largura de banda da rede para cada tipo de instância de máquina	1 Gbps	1 Gbps

   Para mais detalhes sobre a configuração mínima do cluster, consulte: Configurações mínimas do cluster

Depois de instalar um cluster, acesse a próxima etapa.

 

1 (NEXT) Step 2: Install cert-manager 3 4 5 6 7 8 9 10 11