Az Azure Kubernetes Service (AKS) és az Arc-kompatibilis Kubernetes Dapr-bővítményének telepítése

Cikk
01/17/2025

A Dapr leegyszerűsíti a rugalmas, állapot nélküli és állapotalapú alkalmazások létrehozását, amelyek a felhőben és a peremhálózaton futnak, és magukévá teszik a nyelvek és a fejlesztői keretrendszerek sokféleségét. A Dapr oldalkocsis architektúrájával a kódplatformot agnosztikusan használhatja, miközben a mikroszolgáltatások létrehozásával kapcsolatos kihívásokat is megoldhatja, például:

Más szolgáltatások megbízható és biztonságos meghívása
Eseményvezérelt alkalmazások létrehozása pub/sub használatával
Több felhőszolgáltatásban és gazdagépen (például Kubernetes és virtuális gép) hordozható alkalmazások létrehozása

Feljegyzés

Ha a Dapr kubernetes-alapú éles környezetben való telepítését tervezi, tekintse meg az éles használat dokumentációjának Dapr-útmutatóját.

Hogyan működik?

A Dapr-bővítmény az Azure CLI vagy egy Bicep-sablon használatával építi ki a Dapr vezérlősíkot az AKS- vagy Arc-kompatibilis Kubernetes-fürtön, és a következő Dapr-szolgáltatásokat hozza létre:

Dapr szolgáltatás	Leírás
`dapr-operator`	A Dapr összetevőfrissítéseinek és Kubernetes-szolgáltatásvégpontjainak kezelése (állapottárolók, pub/alhálózatok stb.)
`dapr-sidecar-injector`	A Daprt jegyzetekkel ellátott üzembehelyezési podokba injektálja, és hozzáadja a környezeti változókat `DAPR_HTTP_PORT` , és `DAPR_GRPC_PORT` lehetővé teszi, hogy a felhasználó által definiált alkalmazások egyszerűen kommunikálhassanak a Daprvel a Dapr-portértékek kemény kódolása nélkül.
`dapr-placement`	Csak színészekhez használható. Leképezési táblákat hoz létre, amelyek az aktorpéldányokat podokra képezik le.
`dapr-sentry`	Kezeli az mTLS-t a szolgáltatások között, és hitelesítésszolgáltatóként működik. További információkért olvassa el a biztonsági áttekintést.

Miután telepítette a Daprt a fürtre, megkezdheti a fejlesztést a Dapr építőelem-API-kkal , ha hozzáad néhány megjegyzést az üzemelő példányokhoz. Az építőelem-API-k részletesebb áttekintéséért és azok használatának legjobb módjáért tekintse meg a Dapr építőelemeinek áttekintését.

Figyelmeztetés

Ha a Dapr-t az AKS- vagy Arc-kompatibilis Kubernetes-bővítményen keresztül telepíti, javasoljuk, hogy a Dapr parancssori felület helyett továbbra is használja a bővítményt a Dapr jövőbeli felügyeletéhez. A két eszköz kombinálása ütközéseket okozhat, és nem kívánt viselkedést eredményezhet.

Előfeltételek

Azure-előfizetés. Nincs? Hozzon létre egy ingyenes fiókot.
Az Azure CLI legújabb verziója.
Meglévő AKS-fürt vagy csatlakoztatott Arc-kompatibilis Kubernetes-fürt.
Azure Kubernetes Service szerepköralapú hozzáférés-vezérlési rendszergazdai szerepkör

Válassza ki, hogyan szeretné telepíteni, üzembe helyezni és konfigurálni a Dapr-bővítményt.

Azure CLI
Bicep

Mielőtt elkezdené

Az Azure CLI-bővítmény hozzáadása fürtbővítményekhez

Telepítse az k8s-extension Azure CLI-bővítményt az alábbi parancsok futtatásával:

az extension add --name k8s-extension

Ha a k8s-extension bővítmény már telepítve van, az alábbi paranccsal frissítheti a legújabb verzióra:

az extension update --name k8s-extension

Az erőforrás-szolgáltató regisztrálása `KubernetesConfiguration`

Ha még nem használ fürtbővítményeket, előfordulhat, hogy regisztrálnia kell az erőforrás-szolgáltatót az előfizetésében. A szolgáltatóregisztráció állapotát az az szolgáltatólista paranccsal ellenőrizheti, ahogy az alábbi példában is látható:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

