Esta página foi traduzida pela API Cloud Translation.

Passo 1: crie um cluster

< Se estiver a fazer uma nova instalação, continue com as configurações descritas abaixo.

Antes de começar:

Estes passos pressupõem que criou variáveis de ambiente nos passos anteriores. Verifique-as com os seguintes comandos:

echo $PROJECT_ID
echo $CLUSTER_LOCATION
echo $ORG_NAME
echo $ENV_NAME

Clique para ver descrições e comandos para definir as variáveis.

Estes passos usam as seguintes variáveis de ambiente:

PROJECT_ID: o ID do seu projeto do Google Cloud. Consulte o início rápido híbrido – Passo 2: crie um projeto do Google Cloud
```
export PROJECT_ID=your_project_ID
```
CLUSTER_LOCATION: a região na qual vai criar o cluster.
```
export CLUSTER_LOCATION=cluster-region
```
Nota: a Apigee recomenda que use um nome de região e não um nome de zona. Uma região é uma localização geográfica específica onde pode alojar os seus recursos. As regiões podem ter várias zonas. Por exemplo, a us-west1 região denota 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. Tenha em atenção 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.
ORG_NAME: o nome da sua organização. Tem de corresponder ao ID do seu projeto do Google Cloud. Consulte o artigo Início rápido híbrido – Passo 4: crie uma organização
```
export ORG_NAME=your_organization_name
```
ENV_NAME: o nome do seu ambiente híbrido. Consulte o início rápido híbrido – Passo 6: crie um grupo de ambientes
```
export ENV_NAME=your_environment_name
```

Este procedimento explica como configurar o cluster no qual vai executar o Apigee hybrid. As instruções variam consoante a plataforma em que está a executar o modo híbrido. Selecione a sua plataforma para ver as instruções.

GKE

Este passo explica como configurar o ambiente de shell e criar um cluster do GKE no seu projeto do Google Cloud.

Criar um cluster

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

Configuração	Node pool com estado	Node pool sem estado
Número de nós	3 (por região)	3 (por região)
CPU	4	4
RAM	15	15
Nome da etiqueta predefinida	apigee-data	apigee-runtime
Armazenamento	dinâmico	Gerido 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 suportada por esta versão híbrida 1.6.9:
- Apigee Hybrid: plataformas suportadas
Use as seguintes instruções para criar um cluster regional com um mínimo de 6 nós:
- Criar um cluster regional.
  A Apigee recomenda a criação de um cluster regional. Se preferir criar um cluster zonal, certifique-se de que usa a zona onde as instruções pedem a sua localização nos passos subsequentes.
  
  Sugestão: se não estiver a criar o cluster na rede predefinida, siga as instruções em Criar um cluster numa sub-rede existente

Crie, pelo menos, dois node pools para o seu cluster. Os requisitos mínimos do conjunto de nós são:

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

Siga as instruções em Adicionar e gerir pools de nós.

Para mais detalhes sobre a configuração do conjunto de nós, consulte: Configure conjuntos de nós dedicados

Depois de criar o cluster, ative o Workload Identity no cluster com o seguinte comando:
```
gcloud container clusters update ${CLUSTER_NAME} \
  --workload-pool=$PROJECT_ID.svc.id.goog \
  --region ${CLUSTER_LOCATION}
```
Para mais informações, consulte o artigo Ativar a Workload Identity num cluster
Nota: se criou um cluster zonal em vez de um cluster regional, use o argumento --zone em vez de --region, como no seguinte comando:
```
gcloud container clusters update ${CLUSTER_NAME} \
  --workload-pool=$PROJECT_ID.svc.id.goog \
  --zone ${CLUSTER_LOCATION}
```

Obtenha as credenciais gcloud do cluster que 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, avance para o passo seguinte.

GKE On-Prem

Criar um cluster

Reúna os requisitos do cluster para o cluster do Apigee Hybrid:

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

Configuração	Node pool com estado	Node pool sem estado
Número de nós	3 (por região)	3 (por região)
CPU	4	4
RAM	15	15
Nome da etiqueta predefinida	apigee-data	apigee-runtime
Armazenamento	dinâmico	Gerido com o CRD ApigeeDeployment

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

Crie, pelo menos, dois node pools:

Nome predefinido do node pool	Descrição
`apigee-data`	Um node pool com estado.
`apigee-runtime`	Um node pool sem estado.

Para mais detalhes sobre a configuração do conjunto de nós, consulte: Configure conjuntos de nós dedicados

