In diesem Schritt wird erläutert, wie Sie Ihre Shell-Umgebung einrichten und einen Microsoft® Azure Kubernetes Service-Cluster (AKS) erstellen, der zum Testen von Apigee Hybrid geeignet ist.
Terminal-Shell einrichten
Achten Sie darauf, dass die Azure-Befehlszeile (az) und kubectl in Ihrer lokalen Shell installiert sind. Das Azure-Befehlszeilentool stellt die primäre Befehlszeile für Azure bereit und kubectl die primäre Befehlszeile zum Ausführen von Befehlen für Kubernetes-Cluster.
Ressourcengruppe erstellen
Erstellen Sie eine Ressourcengruppe entweder mit der Azure-Konsole oder mit der Azure-Befehlszeile. Beispiel:
az group create --name my-hybrid-rg --location eastus
Virtuelles Netzwerk erstellen
Erstellen Sie ein virtuelles Netzwerk mit einem konfliktfreien CIDR-Bereich. Beispiel:
Erstellen Sie einen Cluster mit den folgenden Mindestkonfigurationseinstellungen.
Empfohlener Mindestspeicher: Lesen Sie die Spezifikationen des AKS-Laufwerks und wählen Sie eine Speicher-Volume-Größe basierend auf Ihren IOPs und Kostenanforderungen aus.
Tabulatortaste
Attribut
Wert
Grundlagen
Abo
Name Ihres Abos
Ressourcengruppe
Die Ressourcengruppe, die Sie zuvor erstellt haben.
Region
Die zuvor angegebene Region. Beispiel: (USA) us-east
Kubernetes-Clustername
Der Name des Clusters. Beispiel: my-hybrid-aks-cluster.
Kubernetes-Version
Wählen Sie Version 1.14.x oder eine neuere Version aus
DNS-Namenspräfix
Das Präfix des DNS-Namens. Beispiel: my-hybrid-aks-cluster-dns.
Knotenzahl
3
Knotengröße
DS3 Standard
Skala
Virtuelle Knoten
Deaktiviert
VM-Skalierungsgruppen
Aktiviert
Authentifizierung
RBAC aktivieren
Ja
Service-Hauptkonto
Standard
Netzwerk
HTTP-Anwendungsrouting
Nein
Load-Balancer
Standard
Netzwerkkonfiguration
Erweitert
Virtuelles Netzwerk
Der Name des virtuellen Netzwerks. Sie können das zuvor erstellte virtuelle Netzwerk auswählen oder ein neues erstellen, indem Sie auf den Link Neu erstellen klicken. Beispiel: my-hybrid-rg-vnet
Clustersubnetz
Beispiel: default (10.240.0.0/16)
Adressbereich des Kubernetes-Dienstes
Dies ist der Dienstadressbereich. Verwenden Sie keinen konkurrierenden Adressbereich.
Beispiel: 10.0.0.0/16
Fahren Sie mit dem nächsten Schritt fort, wenn die Clustererstellung abgeschlossen ist.
Clusteranmeldedaten festlegen
Fügen Sie die Anmeldedaten des Kubernetes-Clusters für den neu erstellten Cluster mit dem folgenden Befehl hinzu, falls die Daten noch nicht vorhanden sind. Beispiel:
az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster
Aktuellen Kontext festlegen
Ein Kontext ist eine Gruppe von Zugriffsparametern. Jeder Kontext enthält einen Kubernetes-Cluster, einen Nutzer und einen Namespace. Der aktuelle Kontext ist der Cluster, der derzeit als Standard für kubectl gilt: alle kubectl-Befehle werden für diesen Cluster ausgeführt.
Achten Sie darauf, dass der aktuelle Kontext auf den soeben erstellten Cluster gesetzt ist. Beispiel:
Wenn der Kontext nicht wie erwartet auf den Cluster gesetzt ist, gehen Sie so vor:
Listen Sie alle Kontexte auf, um den aktuellen Kontext zu bestimmen. Im folgenden Beispiel ist der Kontext auf my-hybrid-aks-ext01 festgelegt:
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
Legen Sie gegebenenfalls den aktuellen Kontext auf den soeben erstellten Cluster fest (den Cluster, in dem Sie Apigee Hybrid installieren möchten). Von der vorherigen get-contexts-Ausgabe ausgehend, würden Sie so zum my-hybrid-aks-cluster-Kontext wechseln, wenn der Name des zuvor erstellten Clusters my-hybrid-aks-cluster lautet:
kubectl config use-context my-hybrid-aks-cluster
Dabei ist my-hybrid-aks-cluster der Name des Clusterkontexts, zu dem gewechselt werden soll.
Fazit
Sie haben jetzt einen Kubernetes-Cluster, der in AKS ausgeführt wird. Ihre Shell-Umgebung ist eingerichtet und Sie können die Apigee-Hybrid-Laufzeitsoftware auf Ihrem lokalen Rechner installieren.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-28 (UTC)."],[[["\u003cp\u003eThis documentation covers version 1.2 of Apigee hybrid, which is end-of-life, and users should upgrade to a newer version.\u003c/p\u003e\n"],["\u003cp\u003eInstructions are provided for setting up a shell environment and creating a Microsoft Azure Kubernetes Service (AKS) cluster for testing Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eThe Azure CLI (az) and kubectl tools are required and need to be installed for interacting with Azure and Kubernetes clusters, respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe process includes creating a resource group, a virtual network with a non-conflicting CIDR range, and an AKS cluster with specific configuration settings.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating the AKS cluster, users must set the cluster credentials and ensure the current context is correctly set to their newly created cluster to run \u003ccode\u003ekubectl\u003c/code\u003e commands.\u003c/p\u003e\n"]]],[],null,["# Step 1: Create an AKS cluster\n\n| You are currently viewing version 1.2 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| **UPGRADING:** If you are upgrading from v1.1.x to v1.2.0, see [Upgrading Apigee hybrid](/apigee/docs/hybrid/v1.2/upgrade) for instructions. If you are performing a new installation, continue with the configurations described below.\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:\nFor example:\n\n\u003cbr /\u003e\n\n### Syntax\n\n```\naz network vnet create \\\n --name vnet-name \\\n --resource-group my-hybrid-rg \\\n --address-prefixes vnet-address-range \\\n --subnet-name vnet-subnet-name \\\n --subnet-prefix subnet-address-range\n```\n\n### 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/14 \\\n --subnet-name my-hybrid-rg-vnet-subnet \\\n --subnet-prefix 120.38.1.0/16\n```\n\n\nWhere:\n\n1. \u003cvar translate=\"no\"\u003emy-hybrid-rg\u003c/var\u003e is the name of the virtual network.\n2. \u003cvar translate=\"no\"\u003evnet-address-range\u003c/var\u003e is a list of address blocks reserved for this virtual network in CIDR notation.\n3. \u003cvar translate=\"no\"\u003evnet-subnet-name\u003c/var\u003e is the name of the subnet within the virtual network.\n4. \u003cvar translate=\"no\"\u003esubnet-address-range\u003c/var\u003e is a list of address blocks reserved for this subnet in CIDR notation.\n\nCreate an AKS cluster\n---------------------\n\n| **Note:** Apigee does not support [GKE Sandbox](https://cloud.google.com/kubernetes-engine/docs/concepts/sandbox-pods) 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\n\n **Recommended minimum storage**: Review the AKS disk specifications and choose a storage volume size\n based on your IOPs and cost 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.2/install-create-cluster-aks) [(NEXT) Step 2: Install apigeectl](/apigee/docs/hybrid/v1.2/install-download-install-aks) [3](/apigee/docs/hybrid/v1.2/install-copy-overrides-aks) [4](/apigee/docs/hybrid/v1.2/install-apply-hybrid-aks)\n\n\u003cbr /\u003e"]]
