Langkah ini menjelaskan cara menyiapkan lingkungan shell dan membuat cluster Microsoft®
Azure Kubernetes Service
(AKS) yang sesuai untuk menguji Apigee hybrid.
Menyiapkan shell terminal
Pastikan Anda telah menginstal
Azure CLI (az) dan kubectl
di shell lokal. Alat Azure CLI menyediakan antarmuka command line utama untuk Azure, dan kubectl menyediakan antarmuka command line utama untuk menjalankan perintah terhadap cluster Kubernetes.
Membuat grup resource
Buat grup resource menggunakan konsol Azure atau dengan Azure CLI. Contoh:
az group create --name my-hybrid-rg --location eastus
Membuat jaringan virtual
Buat jaringan virtual dengan rentang CIDR yang tidak bertentangan. Contoh:
Buat cluster dengan setelan konfigurasi minimum berikut.
Penyimpanan minimum yang direkomendasikan: Tinjau spesifikasi disk AKS dan pilih ukuran volume penyimpanan
berdasarkan IOPS dan persyaratan biaya Anda.
Tab
Atribut
Nilai
Dasar-dasar
Langganan
Nama langganan Anda
Grup resource
Grup resource yang Anda buat sebelumnya
Wilayah
Wilayah yang Anda tentukan sebelumnya. Misalnya: (US) East US
Nama cluster Kubernetes
Nama cluster. Contoh: my-hybrid-aks-cluster
Versi Kubernetes
Pilih versi 1.14.x atau yang lebih baru
Awalan nama DNS
Awalan nama DNS. Contoh: my-hybrid-aks-cluster-dns
Jumlah node
3
Ukuran node
DS3 Standard
Menskalakan
Node virtual
Nonaktif
Set skala VM
Aktif
Authentication
Mengaktifkan RBAC
Ya
Entitas utama layanan
Default
Jaringan
Pemilihan rute aplikasi HTTP
Tidak
Load balancer
Standar
Konfigurasi jaringan
Lanjutan
Jaringan virtual
Nama jaringan virtual. Anda dapat memilih virtual network yang dibuat
sebelumnya, atau membuat yang baru dengan mengklik link Create new. Contoh: my-hybrid-rg-vnet
Subnet cluster
Contoh: default (10.240.0.0/16)
Rentang alamat layanan Kubernetes
Rentang alamat layanan. Pastikan untuk menggunakan rentang alamat yang tidak bersaing.
Contoh: 10.0.0.0/16
Setelah pembuatan cluster selesai, lanjutkan ke langkah berikutnya.
Menetapkan kredensial cluster
Tambahkan kredensial cluster kubernetes untuk cluster yang baru dibuat menggunakan perintah berikut jika belum ditambahkan. Contoh:
az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster
Menetapkan konteks saat ini
Konteks adalah grup parameter akses. Setiap konteks berisi cluster Kubernetes,
pengguna, dan namespace. Konteks saat ini adalah cluster yang saat ini menjadi default untuk
kubectl: semua perintah kubectl dijalankan pada cluster tersebut.
Pastikan konteks saat ini ditetapkan ke cluster yang baru saja Anda buat. Contoh:
Jika konteks tidak ditetapkan ke cluster Anda seperti yang diharapkan, ikuti langkah-langkah berikut untuk mengubahnya:
Cantumkan semua konteks untuk menentukan konteks saat ini. Dalam
contoh berikut, konteks ditetapkan ke 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
Jika perlu, tetapkan konteks saat ini ke cluster yang baru saja Anda buat (cluster
tempat Anda ingin menginstal Apigee hybrid). Dengan asumsi output get-contexts sebelumnya,
jika nama cluster yang Anda buat adalah my-hybrid-aks-cluster, Anda akan beralih ke
konteks my-hybrid-aks-cluster, seperti berikut:
kubectl config use-context my-hybrid-aks-cluster
Dengan my-hybrid-aks-cluster adalah nama konteks cluster yang akan dialihkan.
Ringkasan
Sekarang Anda memiliki cluster Kubernetes yang berjalan di AKS. Lingkungan shell Anda telah
disiapkan, dan Anda siap menginstal software runtime campuran Apigee
di komputer lokal.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-03 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"]]
