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 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 do Apigee Hybrid:
- Configurações mínimas do cluster
- Configure node pools dedicados
Verifique a versão do GKE suportada por esta versão híbrida 1.5.10:
- Apigee Hybrid: plataformas suportadas
Siga as instruções abaixo para criar um cluster de utilizadores:
- 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.

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:
- Configurações mínimas do cluster
- Configure node pools dedicados
Verifique a versão do GKE suportada por esta versão híbrida 1.5.10:
- Apigee Hybrid: plataformas suportadas
Siga as instruções abaixo para criar um cluster de utilizadores:
- Vista geral da instalação do GKE On-Prem 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:
- Configurações mínimas do cluster
- Configure node pools dedicados
Verifique a versão do GKE suportada por esta versão híbrida 1.5.10:
- Apigee Hybrid: plataformas suportadas
Siga as instruções abaixo para criar um cluster de utilizadores:
- Criar clusters de utilizadores numa configuração de vários clusters na documentação dos clusters de Anthos no 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:
- Configurações mínimas do cluster
- Configure node pools dedicados
Verifique a versão do AKS suportada por esta versão híbrida 1.5.10:
- 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:
- Configurações mínimas do cluster
- Configure node pools dedicados
Verifique a versão do EKS suportada por esta versão híbrida 1.5.10:
- 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:
- Configurações mínimas do cluster
- Configure node pools dedicados
Verifique a versão do GKE suportada por esta versão híbrida 1.5.10:
- Apigee Hybrid: plataformas suportadas
Siga as instruções abaixo para criar um cluster de utilizadores:
- Documentação de vista geral do GKE na AWS.
- Instalar o GKE na AWS.

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:
- Configurações mínimas do cluster
- Configure node pools dedicados
Verifique a versão do GKE suportada por esta versão híbrida 1.5.10:
- 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