Az Azure Arc-kompatibilis Kubernetes-fürt előkészítése

Fontos

Az Azure IoT Operations Előzetes verziója – az Azure Arc által engedélyezett verzió jelenleg előzetes verzióban érhető el. Ezt az előzetes verziójú szoftvert nem szabad éles környezetben használni.

A bétaverziójú, előzetes verziójú vagy másként még általánosan nem elérhető Azure-szolgáltatások jogi feltételeit lásd: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.

Az Azure Arc-kompatibilis Kubernetes-fürt előfeltétele az Azure IoT Operations Preview üzembe helyezésének. Ez a cikk azt ismerteti, hogyan készíthet elő Azure Arc-kompatibilis Kubernetes-fürtöt, mielőtt üzembe helyezheti az Azure IoT Operations Preview-bővítményeket egy Kubernetes-fürtön saját számítási feladatok futtatásához. Ez a cikk útmutatást tartalmaz az Ubuntu, a Windows és a felhőkörnyezetek számára is.

Tipp.

Ha üzembe szeretné helyezni az Azure IoT Operationst, és mintaterhelést szeretne futtatni, tekintse meg az Azure IoT Operations előzetes verziójának üzembe helyezését arc-kompatibilis Kubernetes-fürtön.

Az Azure Iot Operations az Azure Arc-kompatibilis Kubernetes-szolgáltatások készlete, és a CNCF-kompatibilisArc által ellenőrzött partnertermékekkel való használatra szolgál. A Microsoft jelenleg a következő rögzített infrastruktúra- és környezetkészlettel érvényesítette az Azure IoT-műveleteket:

Környezet	Verzió
AKS-Enterprise kiadás Windows 11 IoT Enterprise rendszeren egycsomópontos AMD Ryzen-7 (8 mag, 3,3 GHz), 16 GB RAM	AksEdge-K3s-1.26.10-1.6.384.0
K3s on Ubuntu 22.04.2 egycsomópontos AMD Ryzen-7 (8 mag, 3,3 GHz), 16 GB RAM	K3s 1.28.5-ös verzió

Fontos

A korábban felsorolt környezetek éles környezetek, amelyeket a Microsoft érvényesített. Nem csak ezek a környezetek futtathatók az Azure IoT Operationsben. Az Azure IoT Operations bármely Arc-kompatibilis Kubernetes-fürtön futtatható, amely megfelel az Azure Arc-kompatibilis Kubernetes rendszerkövetelményeknek.

Előfeltételek

Az Azure Arc-kompatibilis Kubernetes-fürt előkészítéséhez a következőkre van szüksége:

• A rendszerkövetelményeknek megfelelő hardver.

AKS Edge Essentials

• Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyenesen .

• Az Azure CLI 2.46.0-s vagy újabb verziója telepítve van a fejlesztői gépen. A verzió ellenőrzésére és az upgrade szükség esetén frissítésre használhatóaz --version. További információ: Az Azure CLI telepítése.

• Az Azure CLI Azure IoT Operations-bővítménye. A bővítmény hozzáadásához vagy a legújabb verzióra való frissítéséhez használja az alábbi parancsot:

  az extension add --upgrade --name azure-iot-ops
  

• A rendszerkövetelményeknek megfelelő hardver:

  • Győződjön meg arról, hogy a gép legalább 10 GB RAM-mal, 4 virtuális processzorsal és 40 GB szabad lemezterülettel rendelkezik.
  • Tekintse át az AKS Edge Essentials követelményeit és támogatási mátrixát.
  • Tekintse át az AKS Edge Essentials hálózatkezelési útmutatóját.

Ubuntu

• Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyenesen .

• Az Azure CLI 2.46.0-s vagy újabb verziója telepítve van a fejlesztői gépen. A verzió ellenőrzésére és az upgrade szükség esetén frissítésre használhatóaz --version. További információ: Az Azure CLI telepítése.

• Az Azure CLI Azure IoT Operations-bővítménye. A bővítmény hozzáadásához vagy a legújabb verzióra való frissítéséhez használja az alábbi parancsot:

  az extension add --upgrade --name azure-iot-ops
  

• Tekintse át a K3s követelményeit.

Az Azure IoT Operations az Ubuntu-on is működik Linuxos Windows-alrendszer (WSL) a Windows-gépen. Csak tesztelési és fejlesztési célokra használja a WSL-t.

A WSL Ubuntu-környezet beállítása:

