Etapa 1: criar um cluster

Antes de começar:

Nestas etapas, presume-se que você tenha criado variáveis de ambiente nas etapas anteriores. Verifique com os seguintes comandos:

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

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

  1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
  2. Verifique a versão do GKE compatível com essa versão híbrida 1.5.10:
  3. Use as instruções a seguir para criar um cluster de usuário:
    • Como criar um cluster regional.

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:
  2. Verifique a versão do GKE compatível com essa versão híbrida 1.5.10:
  3. Use as instruções a seguir para criar um cluster de usuário:

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.

Revise os seguintes requisitos e pré-requisitos:

Como criar um cluster

  1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
  2. Verifique a versão do GKE compatível com essa versão híbrida 1.5.10:
  3. Use as instruções a seguir para criar um cluster de usuário:

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:
  2. Verifique a versão do AKS compatível com essa versão híbrida 1.5.10:
  3. Use um dos seguintes conjuntos de instruções para criar um cluster:

EKS

Como criar um cluster

  1. Reúna os requisitos de cluster para o cluster híbrido da Apigee:
  2. Verifique a versão do EKS compatível com essa versão híbrida 1.5.10:
  3. Use as instruções a seguir para criar um cluster de usuário:

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:
  2. Verifique a versão do GKE compatível com essa versão híbrida 1.5.10:
  3. Use as instruções a seguir para criar um cluster de usuário:

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:
  2. Verifique a versão do GKE compatível com essa versão híbrida 1.5.10:
  3. Use as instruções a seguir para instalar a Apigee no cluster de usuário do OpenShift e registrá-lo com o GKE Hub.
    1. Instale e configure a ferramenta CLI oc. Consulte Primeiros passos com a CLI do OpenShift na documentação do OpenShift.
    2. Cadastre-se no GKE Hub
      1. Crie um arquivo chamado gke-connect-scc.yaml com os seguintes conteúdos:
        # 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. Registre-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

        Em que:

        • PROJECT_ID é o ID do projeto no Google Cloud.
        • CLUSTER_NAME é o nome do cluster que você acabou de criar.
        • KUBECONFIG é o caminho para o arquivo kubeconfig do cluster.
        • CONTEXT é o contexto em que gcloud está registrando o cluster. CONTEXT precisa ser admin para esse comando.
        • KEY_FILE_PATH é o caminho para o arquivo de chave da sua conta de serviço, por exemplo ./dist/apigee-my-project-ro-sa.json. A conta de serviço precisa ter os dois papéis do IAM a seguir:
          • Administrador do GKE Hub
          • Agente do GKE Connect

Quando você tiver um cluster instalado e registrado no GKE Hub, vá para a próxima etapa.

 

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