Rövid útmutató: Kubernetes-fürt üzembe helyezése Azure Resource Manager-sablonnal

A következőkre vonatkozik: Azure Local, 23H2-es verzió

Ez a rövid útmutató bemutatja, hogyan helyezhet üzembe Kubernetes-fürtöt az AKS Arcban egy Azure Resource Manager-sablon (ARM) használatával. Az Azure Arc bárhol kiterjeszti az Azure felügyeleti képességeit a Kubernetes-fürtökre, egységes megközelítést biztosítva a különböző környezetek kezeléséhez.

Mielőtt elkezdené

Ez a cikk a Kubernetes-fogalmak alapszintű megértését feltételezi.

ARM-sablon üzembe helyezéséhez írási hozzáféréssel kell rendelkeznie az üzembe helyezendő erőforrásokhoz, és hozzáféréssel kell rendelkeznie a Microsoft.Resources/deployments erőforrástípus összes műveletéhez. Virtuális gép üzembe helyezéséhez például Microsoft.Compute/virtualMachines/write és Microsoft.Resources/deployments/* engedélyekre van szükség. A szerepkörök és engedélyek listáját megtalálja a Beépített Azure-szerepkörök című cikkben.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel.
• Egy Azure Local, 23H2-es verziójú fürt.
• Az Azure CLI legújabb verziója.

1. lépés: Az Azure-fiók előkészítése

1. Jelentkezzen be az Azure-ba: nyissa meg a terminált vagy a parancssort, és jelentkezzen be az Azure-fiókjába az Azure CLI használatával:

   az login
   

2. Előfizetés beállítása: cserélje le <your-subscription-id> az előfizetés azonosítóját:

   az account set --subscription "<your-subscription-id>"
   

2. lépés: SSH-kulcspár létrehozása az Azure CLI használatával

az sshkey create --name "mySSHKey" --resource-group "myResourceGroup"

vagy hozzon létre egy SSH-kulcspárt az ssh-keygen használatával:

ssh-keygen -t rsa -b 4096

A sablon üzembe helyezéséhez meg kell adnia a nyilvános kulcsot az SSH-párból. A nyilvános kulcs lekéréséhez használja a az sshkey show következő parancsot:

az sshkey show --name "mySSHKey" --resource-group "myResourceGroup" --query "publicKey"

Alapértelmezés szerint az SSH-kulcsfájlok a ~/.ssh könyvtárban jönnek létre. Futtassa a az sshkey create vagy ssh-keygen a parancsot az azonos nevű meglévő SSH-kulcspár felülírásához.

További információ az SSH-kulcsok létrehozásáról: SSH-kulcsok létrehozása és kezelése az Azure-ban történő hitelesítéshez.

3. lépés: A sablon áttekintése

Töltse le a sablon- és paraméterfájlokat az AKSArc adattárból a helyi gépre. Tekintse át az összes alapértelmezett értéket, és győződjön meg arról, hogy helyesek.

4. lépés: A sablon üzembe helyezése

A Kubernetes-fürt üzembe helyezéséhez futtassa a következő parancsot:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

A fürt létrehozása néhány percet vesz igénybe. Várja meg, amíg a fürt sikeresen üzembe lesz helyezve, mielőtt továbblép a következő lépésre.

5. lépés: Az üzembe helyezés ellenőrzése

Az üzembe helyezés befejezése után az alábbi paranccsal ellenőrizze, hogy a Kubernetes-fürt működik-e:

az aksarc show --resource-group "<resource-group-name>" --name "<cluster-name>" --output table

6. lépés: Csatlakozás a fürthöz

1. A fürthöz való csatlakozáshoz futtassa a az connectedk8s proxy parancsot. A parancs letölt és futtat egy proxy bináris fájlt az ügyfélszámítógépen, és lekéri a fürthöz társított kubeconfig fájlt:

   az connectedk8s proxy --name <cluster name> -g <resource group>
   

   Vagy használja a Kubernetes parancssori ügyfelet, a kubectl-et. Ha az Azure Cloud Shellt használja, a Kubectl már telepítve van. A kubectl helyi telepítéséhez és futtatásához futtassa a az aksarc install-cli parancsot.

   Konfigurálja a kubectl-et a Kubernetes-fürthöz való csatlakozáshoz a az aksarc get-credentials parancs használatával. Ez a parancs letölti a hitelesítő adatokat, és konfigurálja a Kubernetes parancssori felületét a használatukhoz:

   az aksarc get-credentials --resource-group "<resource-group-name>" --name "<cluster-name>"
   

2. Ellenőrizze a fürthöz való kapcsolatot a kubectl get paranccsal. Ez a parancs a fürtcsomópontok listáját adja vissza:

   kubectl get nodes -A --kubeconfig .\<path to kubecofig> 
   

   Az alábbi példakimenet az előző lépésekben létrehozott három csomópontot mutatja be. Győződjön meg arról, hogy a csomópont állapota kész:

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-agentpool-27442051-vmss000000   Ready    agent   10m   v1.27.7
   aks-agentpool-27442051-vmss000001   Ready    agent   10m   v1.27.7
   aks-agentpool-27442051-vmss000002   Ready    agent   11m   v1.27.7
   

7. lépés: Csomópontkészlet üzembe helyezése Azure Resource Manager-sablonnal (nem kötelező)

A 3. lépéshez töltse le a csomópontkészlet sablonját és paramétereit az AKSArc-adattárból, és tekintse át az alapértelmezett értékeket.

A sablon üzembe helyezése és az eredmények ellenőrzése az Azure CLI használatával (nem kötelező)

Tekintse át és alkalmazza a sablont. Ez a folyamat néhány percet vesz igénybe. Az Azure CLI használatával ellenőrizheti, hogy a csomópontkészlet sikeresen létrejött-e:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

az aksarc nodepool show --cluster-name "<cluster-name>" --resource-group "<resource-group-name>" --name "<nodepool-name>"

Sablonerőforrások

connectedClusters

ProvisionedClusterInstances

ExtendedLocation

Következő lépések

Az AKS Arc áttekintése