1. Telepítse a Linuxot Windowsra WSL-vel.

2. Engedélyezés systemd:

   sudo -e /etc/wsl.conf
   

   Adja hozzá a következőt a wsl.conf fájlhoz, majd mentse a fájlt:

   [boot]
   systemd=true
   

3. Az engedélyezés systemdután engedélyezze újra a windowsos végrehajtható fájlokat a WSL-ből:

   sudo sh -c 'echo :WSLInterop:M::MZ::/init:PF > /usr/lib/binfmt.d/WSLInterop.conf'
   sudo systemctl unmask systemd-binfmt.service
   sudo systemctl restart systemd-binfmt
   sudo systemctl mask systemd-binfmt.service
   

Kódterek

• Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyenesen .

• Egy GitHub-fiók.

• A Visual Studio Code telepítve van a fejlesztői gépen. További információ: Visual Studio Code letöltése.

Fürt létrehozása

Ez a szakasz lépéseket tartalmaz a fürtök linuxos és windowsos ellenőrzött környezetekben, valamint a felhőben található GitHub Codespace-ekben való előkészítéséhez és arc-engedélyezéséhez.

AKS Edge Essentials

Az Azure Kubernetes Service Edge Essentials az Azure Kubernetes Service (AKS) helyszíni Kubernetes-implementációja, amely nagy méretekben automatizálja a tárolóalapú alkalmazások futtatását. Az AKS Edge Essentials tartalmaz egy Microsoft által támogatott Kubernetes-platformot, amely egy kis méretű kubernetes-disztribúciót és egyszerű telepítési élményt nyújt, így a Kubernetes pc-osztályú vagy "könnyű" peremhálózati hardvereken is egyszerűen üzembe helyezhető.

Tipp.

Az AksEdgeQuickStartForAio.ps1 szkripttel automatizálhatja a szakasz lépéseit, és csatlakoztathatja a fürtöt.

Nyisson meg egy emelt szintű PowerShell-ablakot, módosítsa a könyvtárat munkamappára, majd futtassa a következő parancsokat:

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStartForAio.ps1
Unblock-File .\AksEdgeQuickStartForAio.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
.\AksEdgeQuickStartForAio.ps1 -SubscriptionId "<SUBSCRIPTION_ID>" -TenantId "<TENANT_ID>" -ResourceGroupName "<RESOURCE_GROUP_NAME>"  -Location "<LOCATION>"  -ClusterName "<CLUSTER_NAME>"

Előfordulhat, hogy a gép a folyamat részeként újraindul. Ha igen, futtassa újra a parancsok teljes készletét.

Készítse elő a gépet az AKS Edge Essentials-hez.

1. Töltse le az érvényesített AKS Edge Essentials-verzió telepítőt a helyi gépére.

2. Végezze el a gép előkészítése az AKS Edge Essentials-hez című témakörben leírt lépéseket. Ügyeljen arra, hogy az előző lépésben letöltött érvényesített telepítőt használja, és ne a legújabb verziót.

Állítson be egy AKS Edge Essentials-fürtöt a gépen.

1. Végezze el az egyetlen gép üzembe helyezésének lépéseit, de az 1. lépés végén , az egygépes konfigurációs paramétereknél módosítsa a következő értékeket a aksedge-config.json fájlban:

   `Init.ServiceIPRangeSize` = 10
   `LinuxNode.DataSizeInGB` = 30
   `LinuxNode.MemoryInMB` = 8192
   

2. Telepítse a helyi elérési utat a fürtben az alábbi parancs futtatásával:

   kubectl apply -f https://raw.githubusercontent.com/Azure/AKS-Edge/main/samples/storage/local-path-provisioner/local-path-storage.yaml
   

Futtassa a következő parancsokat az üzembe helyezés sikerességének ellenőrzéséhez:

Import-Module AksEdge
Get-AksEdgeDeploymentInfo

A parancs kimenetében Get-AksEdgeDeploymentInfo látnia kell, hogy a fürt Arc állapota .Connected

Ubuntu

Az Azure IoT Operationsnek bármilyen CNCF-konform kubernetes-fürtön működnie kell. Ubuntu Linux esetén a Microsoft jelenleg a K3s-fürtöket támogatja.

Fontos

Ha az Ubuntu-t használja Linuxos Windows-alrendszer (WSL), futtassa ezeket a lépéseket a WSL-környezetben, beleértve a fürt konfigurálásához szükséges Azure CLI-lépéseket is.