A Microsoft.KubernetesConfiguration szolgáltatónak regisztráltként kell jelentenie, ahogyan az alábbi példakimenetben látható:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Ha a szolgáltató nem regisztráltként jelenik meg, regisztrálja a szolgáltatót az az szolgáltatóregisztrálás használatával az alábbi példában látható módon:

az provider register --namespace Microsoft.KubernetesConfiguration

A funkció regisztrálása `ExtenstionTypes` az Azure-előfizetésben

A ExtensionTypes funkciót regisztrálni kell az Azure-előfizetésében. A terminálon ellenőrizze, hogy a megfelelő előfizetésben van-e:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Regisztrálja a ExtenstionTypes funkciót.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

A szolgáltatásregisztráció eltarthat egy ideig. Néhány perc múlva ellenőrizze a regisztrációs állapotot az alábbi paranccsal:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

A bővítmény létrehozása és a Dapr telepítése az AKS- vagy Arc-kompatibilis Kubernetes-fürtön

A Dapr-bővítmény telepítésekor használja a fürttípusnak megfelelő jelzőértéket:

AKS-fürt: --cluster-type managedClusters.
Arc-kompatibilis Kubernetes-fürt: --cluster-type connectedClusters.

Feljegyzés

Ha Dapr OSS-t használ az AKS-fürtön, és telepíteni szeretné az AKS-hez készült Dapr-bővítményt, további információt a Dapr-bővítményre való sikeres migrálásról olvashat.

Hozza létre a Dapr bővítményt, amely telepíti a Dapr-t az AKS- vagy Arc-kompatibilis Kubernetes-fürtön.

Telepítse például a Dapr legújabb verzióját az AKS-fürt Dapr-bővítményén keresztül:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false

A felügyelt AKS-fürt frissítése a legújabb verzióra

A környezet (fejlesztés, tesztelés vagy éles környezet) alapján naprakészen tarthatja a legújabb stabil Dapr-verziókat.

Kiadási vonat kiválasztása

A bővítmény konfigurálásakor dönthet úgy, hogy egy adott kiadási vonatról telepíti a Daprt. Adja meg a két kiadási betanítandó érték egyikét:

Érték	Leírás
`stable`	Default (Alapértelmezett):
`dev`	A kísérleti funkciókat tartalmazó korai kiadások. Nem alkalmas éles környezetben.

Példa:

--release-train stable

A Dapr vezérlősík automatikus frissítésének konfigurálása

Figyelmeztetés

Az automatikus frissítés éles környezetekhez nem megfelelő. Csak fejlesztői vagy tesztelési környezetekben engedélyezze a Dapr vezérlősík automatikus frissítéseit. Megtudhatja, hogyan frissíthet manuálisan az éles környezetek legújabb Dapr-verziójára.

Ha verzió megadása nélkül telepíti a Daprt, --auto-upgrade-minor-version az automatikusan engedélyezve van, a Dapr vezérlősíkjának konfigurálásával automatikusan frissítheti az alverziót az új kiadásokon.

Az automatikus frissítést letilthatja a --auto-upgrade-minor-version paraméter megadásával és az érték falsebeállításával.

A Dapr verziószámozása formátumaMAJOR.MINOR.PATCH, ami azt jelenti1.11.0, hogy 1.12.0 egy alverziófrissítés.

--auto-upgrade-minor-version true

Az elérhető legújabb stabil Dapr-verziók megtekintése

Ha éles környezetben a legújabb Dapr-verzióra szeretne frissíteni, manuálisan kell frissítenie. Első lépésként tekintse meg a felügyelt AKS-fürt számára elérhető stabil Dapr-verziók listáját. Futtassa az alábbi parancsot:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

A felügyelt AKS-fürt számára elérhető legújabb stabil Dapr-verzió megtekintéséhez futtassa a következő parancsot:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

A hely szerint elérhető stabil Dapr-verziók listájának megtekintéséhez:

Győződjön meg arról, hogy regisztrálta a funkciót az ExtenstionTypes Azure-előfizetésében.
Futtassa az alábbi parancsot.

az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr

Ezután manuálisan frissítse a Daprt a legújabb stabil verzióra.

Egy adott Dapr-verzió megcélzása

Feljegyzés

