Passo 1: crie um cluster

Este passo explica como configurar o ambiente de shell e criar um cluster do Microsoft® Azure Kubernetes Service (AKS) adequado para testar o Apigee hybrid.

Configure a shell do terminal

Certifique-se de que tem a CLI do Azure (az) e a ferramenta kubectl instaladas no seu shell local. A ferramenta Azure CLI fornece a interface de linhas de comando principal para o Azure e o kubectl fornece a interface de linhas de comando principal para executar comandos em clusters do Kubernetes.

Crie um grupo de recursos

Crie um grupo de recursos através da consola do Azure ou com a CLI do Azure através do seguinte comando: 

az group create --name my-hybrid-rg --location eastus

Crie uma rede virtual

Crie uma rede virtual com um intervalo CIDR sem conflitos.

Por exemplo:

Sintaxe

az network vnet create \
 --name vnet-name \
 --resource-group my-hybrid-rg \
 --address-prefixes vnet-address-range \
 --subnet-name vnet-subnet-name \
 --subnet-prefix subnet-address-range

Exemplo

az network vnet create \
 --name my-hybrid-rg-vnet \
 --resource-group my-hybrid-rg \
 --address-prefixes 120.38.1.0/14 \
 --subnet-name my-hybrid-rg-vnet-subnet \
 --subnet-prefix 120.38.1.0/16

Onde:

  1. my-hybrid-rg é o nome da rede virtual.
  2. vnet-address-range é uma lista de blocos de endereços reservados para esta rede virtual na notação CIDR.
  3. vnet-subnet-name é o nome da sub-rede na rede virtual.
  4. subnet-address-range é uma lista de blocos de endereços reservados para esta sub-rede na notação CIDR.

Crie um cluster do AKS

Neste passo, vai criar um cluster do AKS.

  1. Abra o Microsoft® Azure Portal.
  2. Clique em Serviços do Kubernetes.
  3. Crie um cluster com as seguintes definições de configuração mínimas.

    Armazenamento mínimo recomendado: reveja as especificações do disco do AKS e escolha um tamanho do volume de armazenamento com base nos seus requisitos de IOPs e custos.

    Pode ver as diretrizes de configuração do cluster para o Apigee hybrid em Configure o Cassandra para produção e Configuração da StorageClass.

    Tab Atributo Valor
    Noções básicas Subscrição O nome da sua subscrição
    Grupo de recursos O grupo de recursos que criou anteriormente
    Região A região que especificou anteriormente. Por exemplo: (US) East US
    Nome do cluster do Kubernetes O nome do cluster. Por exemplo: my-hybrid-aks-cluster
    Versão do Kubernetes Escolha a versão 1.16.x ou uma versão posterior
    Prefixo do nome de DNS O prefixo do nome DNS. Por exemplo: my-hybrid-aks-cluster-dns
    Número de nós 3
    Tamanho do nó DS3 Standard
    Escala Nós virtuais Desativado
    Conjuntos de dimensionamento de VMs Ativado
    Autenticação Ative o RBAC Sim
    Principal do serviço Predefinição
    Redes Encaminhamento de aplicações HTTP Não
    Balanceador de carga Standard
    Configuração da rede CNI do Azure
    Rede virtual O nome da rede virtual. Pode selecionar a rede virtual que criou anteriormente ou criar uma nova clicando no link Criar nova. Por exemplo: my-hybrid-rg-vnet
    Sub-rede do cluster Exemplo: default (10.240.0.0/16)
    Intervalo de moradas de serviço do Kubernetes O intervalo de moradas de serviço. Certifique-se de que usa um intervalo de endereços não concorrencial. Por exemplo: 10.0.0.0/16
    Endereço IP do serviço DNS do Kubernetes Por exemplo: 10.0.0.10
    Endereço da ponte Docker Por exemplo: 172.17.0.1/16
    Monitorização Ative a monitorização de contentores Sim
    Espaço de trabalho do Log Analytics Por exemplo: DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS
    Etiquetas Nenhum
  4. Clique em Rever e criar.
  5. Quando a criação do cluster estiver concluída, avance para o passo seguinte.

Defina as credenciais do cluster

Adicione as credenciais do cluster Kubernetes para o cluster recém-criado através do seguinte comando se ainda não tiverem sido adicionadas: 

az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster

Definir o contexto atual

Um contexto é um grupo de parâmetros de acesso. Cada contexto contém um cluster do Kubernetes, um utilizador e um espaço de nomes. O contexto atual é o cluster que é atualmente o predefinido para kubectl: todos os comandos kubectl são executados em relação a esse cluster.

Certifique-se de que o contexto atual está definido para o cluster que acabou de criar através do seguinte comando:

kubectl config current-context
 my-hybrid-aks-cluster-context

Se o contexto não estiver definido para o seu cluster conforme esperado, siga estes passos para o alterar:

  1. Liste todos os contextos para determinar qual é o contexto atual. No exemplo seguinte, o contexto está definido como my-hybrid-aks-ext01: 
    kubectl config get-contexts
CURRENT   NAME                            CLUSTER                                 AUTHINFO
          my-hybrid-aks-cluster    my-hybrid-aks-cluster          clusterUser_my-hybrid-rg2_myhybrid-aks-cluster
*         my-hybrid-aks-ext01      my-hybrid-aks-ext01            clusterUser_my-hybrid-rg_my-hybrid-aks-ext01
  2. Se necessário, defina o contexto atual para o cluster que acabou de criar (o cluster no qual pretende instalar o Apigee hybrid). Partindo do princípio da saída get-contexts anterior, se o nome do cluster que criou fosse my-hybrid-aks-cluster, mudaria para o contexto my-hybrid-aks-cluster, da seguinte forma: 
    kubectl config use-context my-hybrid-aks-cluster

    Em que my-hybrid-aks-cluster é o nome do contexto do cluster para o qual mudar.

Resumo

Agora, tem um cluster do Kubernetes em execução no AKS. O seu ambiente de shell está configurado e tem tudo a postos para instalar o software de runtime híbrido do Apigee na sua máquina local.

1 (NEXT) Passo 2: instale o cert-manager e o ASM 3 4 5