Etapa 1: criar um cluster

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

Como criar um cluster

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.

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

Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
- Apigee híbrida: plataformas compatíveis
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

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.

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}
```

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}

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

GKE On-Prem

Como criar um cluster

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.

Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
- Apigee híbrida: plataformas compatíveis
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

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.

Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
- Apigee híbrida: plataformas compatíveis
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

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.

Verifique a versão do AKS compatível com essa versão híbrida 1.8.8:
- Apigee híbrida: plataformas compatíveis
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

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.

Verifique a versão do EKS compatível com essa versão híbrida 1.8.8:
- Apigee híbrida: plataformas compatíveis
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

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.

Verifique a versão do GKE compatível com essa versão híbrida 1.8.8:
- Apigee híbrida: plataformas compatíveis
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

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.

Verifique a versão do OpenShift compatível com essa versão híbrida 1.8.8:
- Apigee híbrida: plataformas compatíveis
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 (PRÓXIMA) Etapa 2: instalar o cert-manager 3 4 5 6 7 8 9 10

Etapa 1: criar um cluster

GKE

Como criar um cluster

Linux / MacOS

Windows

GKE On-Prem

Como criar um cluster

Anthos em bare metal

Requisitos e pré-requisitos

Como criar um cluster

AKS

Criar um cluster do AKS

EKS

Como criar um cluster

GKE na AWS

Como criar um cluster

OpenShift

Como criar um cluster