Verifique a versão do GKE suportada por esta versão híbrida 1.6.9:
- Apigee Hybrid: plataformas suportadas
Siga as instruções abaixo para criar um cluster de utilizadores:
- Crie um cluster de utilizadores (início rápido) na documentação do GKE On-Prem.

Quando tiver um cluster instalado e em execução, avance para o passo seguinte.

Anthos em bare metal

Requisitos e pré-requisitos

Os clusters do Anthos em bare metal permitem-lhe executar clusters do Kubernetes diretamente nos seus próprios recursos da máquina.

Reveja os seguintes requisitos e pré-requisitos:

Requisitos de hardware: Configurar hardware para clusters de Anthos em bare metal
Vista geral dos pré-requisitos de instalação

Criar um cluster

Reúna os requisitos do cluster para o cluster do Apigee Hybrid:

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

Configuração	Node pool com estado	Node pool sem estado
Número de nós	3 (por região)	3 (por região)
CPU	4	4
RAM	15	15
Nome da etiqueta predefinida	apigee-data	apigee-runtime
Armazenamento	dinâmico	Gerido com o CRD ApigeeDeployment

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

Crie, pelo menos, dois node pools:

Nome predefinido do node pool	Descrição
`apigee-data`	Um node pool com estado.
`apigee-runtime`	Um node pool sem estado.

Para mais detalhes sobre a configuração do conjunto de nós, consulte: Configure conjuntos de nós dedicados

Verifique a versão do GKE suportada por esta versão híbrida 1.6.9:
- Apigee Hybrid: plataformas suportadas
Use as seguintes instruções na documentação dos clusters do Anthos em bare metal para criar um cluster de utilizador:
- Criar clusters: vista geral.
- Início rápido dos clusters de Anthos em bare metal na documentação dos clusters de Anthos em bare metal.

Quando tiver um cluster instalado e em execução, avance para o passo seguinte.

AKS

Crie um cluster do AKS

Reúna os requisitos do cluster para o cluster do Apigee Hybrid:

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

Configuração	Node pool com estado	Node pool sem estado
Número de nós	3 (por região)	3 (por região)
CPU	4	4
RAM	15	15
Nome da etiqueta predefinida	apigee-data	apigee-runtime
Armazenamento	dinâmico	Gerido com o CRD ApigeeDeployment

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

Crie, pelo menos, dois node pools:

Nome predefinido do node pool	Descrição
`apigee-data`	Um node pool com estado.
`apigee-runtime`	Um node pool sem estado.

Para mais detalhes sobre a configuração do conjunto de nós, consulte: Configure conjuntos de nós dedicados

Verifique a versão do AKS suportada por esta versão híbrida 1.6.9:
- Apigee Hybrid: plataformas suportadas
Use um dos seguintes conjuntos de instruções para criar um cluster:
- Usando a CLI do Azure: Início rápido: implemente um cluster do Serviço Azure Kubernetes com a CLI do Azure.
- Usar o portal do Azure: Início rápido: implemente um cluster do Serviço Azure Kubernetes (AKS) através do portal do Azure.

EKS

Criar um cluster

Reúna os requisitos do cluster para o cluster do Apigee Hybrid:

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

Configuração	Node pool com estado	Node pool sem estado
Número de nós	3 (por região)	3 (por região)
CPU	4	4
RAM	15	15
Nome da etiqueta predefinida	apigee-data	apigee-runtime
Armazenamento	dinâmico	Gerido com o CRD ApigeeDeployment

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

Crie, pelo menos, dois node pools:

Nome predefinido do node pool	Descrição
`apigee-data`	Um node pool com estado.
`apigee-runtime`	Um node pool sem estado.

Para mais detalhes sobre a configuração do conjunto de nós, consulte: Configure conjuntos de nós dedicados

Verifique a versão do EKS suportada por esta versão híbrida 1.6.9:
- Apigee Hybrid: plataformas suportadas
Siga as instruções abaixo para criar um cluster de utilizadores:
- Documentação de vista geral do EKS.
- Criar um cluster do Amazon EKS.

Quando tiver um cluster instalado e em execução, avance para o passo seguinte.

GKE no AWS

Criar um cluster

Reúna os requisitos do cluster para o cluster do Apigee Hybrid:

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