A Daprt egy gördülő ablak támogatja, beleértve csak az aktuális és az előző verziókat. Az Ön üzemeltetési felelőssége, hogy naprakész maradjon ezekkel a támogatott verziókkal. Ha a Dapr régebbi verziójával rendelkezik, előfordulhat, hogy köztes frissítéseket kell végrehajtania a támogatott verzió eléréséhez.

Ugyanezt a parancssori argumentumot használja a Dapr egy adott verziójának telepítéséhez vagy az előző verzióra való visszagördüléshez. false --version Állítsa be --auto-upgrade-minor-version és állítsa be a telepíteni kívánt Dapr-verziót. Ha a version paraméter nincs megadva, a bővítmény telepíti a Dapr legújabb verzióját. Például a Dapr 1.13.5 használata:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.13.5

Mielőtt elkezdené

Az erőforrás-szolgáltató regisztrálása `KubernetesConfiguration`

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

A Microsoft.KubernetesConfiguration szolgáltatónak regisztráltként kell jelentenie, ahogyan az alábbi példakimenetben látható:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Ha a szolgáltató nem regisztráltként jelenik meg, regisztrálja a szolgáltatót az az szolgáltatóregisztrálás használatával az alábbi példában látható módon:

az provider register --namespace Microsoft.KubernetesConfiguration

A funkció regisztrálása `ExtenstionTypes` az Azure-előfizetésben

A ExtensionTypes funkciót regisztrálni kell az Azure-előfizetésében. A terminálon ellenőrizze, hogy a megfelelő előfizetésben van-e:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Regisztrálja a ExtenstionTypes funkciót.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

A szolgáltatásregisztráció eltarthat egy ideig. Néhány perc múlva ellenőrizze a regisztrációs állapotot az alábbi paranccsal:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

A Dapr-bővítmény üzembe helyezése az AKS- vagy Arc-kompatibilis Kubernetes-fürtön

Az alábbi példához hasonló Bicep-sablon létrehozása és a Dapr-bővítmény üzembe helyezése a meglévő fürtön.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedClusters 'Microsoft.ContainerService/managedClusters@2023-05-02-preview' existing = {
  name: clusterName
}

resource daprExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'dapr'
  scope: existingManagedClusters
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    autoUpgradeMinorVersion: true
    configurationProtectedSettings: {}
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.dapr'
    releaseTrain: 'stable'
    scope: {
      cluster: {
        releaseNamespace: 'dapr-system'
      }
    }
    version: '1.11.2'
  }
}

Állítsa be a következő változókat, és módosítsa az alábbi értékeket a tényleges erőforráscsoportra és fürtnevekre.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Telepítse a Bicep-sablont a az deployment group paranccsal.

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

A Dapr vezérlősík automatikus frissítésének konfigurálása

Figyelmeztetés

A Dapr vezérlősík automatikus frissítéseit csak fejlesztői vagy tesztelési környezetekben engedélyezheti. Az automatikus frissítés éles környezetekhez nem megfelelő.

Ha verzió megadása nélkül telepíti a Daprt, autoUpgradeMinorVersion az automatikusan engedélyezve van, a Dapr vezérlősíkjának konfigurálásával automatikusan frissítheti az alverziót az új kiadásokon.

Az automatikus frissítést letilthatja a autoUpgradeMinorVersion paraméter megadásával és az érték falsebeállításával.

A Dapr verziószámozása formátumaMAJOR.MINOR.PATCH, ami azt jelenti1.11.0, hogy 1.12.0 egy alverziófrissítés.

properties {
  autoUpgradeMinorVersion: true
}

Egy adott Dapr-verzió megcélzása

Feljegyzés

false version Állítsa be autoUpgradeMinorVersion és állítsa be a telepíteni kívánt Dapr-verziót. Ha a autoUpgradeMinorVersion paraméter értéke true, és version a paraméter nincs megadva, a bővítmény telepíti a Dapr legújabb verzióját.

Például a Dapr 1.11.2 használata:

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

Kiadási vonat kiválasztása

A bővítmény konfigurálásakor dönthet úgy, hogy egy adott kiadási vonatról telepíti a Daprt. Adja meg a két kiadási betanítandó érték egyikét:

Érték	Leírás
`stable`	Default (Alapértelmezett):
`dev`	A kísérleti funkciókat tartalmazó korai kiadások. Nem alkalmas éles környezetben.

Példa:

properties: {
  releaseTrain: 'stable'
}

