Etapa 1: criar um cluster do AKS

Nesta etapa, explicamos como configurar seu ambiente de shell e criar um cluster do Microsoft® Azure Kubernetes Service (AKS) adequado para testar o híbridos da Apigee.

Configurar o shell do terminal

Verifique se a CLI do Azure (az) e a kubectl estão instaladas no shell local. A ferramenta da CLI do Azure fornece a interface de linha de comando principal do Azure e kubectl fornece a interface de linha de comando principal para executar comandos em clusters do Kubernetes.

Criar um grupo de recursos

Crie um grupo de recursos usando o Console do Azure ou a CLI do Azure. Por exemplo:

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

Criar uma rede virtual

Crie uma rede virtual com um intervalo CIDR não conflitante. Por exemplo:

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

Em que:

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

Criar um cluster do AKS

Nesta etapa, você criará um cluster do AKS.

Abra o Portal do Microsoft® Azure.
Clique em Serviços do Kubernetes.

Crie um cluster com as seguintes configurações mínimas.

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

Tab	Atributo	Valor
Princípios básicos	Assinatura	O nome da sua assinatura
	Grupo de recursos	O grupo de recursos que você criou anteriormente
	Região	A região que você especificou anteriormente. Por exemplo: (US) Leste dos EUA
	Nome do cluster do Kubernetes	O nome do cluster. Por exemplo: `my-hybrid-aks-cluster`
	Versão do Kubernetes	Escolha a versão 1.14.x ou uma versão posterior
	Prefixo de nome DNS	O prefixo do nome do DNS. Por exemplo: `my-hybrid-aks-cluster-dns`
	Contagem de nós	3
	Tamanho do nó	DS3 Standard O uso de CPUs virtuais inferiores a quatro pode resultar na falha na criação do pod do Cassandra devido ao número de CPUs insuficiente. O armazenamento será provisionado usando o provisionador dinâmico do kubernetes
Escala	Nós virtuais	Desativado
	Conjuntos de escalas da VM	Ativado
Authentication	Ativar RBAC	Sim
	Serviço principal	Padrão
Rede	Roteamento de aplicativos HTTP	Não
	Balanceador de carga	Padrão
	Configuração de rede	Avançado
	Rede virtual	O nome da rede virtual. É possível selecionar a rede virtual criada anteriormente ou criar uma nova clicando no link Criar nova. Por exemplo: `my-hybrid-rg-vnet`
	Sub-rede de cluster	Exemplo: `default (10.240.0.0/16)`
	Intervalo de endereços de serviço do Kubernetes	O intervalo de endereços do serviço. Use um intervalo de endereços que não seja competitivo. Por exemplo: `10.0.0.0/16`
	Endereço IP do serviço DNS do Kubernetes	Por exemplo: `10.0.0.10`
	Endereço do Docker Bridge	Por exemplo: `172.17.0.1/16`
Monitoring	Ativar o monitoramento de contêineres	Sim
	Espaço de trabalho do Analytics do Analytics	Por exemplo: `DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS`
Tags		Nenhum

Clique em Revisar e criar.
Quando a criação do cluster for concluída, vá para a próxima etapa.

Definir credenciais do cluster

Adicione as credenciais de cluster do Kubernetes para o cluster recém-criado usando o comando a seguir, se ainda não tiver sido adicionado. 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 usuário e um namespace. O contexto atual é o cluster que é o padrão para kubectl no momento: todos os comandos kubectl são executados nesse cluster.

Verifique se o contexto atual está definido como o cluster que você acabou de criar. Por exemplo:

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

Se o contexto não estiver definido como o cluster esperado, siga estas etapas para alterá-lo:

Liste todos os contextos para determinar qual é o contexto atual. No exemplo a seguir, o contexto é 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

Se necessário, defina o contexto atual para o cluster que você acabou de criar (o cluster em que pretende instalar a Apigee híbrida). Supondo que a saída get-contexts anterior, se o nome do cluster que você criou fosse my-hybrid-aks-cluster, alterne para o contexto my-hybrid-aks-cluster, da seguinte maneira:
```
kubectl config use-context my-hybrid-aks-cluster
```
Em que my-hybrid-aks-cluster é o nome do contexto do cluster para o qual você quer alternar.

Resumo

Agora você tem um cluster do Kubernetes em execução no AKS. O ambiente de shell está configurado, e você está pronto para instalar o software de tempo de execução híbrido da Apigee na máquina local.

1 (A SEGUIR) Etapa 2: instalar a apigeectl 3 4