K3s Kubernetes-fürt előkészítése az Ubuntu-on:

1. Futtassa a K3s telepítési szkriptet:

   curl -sfL https://get.k3s.io | sh -
   

   A telepítéssel kapcsolatos teljes információkért tekintse meg a K3s gyorsindítási útmutatóját.

2. Hozzon létre egy K3s-konfigurációs yaml-fájlt a következő helyen .kube/config:

   mkdir ~/.kube
   sudo KUBECONFIG=~/.kube/config:/etc/rancher/k3s/k3s.yaml kubectl config view --flatten > ~/.kube/merged
   mv ~/.kube/merged ~/.kube/config
   chmod  0600 ~/.kube/config
   export KUBECONFIG=~/.kube/config
   #switch to k3s context
   kubectl config use-context default
   

3. Futtassa a következő parancsot a felhasználói óra/példány korlátainak növeléséhez.

   echo fs.inotify.max_user_instances=8192 | sudo tee -a /etc/sysctl.conf
   echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
   
   sudo sysctl -p
   

4. A jobb teljesítmény érdekében növelje a fájlleíró korlátját:

   echo fs.file-max = 100000 | sudo tee -a /etc/sysctl.conf
   
   sudo sysctl -p
   

Kódterek

Fontos

A kódterek könnyen beállíthatók gyorsan, és később lebonthatók, de nem alkalmasak teljesítményértékelésre vagy méretezési tesztelésre. A GitHub Codespaces használata csak feltáráshoz.

A GitHub Codespaces használatával kipróbálhatja az Azure IoT Operationst egy Kubernetes-fürtön anélkül, hogy bármit is telepítene a helyi gépére. Az Azure-Samples/explore-iot-operations kódtér előre konfigurálva van a következőkkel:

• A K3d-ben futó K3s egy egyszerűsített Kubernetes-fürthöz
• Azure CLI
• Kubectl a Kubernetes-erőforrások kezeléséhez
• Egyéb hasznos eszközök, például a Helm és a k9s

A kódtér és a fürt létrehozásához kövesse az alábbi lépéseket:

1. Hozzon létre egy kódteret a GitHub Codespacesben.

   

2. Adja meg a következő ajánlott titkos kódokat a kódtérhez:

   Paraméter	Érték
   SUBSCRIPTION_ID	Az Azure-előfizetés azonosítója.
   RESOURCE_GROUP	Egy új Azure-erőforráscsoport neve, amelyben a fürt létrejön.
   HELY	Egy Önhöz közeli Azure-régió. A nyilvános előzetes verzióban a következő régiók támogatottak: eastus, eastus2, westus, westus2, westus3, westeurope vagy northeurope.

   Tipp.

   Az ebben a lépésben titkos kulcsként megadott értékek a GitHub-fiókban lesznek mentve, hogy az ebben és a jövőbeni kódterekben használhassa őket. A rendszer automatikusan környezeti változóként is hozzáadja őket a kódtér termináljában, és ezeket a környezeti változókat a következő szakaszban, a CLI-parancsokban használhatja.

   Emellett ez a kódtér automatikusan létrehoz egy környezeti változót CLUSTER_NAME , amely a kódtér nevével van beállítva.

3. Válassza az Új kódtér létrehozása lehetőséget.

4. Ha elkészült a kódtér, válassza a bal felső menügombot, majd a Megnyitás a VS Code Desktopban lehetőséget.

   

5. Ha a rendszer kéri, telepítse a Visual Studio Code GitHub Codespaces bővítményét, és jelentkezzen be a GitHubra.

6. A Visual Studio Code-ban válassza a Terminál megtekintése lehetőséget>.

   Ezzel a terminállal futtathatja az összes parancssori és parancssori parancsot a fürt kezeléséhez.

A fürt arc-engedélyezése

Csatlakozás a fürtöt az Azure Arcba, hogy távolról lehessen felügyelni.

AKS Edge Essentials

Ha csatlakoztatni szeretné a fürtöt az Azure Archoz, végezze el az AKS Edge Essentials-fürt és az Arc közötti Csatlakozás lépéseit.

Ubuntu

Fürt csatlakoztatása az Azure Archoz:

1. Jelentkezzen be azon a gépen, amelyen üzembe helyezte a Kubernetes-fürtöt, vagy a WSL-környezetben, jelentkezzen be az Azure CLI-vel:

   az login
   

