Etapa 1: criar um cluster

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

Version 1.9 (unsupported)

Versões com suporte:

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

Versões sem suporte:

• 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.9.4 da Apigee, consulte Como fazer upgrade para a Apigee híbrida para instruções sobre o processo. 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.

Clusters dedicados x clusters compartilhados

É possível criar um novo cluster dedicado para a Apigee híbrida, conforme explicado nesta etapa, ou instalá-lo em um cluster que esteja executando outras cargas de trabalho.

• Cluster dedicado: (recomendado) 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.
• Cluster compartilhado: (incomum) 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.

É recomendável usar um cluster dedicado. A configuração de cluster compartilhado é um caso de uso avançado e não será discutido em mais detalhes nas etapas de instalação.

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.9.4. 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 o cluster 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.
   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. Verifique se o cluster está definido como o padrão para kubectl. Consulte Definir um cluster padrão para os comandos do kubectl.

8. 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

      Por 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 seguintes comandos 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
      

9. 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.
10. 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}

11. Ative a identidade da carga de trabalho no cluster. Esta operação pode demorar 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. Consulte as credenciais gcloud do cluster que você acabou de criar com o seguinte comando:

    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}

13. Para instalações no GKE, a Apigee oferece a capacidade de usar a Identidade da carga de trabalho para se conectar aos serviços do Google Cloud sem usar contas de serviço do Google com certificados armazenados localmente. Saiba mais sobre a Identidade da carga de trabalho em Como ativar a Identidade da carga de trabalho com a Apigee híbrida.

    Opcional: ative a Identidade da carga de trabalho para cada pool de nós com os comandos a seguir. Essa operação pode demorar até 30 minutos por pool de nós.

    Clusters regionais

    gcloud container node-pools update apigee-data \
      --cluster=$CLUSTER_NAME \
      --region $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

    gcloud container node-pools update apigee-runtime \
      --cluster=$CLUSTER_NAME \
      --region $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

    Clusters zonais

    gcloud container node-pools update apigee-data \
      --cluster=$CLUSTER_NAME \
      --zone $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

    gcloud container node-pools update apigee-runtime \
      --cluster=$CLUSTER_NAME \
      --zone $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

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.9.4. 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.9.4. 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
     Purpose	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.

     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.9.4. 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
   Purpose	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.

   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.9.4. 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
   Purpose	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.

   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.9.4. 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.
   • Visão geral da instalação de clusters do Anthos 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
   Purpose	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.

   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.9.4. 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 GCP.

   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
   Purpose	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.

   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 (PRÓXIMA) Etapa 2: instalar o cert-manager 3 4 5 6 7 8 9 10