Passo 1: crie um cluster

Está a ver a versão 1.7 da documentação do Apigee híbrido. This version is end of life. You should upgrade to a newer version. Para mais informações, consulte Versões suportadas.

Version 1.7 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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

Aviso: o Apigee não suporta a sandbox do GKE nem o gVisor para instalações híbridas no GKE.

Criar um cluster

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

2. Verifique a versão do GKE suportada por esta versão híbrida 1.7.6:
   • Apigee Hybrid: plataformas suportadas
3. Use as seguintes instruções para criar um cluster regional com um mínimo de 6 nós:
   • Criar um cluster regional.
     Sugestão: se estiver a usar a Google Cloud Console para criar o cluster, adicione os conjuntos de nós antes de clicar em Criar para criar o cluster.
     Nota: 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
4. 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

   Dica: depois de criar os conjuntos de nós, pode validá-los com o seguinte comando:

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

5. 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}

6. 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}

   Nota: se criou um cluster zonal em vez de um cluster regional, obtenha as credenciais com o seguinte comando:

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --zone ${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

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

2. Verifique a versão do GKE suportada por esta versão híbrida 1.7.6:
   • Apigee Hybrid: plataformas suportadas
3. 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

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

2. Verifique a versão do GKE suportada por esta versão híbrida 1.7.6:
   • Apigee Hybrid: plataformas suportadas
3. 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

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

2. Verifique a versão do AKS suportada por esta versão híbrida 1.7.6:
   • Apigee Hybrid: plataformas suportadas
3. 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

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

2. Verifique a versão do EKS suportada por esta versão híbrida 1.7.6:
   • Apigee Hybrid: plataformas suportadas
3. 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

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

2. Verifique a versão do GKE suportada por esta versão híbrida 1.7.6:
   • Apigee Hybrid: plataformas suportadas
3. 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

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

2. Verifique a versão do OpenShift suportada por esta versão híbrida 1.7.6:
   • Apigee Hybrid: plataformas suportadas
3. Crie o cluster do OpenShift para implementar no plano de tempo de execução e instale o Apigee no seu cluster de utilizadores do OpenShift.
   Pode encontrar informações adicionais sobre a criação e a gestão de clusters do OpenShift na GCP na documentação do OpenShift, por exemplo: Instalar um cluster rapidamente na GCP.
   Para obter ajuda na configuração do cluster do OpenShift em VMs da GCP, consulte o artigo Como configurar o Apigee hybrid no Openshift em VMs da GCP.

   Como parte da instalação do OpenShift, instale e configure a ferramenta oc CLI. Consulte o artigo Introdução à CLI do OpenShift na documentação do OpenShift.

Quando tiver instalado um cluster, avance para o passo seguinte.

 

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