Bővítményhibák elhárítása

Ha a bővítmény létrehozása vagy frissítése sikertelen, próbálkozzon javaslatokkal és megoldásokkal a Dapr bővítmény hibaelhárítási útmutatójában.

A Dapr hibaelhárítása

A Dapr hibáinak elhárítása a Dapr gyakori problémáiról és megoldási útmutatójából.

A Dapr-bővítmény törlése a fürtből

A Dapr-bővítmény AKS-ből való eltávolításának folyamata nem törli a telepítés során létrehozott CRD-ket. Ezek a CRD-k reziduális összetevőkként maradnak a fürtben, amelyek a bővítmény telepítése és eltávolítása során elengedhetetlenek a kibékítőhöz.

Ezeknek a CRD-knek a fürtjének megtisztításához manuálisan törölheti őket , miután a Dapr bővítményt teljesen eltávolították az AKS-ből.

A bővítmény eltávolítása

Törölje a bővítményt az AKS-fürtből az alábbi paranccsal:

az k8s-extension delete --resource-group <myResourceGroup> --cluster-name <myAKSCluster> --cluster-type managedClusters --name dapr

Vagy Bicep-sablon használata esetén törölheti a sablont.

A fürt CRD-jeinek listázása

Az eltávolítani kívánt CRD-k megkereséséhez futtassa a következő parancsot:

kubectl get crds | findstr dapr.io

Következő lépések

A Dapr-bővítmény konfigurálása az egyedi forgatókönyvhöz

Megosztás a következőn keresztül:

Az Azure Kubernetes Service (AKS) és az Arc-kompatibilis Kubernetes Dapr-bővítményének telepítése

Hogyan működik?

Előfeltételek

Mielőtt elkezdené

Az Azure CLI-bővítmény hozzáadása fürtbővítményekhez

Az erőforrás-szolgáltató regisztrálása `KubernetesConfiguration`

A funkció regisztrálása `ExtenstionTypes` az Azure-előfizetésben

A bővítmény létrehozása és a Dapr telepítése az AKS- vagy Arc-kompatibilis Kubernetes-fürtön

A felügyelt AKS-fürt frissítése a legújabb verzióra

Kiadási vonat kiválasztása

A Dapr vezérlősík automatikus frissítésének konfigurálása

Az elérhető legújabb stabil Dapr-verziók megtekintése

Egy adott Dapr-verzió megcélzása

Mielőtt elkezdené

Az erőforrás-szolgáltató regisztrálása `KubernetesConfiguration`

A funkció regisztrálása `ExtenstionTypes` az Azure-előfizetésben

A Dapr-bővítmény üzembe helyezése az AKS- vagy Arc-kompatibilis Kubernetes-fürtön

A Dapr vezérlősík automatikus frissítésének konfigurálása

Egy adott Dapr-verzió megcélzása

Kiadási vonat kiválasztása

Bővítményhibák elhárítása

A Dapr hibaelhárítása

A Dapr-bővítmény törlése a fürtből

A bővítmény eltávolítása

A fürt CRD-jeinek listázása

Következő lépések

További források

Megosztás a következőn keresztül:

Az Azure Kubernetes Service (AKS) és az Arc-kompatibilis Kubernetes Dapr-bővítményének telepítése

Hogyan működik?

Előfeltételek

Mielőtt elkezdené

Az Azure CLI-bővítmény hozzáadása fürtbővítményekhez

Az erőforrás-szolgáltató regisztrálása KubernetesConfiguration

A funkció regisztrálása ExtenstionTypes az Azure-előfizetésben

A bővítmény létrehozása és a Dapr telepítése az AKS- vagy Arc-kompatibilis Kubernetes-fürtön

A felügyelt AKS-fürt frissítése a legújabb verzióra

Kiadási vonat kiválasztása

A Dapr vezérlősík automatikus frissítésének konfigurálása

Az elérhető legújabb stabil Dapr-verziók megtekintése

Egy adott Dapr-verzió megcélzása

Bővítményhibák elhárítása

A Dapr hibaelhárítása

A Dapr-bővítmény törlése a fürtből

A bővítmény eltávolítása

A fürt CRD-jeinek listázása

Következő lépések

További források

Az erőforrás-szolgáltató regisztrálása `KubernetesConfiguration`

A funkció regisztrálása `ExtenstionTypes` az Azure-előfizetésben