2. Állítsa be az Azure-előfizetés környezeti változóit, a helyet, az új erőforráscsoportot és a fürt nevét, mivel azok megjelennek az erőforráscsoportban.

   # Id of the subscription where your resource group and Arc-enabled cluster will be created
   export SUBSCRIPTION_ID=<SUBSCRIPTION_ID>
   
   # Azure region where the created resource group will be located
   # Currently supported regions: "eastus", "eastus2", "westus", "westus2", "westus3", "westeurope", or "northeurope"
   export LOCATION=<REGION>
   
   # Name of a new resource group to create which will hold the Arc-enabled cluster and Azure IoT Operations resources
   export RESOURCE_GROUP=<NEW_RESOURCE_GROUP_NAME>
   
   # Name of the Arc-enabled cluster to create in your resource group
   export CLUSTER_NAME=<NEW_CLUSTER_NAME>
   

3. Az Azure-előfizetés környezetének beállítása az összes parancshoz:

   az account set -s $SUBSCRIPTION_ID
   

4. Regisztrálja a szükséges erőforrás-szolgáltatókat az előfizetésében:

   Feljegyzés

   Ezt a lépést előfizetésenként csak egyszer kell futtatni.

   az provider register -n "Microsoft.ExtendedLocation"
   az provider register -n "Microsoft.Kubernetes"
   az provider register -n "Microsoft.KubernetesConfiguration"
   az provider register -n "Microsoft.IoTOperationsOrchestrator"
   az provider register -n "Microsoft.IoTOperationsMQ"
   az provider register -n "Microsoft.IoTOperationsDataProcessor"
   az provider register -n "Microsoft.DeviceRegistry"
   

5. Az az group create paranccsal hozzon létre egy erőforráscsoportot az Azure-előfizetésben az összes erőforrás tárolásához:

   az group create --location $LOCATION --resource-group $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID
   

6. Használja az az connectedk8s connect parancsot az Arc-kompatibilis Kubernetes-fürthöz, és kezelje azt az Azure-erőforráscsoport részeként:

   az connectedk8s connect -n $CLUSTER_NAME -l $LOCATION -g $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID
   

7. Szerezze be az objectId Azure Arc szolgáltatás által használt Microsoft Entra ID-alkalmazást, és mentse környezeti változóként.

   export OBJECT_ID=$(az ad sp show --id bc313c14-388c-4e7d-a58e-70017303ee3b --query id -o tsv)
   

8. Az az connectedk8s enable-features paranccsal engedélyezheti az egyéni helytámogatást a fürtön. Ez a parancs az objectId Azure Arc szolgáltatás által használt Microsoft Entra ID alkalmazást használja. Futtassa ezt a parancsot azon a gépen, amelyen üzembe helyezte a Kubernetes-fürtöt:

   az connectedk8s enable-features -n $CLUSTER_NAME -g $RESOURCE_GROUP --custom-locations-oid $OBJECT_ID --features cluster-connect custom-locations
   

Kódterek

Fürt csatlakoztatása az Azure Archoz:

1. A kódtér termináljában jelentkezzen be az Azure CLI-be:

   az login
   

   Tipp.

   Ha a VS Code desktop helyett böngészőben használja a GitHub-kódtérkörnyezetet, a futtatás az login localhost-hibát ad vissza. A hiba kijavításához a következőt kell tenni:

   • Nyissa meg a kódteret az asztali VS Code-ban, majd térjen vissza a böngésző termináljába, és futtassa az loginújra.
   • Vagy miután a localhost hibát kapta a böngészőben, másolja ki az URL-címet a böngészőből, és futtassa curl "<URL>" egy új terminállapon. JSON-választ kell látnia a következő üzenettel: "Bejelentkezett a Microsoft Azure-ba!".

2. Az Azure-előfizetés környezetének beállítása az összes parancshoz:

   az account set -s $SUBSCRIPTION_ID
   

3. Regisztrálja a szükséges erőforrás-szolgáltatókat az előfizetésében:

   Feljegyzés

   Ezt a lépést előfizetésenként csak egyszer kell futtatni.

   az provider register -n "Microsoft.ExtendedLocation"
   az provider register -n "Microsoft.Kubernetes"
   az provider register -n "Microsoft.KubernetesConfiguration"
   az provider register -n "Microsoft.IoTOperationsOrchestrator"
   az provider register -n "Microsoft.IoTOperationsMQ"
   az provider register -n "Microsoft.IoTOperationsDataProcessor"
   az provider register -n "Microsoft.DeviceRegistry"
   

