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:
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
Clique em Rever e criar.
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:
Se o contexto não estiver definido para o seu cluster conforme esperado, siga estes passos para o alterar:
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
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis guide details how to set up a shell environment and create a Microsoft Azure Kubernetes Service (AKS) cluster suitable for testing Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eThe Azure CLI and \u003ccode\u003ekubectl\u003c/code\u003e tools are required and should be installed in your local shell for interacting with Azure and Kubernetes clusters.\u003c/p\u003e\n"],["\u003cp\u003eA resource group and a virtual network must be created within Azure, using the provided Azure CLI commands or through the Azure console.\u003c/p\u003e\n"],["\u003cp\u003eAn AKS cluster needs to be created, with specific configurations detailed in the provided table, ensuring that the node size is set to a minimum of DS3 Standard for sufficient CPU resources.\u003c/p\u003e\n"],["\u003cp\u003eThe current Kubernetes context must be set to the newly created AKS cluster to allow \u003ccode\u003ekubectl\u003c/code\u003e commands to interact with the correct cluster.\u003c/p\u003e\n"]]],[],null,["# Step 1: Create an AKS cluster\n\n| You are currently viewing version 1.1 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nThis step explains how to set up your shell environment and create a Microsoft®\nAzure Kubernetes Service\n(AKS) cluster suitable for testing Apigee hybrid.\n| There are many variations on how to create clusters in AKS. This topic walks through a basic scenario to help get you started with hybrid. For more detailed information about create clusters on AKS, see also [Quickstart:\n| Deploy an Azure Kubernetes Service cluster using the Azure CLI](https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough) and [Quickstart: Deploy\n| an Azure Kubernetes Service (AKS) cluster using the Azure portal](https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough)\n\nSet up your terminal shell\n--------------------------\n\nBe sure you have the [Azure CLI (az)](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest) and [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)\ninstalled in your local shell. The Azure CLI\ntool provides the primary command-line interface for Azure, and `kubectl` provides the primary\ncommand-line interface for running commands against Kubernetes clusters.\n\nCreate a resource group\n-----------------------\n\n\nCreate a resource group either using Azure console or with the Azure CLI. For example: \n\n```\naz group create --name my-hybrid-rg --location eastus\n```\n\nCreate a virtual network\n------------------------\n\n\nCreate a virtual network with a non-conflicting CIDR range. For example: \n\n```\naz network vnet create \\\n --name my-hybrid-rg-vnet \\\n --resource-group my-hybrid-rg \\\n --address-prefixes 120.38.1.0/24 \\\n --subnet-name my-hybrid-rg-vnet-subnet \\\n --subnet-prefix 120.38.1.0/26\n```\n\nCreate an AKS cluster\n---------------------\n\n| **Note:** Apigee does not support [GKE Sandbox](https://cloud.google.com/kubernetes-engine/sandbox) or [gVisor](https://github.com/google/gvisor).\n\n\nIn this step, you will create an AKS cluster.\n\n1. Open the [Microsoft® Azure Portal](https://portal.azure.com/).\n2. Click **Kubernetes services**.\n3. Create a cluster with the following minimum configuration settings. The configuration values shown below are for example purposes only. They are generally the default values and are suitable for testing purposes. It is up to you to decide how to configure your cluster to suit your requirements.\n\n4. Click **Review and Create**.\n5. When the cluster creation completes, go to the next step.\n\nSet cluster credentials\n-----------------------\n\n\nAdd the kubernetes cluster credentials for the newly created cluster using the following command\nif not already added. For example: \n\n```\naz aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster\n```\n\nSet the current context\n-----------------------\n\n\nA *context* is a group of access parameters. Each context contains a Kubernetes cluster,\na user and a namespace. The current context is the cluster that is currently the default for\n`kubectl`: all `kubectl` commands run against that cluster.\n\n\nMake sure the current context is set to the cluster you just created. For example: \n\n```\nkubectl config current-context\n my-hybrid-aks-cluster-context\n```\n\n\nIf the context is not set to your cluster as expected, follow these steps to change it:\n\n1. List all the contexts to determine which is the *current* context. In the following example, the context is set to the `my-hybrid-aks-ext01`: \n\n ```\n kubectl config get-contexts\n CURRENT NAME CLUSTER AUTHINFO\n my-hybrid-aks-cluster my-hybrid-aks-cluster clusterUser_my-hybrid-rg2_myhybrid-aks-cluster\n * my-hybrid-aks-ext01 my-hybrid-aks-ext01 clusterUser_my-hybrid-rg_my-hybrid-aks-ext01\n\n ```\n2. If necessary, set the current context to the cluster you just created (the cluster into which you intend to install Apigee hybrid). Assuming the previous `get-contexts` output, if the cluster name you created were `my-hybrid-aks-cluster`, you would switch to the `my-hybrid-aks-cluster` context, as follows: \n\n ```\n kubectl config use-context my-hybrid-aks-cluster\n ```\n\n Where `my-hybrid-aks-cluster` is the name of the cluster context to switch to.\n\nSummary\n-------\n\n\nYou now have a Kubernetes cluster running in AKS. Your shell environment is\nset up, and you are ready to install the Apigee hybrid runtime software\non your local machine.\n[1](/apigee/docs/hybrid/v1.1/install-create-cluster-aks) [(NEXT) Step 2: Install apigeectl](/apigee/docs/hybrid/v1.1/install-download-install-aks) [3](/apigee/docs/hybrid/v1.1/install-copy-overrides-aks) [4](/apigee/docs/hybrid/v1.1/install-apply-hybrid-aks)\n\n\u003cbr /\u003e"]]
