Etapa 1: criar um cluster

No momento, você está vendo a versão 1.8 da documentação da Apigee Híbrida. Esta versão é o fim da vida útil. Faça upgrade para uma versão mais recente. Para mais informações, consulte Versões compatíveis.

Version 1.8 (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 Apigee híbrida versão 1.8.8, consulte Como fazer upgrade para a Apigee híbrida para mais instruções. Se você estiver executando uma nova instalação, continue com as configurações descritas abaixo.

Neste procedimento, explicamos como configurar 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. Selecione uma plataforma para ver as instruções:

GKE

Nesta etapa, explicamos como configurar o ambiente de shell e criar um cluster do GKE no projeto do Google Cloud Platform (GCP).

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

Como criar um cluster

1. Crie as variáveis de ambiente 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

   Em que:

   • CLUSTER_NAME (Necessário): é o nome do novo cluster.
   • CLUSTER_LOCATION: a região em que você criará o cluster.
     Observação: a Apigee recomenda usar um nome de região e não um nome de zona. As regiões são localizações geográficas específicas onde você pode hospedar recursos. As regiões podem ter várias zonas. Por exemplo, a região us-west1 indica uma região na costa oeste dos Estados Unidos que tem três zonas: us-west1-a, us-west1-b e and us-west1-c. 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. Para a maioria das instalações híbridas, use um nome de região para a variável CLUSTER_LOCATION.
2. Colete os requisitos do cluster para o cluster híbrido da Apigee: as configurações mínimas do cluster são:

   Configuração	Pool de nós com estado	Pool de nós sem estado
   Número de nós	3 (por região)	3 (por região)
   CPU	4	4
   RAM	15	15
   Nome do rótulo padrão	apigee-data	apigee-runtime
   Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment

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

3. Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
   • Apigee híbrida: plataformas compatíveis
4. Use as seguintes instruções para criar um cluster regional com no mínimo seis nós:
   • Como criar um cluster regional.
     Dica: se você estiver usando o Console do Google Cloud para criar o cluster, adicione os pools de nós antes de clicar em Criar para criá-lo.
     Observação: a Apigee recomenda a criação de um cluster regional. Se você preferir criar um cluster zonal, use a zona em que as instruções solicitam seu local nas etapas subsequentes.
     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 existente
5. Crie no mínimo dois pools de nós para o cluster. Os requisitos mínimos de pools de nós são:

   Nome padrão do pool de nós	Descrição	Mínimo de nós	Mínimo de CPUs por pool de nós	Mínimo de CPUs por nó
   apigee-data	Um pool de nós com estado.	3	4	4/número de nós no pool
   apigee-runtime	Um pool de nós sem estado.	3	4	4/número de nós no pool

   Siga as instruções em Como adicionar e gerenciar pools de nós.

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

   Dica: depois de criar os pools de nós, é possível verificá-los com o seguinte comando:

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

6. Depois que o cluster for criado, ative a identidade da carga de trabalho no cluster. Esta operação pode levar até 30 minutos.

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

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

   Observação: se você criou um cluster zonal em vez de um cluster regional, use o argumento --zone em vez de --region, como no comando a seguir:

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

7. Consiga as credenciais gcloud do cluster que você acabou de criar com o seguinte comando:

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

   Observação: se você criou um cluster zonal em vez de um cluster regional, consiga as credenciais com este comando:

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

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

GKE On-Prem

Como criar um cluster

1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
   • As configurações mínimas do cluster são:

     Configuração	Pool de nós com estado	Pool de nós sem estado
     Número de nós	3 (por região)	3 (por região)
     CPU	4	4
     RAM	15	15
     Nome do rótulo padrão	apigee-data	apigee-runtime
     Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment

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

   • Crie no mínimo dois pools de nós:

     Nome padrão do pool de nós	Descrição
     apigee-data	Um pool de nós com estado.
     apigee-runtime	Um pool de nós sem estado.

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

2. Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
   • Apigee híbrida: plataformas compatíveis
3. Use as instruções a seguir para criar um cluster de usuário:
   • Crie um cluster de usuário (guia de início rápido) na documentação do GKE On-Prem.

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

Anthos em bare metal

Requisitos e pré-requisitos

Com os clusters do Anthos em bare metal, você executa os clusters do Kubernetes diretamente nos seus recursos de máquina.

Consulte a visão geral dos pré-requisitos de instalação.

Como criar um cluster

1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
   • As configurações mínimas do cluster são:

     Configuração	Pool de nós com estado	Pool de nós sem estado
     Número de nós	3 (por região)	3 (por região)
     CPU	4	4
     RAM	15	15
     Nome do rótulo padrão	apigee-data	apigee-runtime
     Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment

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

   • Crie no mínimo dois pools de nós:

     Nome padrão do pool de nós	Descrição
     apigee-data	Um pool de nós com estado.
     apigee-runtime	Um pool de nós sem estado.

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

2. Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
   • Apigee híbrida: plataformas compatíveis
3. Use as instruções a seguir nos clusters do Anthos na documentação bare metal para criar um cluster de usuário:
   • Como criar clusters: visão geral.
   • Guia de início rápido de clusters Bare Metal em Bare Metal na documentação de clusters bare metal do Anthos.

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

AKS

Criar um cluster do AKS

1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
   • As configurações mínimas do cluster são:

     Configuração	Pool de nós com estado	Pool de nós sem estado
     Número de nós	3 (por região)	3 (por região)
     CPU	4	4
     RAM	15	15
     Nome do rótulo padrão	apigee-data	apigee-runtime
     Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment

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

   • Crie no mínimo dois pools de nós:

     Nome padrão do pool de nós	Descrição
     apigee-data	Um pool de nós com estado.
     apigee-runtime	Um pool de nós sem estado.

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

2. Verifique a versão do AKS compatível com essa versão híbrida 1.8.8:
   • Apigee híbrida: plataformas compatíveis
3. Use um dos seguintes conjuntos de instruções para criar um cluster:
   • Como executar a CLI do Azure: Guia de início rápido: implantar um cluster do Azure Kubernetes Service usando a CLI do Azure.
   • Como criar um portal do Azure: Guia de início rápido: implantar um cluster do Azure Kubernetes Service (AKS) usando o portal do Azure.

EKS

Como criar um cluster

1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
   • As configurações mínimas do cluster são:

     Configuração	Pool de nós com estado	Pool de nós sem estado
     Número de nós	3 (por região)	3 (por região)
     CPU	4	4
     RAM	15	15
     Nome do rótulo padrão	apigee-data	apigee-runtime
     Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment

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

   • Crie no mínimo dois pools de nós:

     Nome padrão do pool de nós	Descrição
     apigee-data	Um pool de nós com estado.
     apigee-runtime	Um pool de nós sem estado.

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

2. Verifique a versão do EKS compatível com essa versão híbrida 1.8.8:
   • Apigee híbrida: plataformas compatíveis
3. Use as instruções a seguir para criar um cluster de usuário:
   • Documentação da visão geral do EKS.
   • Como criar um cluster do Amazon EKS.

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

GKE na AWS

Como criar um cluster

1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
   • As configurações mínimas do cluster são:

     Configuração	Pool de nós com estado	Pool de nós sem estado
     Número de nós	3 (por região)	3 (por região)
     CPU	4	4
     RAM	15	15
     Nome do rótulo padrão	apigee-data	apigee-runtime
     Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment

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

   • Crie no mínimo dois pools de nós:

     Nome padrão do pool de nós	Descrição
     apigee-data	Um pool de nós com estado.
     apigee-runtime	Um pool de nós sem estado.

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

2. Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
   • Apigee híbrida: plataformas compatíveis
3. Use as instruções a seguir para criar um cluster de usuário:
   • Documentação da visão geral do GKE na AWS.
   • Visão geral da instalação de clusters do Anthos na AWS.

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

OpenShift

Como criar um cluster

1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
   • As configurações mínimas do cluster são:

     Configuração	Pool de nós com estado	Pool de nós sem estado
     Número de nós	3 (por região)	3 (por região)
     CPU	4	4
     RAM	15	15
     Nome do rótulo padrão	apigee-data	apigee-runtime
     Armazenamento	dynamic	Gerenciada com o CRD ApigeeDeployment

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

   • Crie no mínimo dois pools de nós:

     Nome padrão do pool de nós	Descrição
     apigee-data	Um pool de nós com estado.
     apigee-runtime	Um pool de nós sem estado.

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

2. Verifique a versão do OpenShift compatível com essa versão híbrida 1.8.8:
   • Apigee híbrida: plataformas compatíveis
3. Crie o cluster do OpenShift para implantar no plano do ambiente de execução e instale a Apigee no cluster de usuário do OpenShift.
   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.

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

 

1 (A SEGUIR) Etapa 2: instalar o cert-manager 3 4 5 6 7 8 9 10