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

A Dapr bővítmény használata a Dapr AKS- vagy Arc-kompatibilis Kubernetes-fürtön való kiépítéséhez kiküszöböli a következő többletterhelést:

  • A Dapr eszközkészlet letöltése
  • A futtatókörnyezet manuális telepítése és kezelése az AKS-fürtön

Emellett a bővítmény egyszerű parancssori argumentumokkal támogatja az összes natív Dapr-konfigurációs képességet.

Megjegyzé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.

How it works

A Dapr-bővítmény az Azure CLI 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.

Jelenleg támogatott

Dapr-verziók

A Dapr bővítmény támogatása a futtatókörnyezet kezelésétől függően változik.

Önkiszolgáló
Ön által felügyelt futtatókörnyezet esetén a Dapr bővítmény a következőket támogatja:

Az önkiszolgáló futtatókörnyezethez manuális frissítés szükséges, hogy a támogatási ablakban maradjon. A Dapr bővítményen keresztüli frissítéséhez kövesse az Update bővítménypéldány utasításait.

Automatikus frissítés
Az automatikus frissítés engedélyezése a Dapr-bővítményt a legújabb alverzióra frissíti. A frissítések közötti kompatibilitástörő változásokat tapasztalhat.

Összetevők

Az Azure + nyílt forráskód-összetevők támogatottak. Az alfa- és bétakomponenseket a legjobb erőfeszítéssel támogatjuk.

Felhők/régiók

A globális Azure-felhő arc-támogatással támogatott a következő régiókban:

Region AKS-támogatás Arc for Kubernetes-támogatás
australiaeast ✔️ ✔️
australiasoutheast ✔️
brazilsouth ✔️
canadacentral ✔️ ✔️
canadaeast ✔️ ✔️
centralindia ✔️ ✔️
centralus ✔️ ✔️
eastasia ✔️ ✔️
eastus ✔️ ✔️
eastus2 ✔️ ✔️
eastus2euap ✔️
francecentral ✔️ ✔️
francesouth ✔️
germanywestcentral ✔️ ✔️
japaneast ✔️ ✔️
japanwest ✔️
koreacentral ✔️ ✔️
koreasouth ✔️
northcentralus ✔️ ✔️
northeurope ✔️ ✔️
norwayeast ✔️
southafricanorth ✔️
southcentralus ✔️ ✔️
southeastasia ✔️ ✔️
southindia ✔️
swedencentral ✔️ ✔️
switzerlandnorth ✔️ ✔️
uaenorth ✔️
uksouth ✔️ ✔️
ukwest ✔️
westcentralus ✔️ ✔️
westeurope ✔️ ✔️
westus ✔️ ✔️
westus2 ✔️ ✔️
westus3 ✔️ ✔️

Előfeltételek

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

A 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 a 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.

Megjegyzé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

Egy adott Dapr-verzió megcélzása

Megjegyzé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 X.X.X 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 X.X.X

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

Kiadási vonat kiválasztása

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

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

Például:

--release-train 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

Következő lépések