Configuração	Node pool com estado	Node pool sem estado
Número de nós	3 (por região)	3 (por região)
CPU	4	4
RAM	15	15
Nome da etiqueta predefinida	apigee-data	apigee-runtime
Armazenamento	dinâmico	Gerido com o CRD ApigeeDeployment

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

Crie, pelo menos, dois node pools:

Nome predefinido do node pool	Descrição
`apigee-data`	Um node pool com estado.
`apigee-runtime`	Um node pool sem estado.

Para mais detalhes sobre a configuração do conjunto de nós, consulte: Configure conjuntos de nós dedicados

Verifique a versão do GKE suportada por esta versão híbrida 1.6.9:
- Apigee Hybrid: plataformas suportadas
Siga as instruções abaixo para criar um cluster de utilizadores:
- Documentação de vista geral do GKE no AWS.
- Clusters do Anthos no AWS vista geral da instalação.

Quando tiver um cluster instalado e em execução, avance para o passo seguinte.

OpenShift

Criar um cluster

Reúna os requisitos do cluster para o cluster do Apigee Hybrid:

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

Configuração	Node pool com estado	Node pool sem estado
Número de nós	3 (por região)	3 (por região)
CPU	4	4
RAM	15	15
Nome da etiqueta predefinida	apigee-data	apigee-runtime
Armazenamento	dinâmico	Gerido com o CRD ApigeeDeployment

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

Crie, pelo menos, dois node pools:

Nome predefinido do node pool	Descrição
`apigee-data`	Um node pool com estado.
`apigee-runtime`	Um node pool sem estado.

Para mais detalhes sobre a configuração do conjunto de nós, consulte: Configure conjuntos de nós dedicados

Verifique a versão do GKE suportada por esta versão híbrida 1.6.9:
- Apigee Hybrid: plataformas suportadas
Use as seguintes instruções para instalar o Apigee no cluster de utilizadores do OpenShift e registá-lo no GKE Hub.
Se não tiver um cluster do OpenShift pronto a usar com o Apigee, consulte as instruções na documentação do OpenShift, por exemplo: Instalar um cluster rapidamente no Google Cloud.
1. Instale e configure a ferramenta de CLI oc. Consulte o artigo Introdução à CLI do OpenShift na documentação do OpenShift.
2. Registe-se no GKE Hub
  1. Crie um ficheiro denominado gke-connect-scc.yaml com o seguinte conteúdo:
```
# Connect Agent SCC
apiVersion: v1
kind: SecurityContextConstraints
metadata:
  name: gke-connect-scc
allowPrivilegeEscalation: false
requiredDropCapabilities:
- ALL
runAsUser:
  type: MustRunAsNonRoot
seLinuxContext:
  type: RunAsAny
supplementalGroups:
  type: MustRunAs
  ranges:
  - min: 1
    max: 65535
fsGroup:
  type: MustRunAs
  ranges:
  - min: 1
    max: 65535
volumes:
- secret
readOnlyRootFilesystem: true
seccompProfiles:
- docker/default
users:
groups:
  - system:serviceaccounts:gke-connect
        
```
  2. Crie o componente em oc com o seguinte comando:
```
oc create -f gke-connect-scc.yaml
```
  3. Crie as variáveis de ambiente para o contexto com os seguintes comandos:
```
export KUBECONFIG=<> # Cluster kubeconfig file path
export CONTEXT=admin
```
  4. Registe-se no GKE Hub com o seguinte comando:
```
gcloud --project=${PROJECT_ID} container hub memberships register ${CLUSTER_NAME} \
  --kubeconfig=${KUBECONFIG} \
  --context=${CONTEXT} \
  --service-account-key-file=KEY_FILE_PATH
```
    Onde:
    - PROJECT_ID é o ID do seu projeto do Google Cloud.
    - CLUSTER_NAME é o nome do cluster que acabou de criar.
    - KUBECONFIG é o caminho para o ficheiro kubeconfig do cluster.
    - CONTEXT é o contexto no qual gcloud está a registar o cluster. CONTEXT tem de ser admin para este comando.
    - KEY_FILE_PATH é o caminho para o ficheiro de chave da conta de serviço, por exemplo, ./dist/apigee-my-project-ro-sa.json. A conta de serviço tem de ter as seguintes duas funções do IAM:
      - Administrador do GKE Hub
      - Agente do GKE Connect

Quando tiver um cluster instalado e registado no GKE Hub, avance para o passo seguinte.

1 (SEGUINTE) Passo 2: instale o cert-manager 3 4 5 6 7 8 9