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

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

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

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:

  1. Győződjön meg arról, hogy regisztrálta a funkciót az ExtenstionTypes Azure-előfizetésében.
  2. 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

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