Passo 1: crie um cluster do AKS

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 o Azure CLI (az) e o kubectl instalados 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 da CLI do Azure. Por exemplo: 

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: 

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

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.
    Tab Atributo Valor
    Básico 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.13 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 Avançada
    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 do Kubernetes para o cluster recém-criado através do seguinte comando se ainda não tiverem sido adicionadas. Por exemplo: 

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. Por exemplo:

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 apigeectl 3 4