Dapr-bővítmény az Azure Kubernetes Service -hez (AKS) és az Arc-kompatibilis Kuberneteshez

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.
• Telepítse az Azure CLI legújabb verzióját.
• Ha még nincs ilyenje, létre kell hoznia egy AKS-fürtöt , vagy össze kell kapcsolnia egy Arc-kompatibilis Kubernetes-fürtöt.
• Győződjön meg arról, hogy rendelkezik Azure Kubernetes Service RBAC Rendszergazda szerepkörsel

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

Azure CLI

Az Azure CLI-bővítmény beállítá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 korábban még nem használt 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 provider list][az-provider-list] paranccsal ellenőrizheti az alábbi példában látható módon:

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 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 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, --auto-upgrade-minor-versionaz 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

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.11.2 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.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 korai kiadások tartalmazhatnak kísérleti funkciókat. Nem alkalmas éles környezetben.

Példa:

--release-train stable

Bicep

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

Ha korábban még nem használt 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 provider list][az-provider-list] paranccsal ellenőrizheti az alábbi példában látható módon:

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 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 a Dapr-bővítmény meglévő fürtben való üzembe helyezéséhez.

@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áscsoport- é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, autoUpgradeMinorVersionaz 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

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.

falseversion Á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 korai kiadások tartalmazhatnak kísérleti funkciókat. 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 bővítmény törlése

Ha törölnie kell a bővítményt, és el kell távolítania a Dapr-t az AKS-fürtből, a következő parancsot használhatja:

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

Vagy egyszerűen távolítsa el a Bicep-sablont.

Következő lépések

• További információ a Dapr bővítményen beállítható további beállításokról és beállításokról.
• Miután sikeresen kiépítette a Daprt az AKS-fürtben, próbáljon meg üzembe helyezni egy mintaalkalmazást.
• A Dapr Workflow kipróbálása az AKS-hez készült Dapr-bővítményen