Cette étape explique comment configurer votre environnement shell et créer un cluster Microsoft® Azure Kubernetes Service (AKS) adapté au test Apigee hybrid.
Configurer l'interface système de votre terminal
Vérifiez que Azure CLI (az) et kubectl sont installés dans votre interface système locale. L'outil Azure CLI est l'interface de ligne de commande principale utilisée sur Azure, et kubectl fournit l'interface de ligne de commande principale permettant d'exécuter des commandes sur les clusters Kubernetes.
Créer un groupe de ressources
Créez un groupe de ressources à l'aide de la console Azure ou de la CLI Azure. Exemple :
az group create --name my-hybrid-rg --location eastus
Créer un réseau virtuel
Créez un réseau virtuel avec une plage CIDR non conflictuelle. Exemple :
Cliquez sur Kubernetes services (Services Kubernetes).
Créez un cluster avec les paramètres de configuration minimaux suivants.
Tabulation
Attribut
Valeur
Propriétés de base
Abonnement
Le nom de votre abonnement
Groupe de ressources
Le groupe de ressources que vous avez créé précédemment
Région
La région que vous avez spécifiée précédemment. Par exemple : (US) Est des États-Unis
Nom du cluster Kubernetes
Le nom du cluster. Par exemple : my-hybrid-aks-cluster
Version de Kubernetes
Choisissez la version 1.13 ou une version ultérieure
Préfixe du nom DNS
Le préfixe du nom DNS. Par exemple : my-hybrid-aks-cluster-dns
Nombre de nœuds
3
Taille du nœud
Standard DS3
Évoluer
Nœuds virtuels
Désactivé
Ensembles de mise à l'échelle de VM
Activé
Authentification
Activer RBAC
Oui
Entité principale de service
Par défaut
Mise en réseau
Routage des applications HTTP
Non
Équilibreur de charge
Standard
Configuration du réseau
Avancé
Réseau virtuel
Le nom du réseau virtuel. Vous pouvez sélectionner le réseau virtuel que vous avez créé précédemment ou en créer un en cliquant sur le lien Créer un nouveau réseau. Par exemple : my-hybrid-rg-vnet
Sous-réseau de cluster
Exemple : default (10.240.0.0/16)
Plage d'adresses de service Kubernetes
La plage d'adresses de service. Veillez à utiliser une plage d'adresses non concurrentielles.
Par exemple : 10.0.0.0/16
Adresse IP du service DNS Kubernetes
Par exemple : 10.0.0.10
Adresse de liaison Docker
Par exemple : 172.17.0.1/16
Monitoring
Activer la surveillance des conteneurs
Oui
Espace de travail Log Analytics
Par exemple : DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS
Tags
Aucun
Cliquez sur Review and Create (Vérifier et créer).
Une fois la création du cluster terminée, passez à l'étape suivante.
Définir les identifiants du cluster
Le cas échéant, ajoutez les identifiants de cluster Kubernetes pour le cluster que vous venez de créer en utilisant la commande suivante. Exemple :
az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster
Définissez le contexte actuel
Un contexte est un groupe de paramètres d'accès. Chaque contexte contient un cluster Kubernetes, un utilisateur et un espace de noms. Le contexte actuel est le cluster par défaut actuel de kubectl : toutes les commandes kubectl s'exécutent sur ce cluster.
Vérifiez que le contexte actuel est défini sur le cluster que vous venez de créer. Exemple :
Si le contexte n'est pas défini comme prévu sur votre cluster, procédez comme suit pour le modifier :
Répertoriez tous les contextes pour déterminer lequel est le contexte actuel. Dans l'exemple suivant, le contexte est défini sur 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
Si nécessaire, définissez le contexte actuel sur le cluster que vous venez de créer (dans lequel vous souhaitez installer Apigee hybrid). En supposant la sortie get-contexts précédente, si le nom du cluster que vous avez créé était my-hybrid-aks-cluster, vous basculeriez vers le contexte my-hybrid-aks-cluster, comme suit :
kubectl config use-context my-hybrid-aks-cluster
Où my-hybrid-aks-cluster est le nom du contexte du cluster vers lequel basculer.
Résumé
Vous disposez maintenant d'un cluster Kubernetes s'exécutant dans AKS. Votre environnement shell est configuré, et vous êtes prêt à installer le logiciel d'exécution Apigee hybrid sur votre machine locale.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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"]]