4. Az az group create paranccsal hozzon létre egy erőforráscsoportot az Azure-előfizetésben az összes erőforrás tárolásához:

   az group create --location $LOCATION --resource-group $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID
   

5. Használja az az connectedk8s connect parancsot az Arc-kompatibilis Kubernetes-fürthöz, és kezelje azt az Azure-erőforráscsoport részeként:

   az connectedk8s connect -n $CLUSTER_NAME -l $LOCATION -g $RESOURCE_GROUP --subscription $SUBSCRIPTION_ID
   

   Tipp.

   A kódtér értéke $CLUSTER_NAME automatikusan a kódtér nevére van állítva. Cserélje le a környezeti változót, ha más nevet szeretne használni.

6. Szerezze be az objectId Azure Arc szolgáltatás által használt Microsoft Entra ID-alkalmazást, és mentse környezeti változóként.

   export OBJECT_ID=$(az ad sp show --id bc313c14-388c-4e7d-a58e-70017303ee3b --query id -o tsv)
   

7. Az az connectedk8s enable-features paranccsal engedélyezheti az egyéni helytámogatást a fürtön. Ez a parancs az objectId Azure Arc szolgáltatás által használt Microsoft Entra ID alkalmazást használja.

   az connectedk8s enable-features -n $CLUSTER_NAME -g $RESOURCE_GROUP --custom-locations-oid $OBJECT_ID --features cluster-connect custom-locations
   

A fürt ellenőrzése

Annak ellenőrzéséhez, hogy a fürt készen áll-e az Azure IoT Operations üzembe helyezésére, az Azure CLI-hez készült Azure IoT Operations bővítményben használhatja a verify-host helper parancsot. Amikor a fürt gazdagépén fut, ez a segédparancs ellenőrzi az Azure Resource Manager és a Microsoft Container Registry végpontjaihoz való kapcsolatot.

az iot ops verify-host

Annak ellenőrzéséhez, hogy a Kubernetes-fürt mostantól Azure Arc-kompatibilis-e, futtassa a következő parancsot:

kubectl get deployments,pods -n azure-arc

A kimenet a következő példához hasonlóan néz ki:

NAME                                         READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/clusterconnect-agent         1/1     1            1           10m
deployment.apps/extension-manager            1/1     1            1           10m
deployment.apps/clusteridentityoperator      1/1     1            1           10m
deployment.apps/controller-manager           1/1     1            1           10m
deployment.apps/flux-logs-agent              1/1     1            1           10m
deployment.apps/cluster-metadata-operator    1/1     1            1           10m
deployment.apps/extension-events-collector   1/1     1            1           10m
deployment.apps/config-agent                 1/1     1            1           10m
deployment.apps/kube-aad-proxy               1/1     1            1           10m
deployment.apps/resource-sync-agent          1/1     1            1           10m
deployment.apps/metrics-agent                1/1     1            1           10m

NAME                                              READY   STATUS    RESTARTS        AGE
pod/clusterconnect-agent-5948cdfb4c-vzfst         3/3     Running   0               10m
pod/extension-manager-65b8f7f4cb-tp7pp            3/3     Running   0               10m
pod/clusteridentityoperator-6d64fdb886-p5m25      2/2     Running   0               10m
pod/controller-manager-567c9647db-qkprs           2/2     Running   0               10m
pod/flux-logs-agent-7bf6f4bf8c-mr5df              1/1     Running   0               10m
pod/cluster-metadata-operator-7cc4c554d4-nck9z    2/2     Running   0               10m
pod/extension-events-collector-58dfb78cb5-vxbzq   2/2     Running   0               10m
pod/config-agent-7579f558d9-5jnwq                 2/2     Running   0               10m
pod/kube-aad-proxy-56d9f754d8-9gthm               2/2     Running   0               10m
pod/resource-sync-agent-769bb66b79-z9n46          2/2     Running   0               10m
pod/metrics-agent-6588f97dc-455j8                 2/2     Running   0               10m

Helyek létrehozása

Annak kezeléséhez, hogy az OT-felhasználók mely fürtökhöz férhetnek hozzá, csoportosíthatja a fürtöket webhelyekre. További információ: Mi az Az Azure Arc-webhelykezelő (előzetes verzió)?.

Következő lépések

Most, hogy rendelkezik egy Azure Arc-kompatibilis Kubernetes-fürtel, üzembe helyezheti az Azure IoT Operationst.