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:
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.
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 false
beá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
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
Azure Kubernetes Service