Fürtbővítmények üzembe helyezése és kezelése az Azure CLI használatával

  • Cikk

Bővítménypéldányokat hozhat létre egy AKS-fürtben, megadhatja a szükséges és választható paramétereket, beleértve a frissítésekkel és konfigurációkkal kapcsolatos beállításokat is. Bővítménypéldányokat is megtekinthet, listázhat, frissíthet és törölhet.

Mielőtt hozzákezdene, olvassa el a fürtbővítményekről szóló cikket.

Megjegyzés

A cikkben szereplő példák nem teljesek, és csak a funkciók bemutatására szolgálnak. A parancsok és paramétereik átfogó listáját az az k8s-extension CLI-referencia tartalmazza.

Előfeltételek

  • Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, létrehozhat egy ingyenes fiókot.

  • A Microsoft.ContainerService és Microsoft.KubernetesConfiguration az erőforrás-szolgáltatókat regisztrálni kell az előfizetésben. A szolgáltatók regisztrálásához futtassa a következő parancsot:

    az provider register --namespace Microsoft.ContainerService --wait 
az provider register --namespace Microsoft.KubernetesConfiguration --wait

  • Egy AKS-fürt. Ezt a fürtöt felügyelt identitással kell létrehozni, mivel a fürtbővítmények nem működnek egyszerű szolgáltatásalapú fürtökkel. A használatával az aks createlétrehozott új fürtök esetében a felügyelt identitás alapértelmezés szerint konfigurálva van. Meglévő szolgáltatásnév-alapú fürtök esetén váltson az identitás az aks update kezelésére a --enable-managed-identity jelölő futtatásával. További információ: Felügyelt identitás használata.

  • Azure CLI-verzió>= 2.16.0 telepítve. Javasoljuk, hogy a legújabb verziót használja.

  • Az Azure CLI-bővítmények legújabb verziója k8s-extension . Telepítse a bővítményt a következő parancs futtatásával:

    az extension add --name k8s-extension

    Ha a bővítmény már telepítve van, győződjön meg arról, hogy a legújabb verziót futtatja az alábbi paranccsal:

    az extension update --name k8s-extension

Bővítménypéldány létrehozása

Hozzon létre egy új bővítménypéldányt a paranccsal k8s-extension create, és adja meg a kötelező paraméterek értékeit. Ez a példaparancs létrehoz egy Azure Machine Learning-bővítménypéldányt az AKS-fürtön:

az k8s-extension create --name azureml --extension-type Microsoft.AzureML.Kubernetes --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters --configuration-settings enableInference=True allowInsecureConnections=True inferenceRouterServiceType=LoadBalancer

Ez a példaparancs létrehoz egy minta Kubernetes-alkalmazást (közzétéve a Marketplace-en) az AKS-fürtön:

az k8s-extension create --name voteapp --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters --plan-name testPlanID --plan-product testOfferID --plan-publisher testPublisherID --configuration-settings title=VoteAnimal value1=Cats value2=Dogs

Megjegyzés

A Fürtbővítmények szolgáltatás nem tudja 48 óránál tovább megőrizni a bizalmas adatokat. Ha a fürtbővítmény-ügynökök 48 óránál hosszabb ideig nem rendelkeznek hálózati kapcsolattal, és nem tudják meghatározni, hogy szeretne-e bővítményt létrehozni a fürtön, akkor a bővítmény állapotra Failed vált. Ha állapotban Failed van, újra futtatnia kell a parancsot k8s-extension create egy új bővítménypéldány létrehozásához.

Kötelező paraméterek

Paraméter neve Leírás
--name A bővítménypéldány neve
--extension-type A fürtre telepíteni kívánt bővítmény típusa. Például: Microsoft.AzureML.Kubernetes
--cluster-name Annak az AKS-fürtnek a neve, amelyen létre kell hozni a bővítménypéldányt
--resource-group Az AKS-fürtöt tartalmazó erőforráscsoport
--cluster-type Az a fürttípus, amelyen létre kell hozni a bővítménypéldányt. Adja meg managedClusters az AKS-fürtökre való leképezést

Választható paraméterek

Paraméter neve Leírás
--auto-upgrade-minor-version Logikai tulajdonság, amely meghatározza, hogy a bővítmény alverziója automatikusan frissül-e. Alapértelmezett: true. Ha ez a paraméter igaz értékre van állítva, nem állíthatja be version a paramétert, mivel a verzió dinamikusan frissül. Ha a értékre van állítva, falsea bővítmény még a javításverziók esetében sem frissül automatikusan.
--version A telepíteni kívánt bővítmény verziója (a bővítménypéldány rögzítésére szolgáló adott verzió). Nem adható meg, ha az automatikus frissítés alverziója értékre truevan állítva.
--configuration-settings A bővítménybe a funkció szabályozásához adható beállítások. Adja át az értékeket szóközzel elválasztott key=value párként a paraméter neve után. Ha ezt a paramétert használja a parancsban, akkor --configuration-settings-file nem használható ugyanabban a parancsban.
--configuration-settings-file A JSON-fájl elérési útja kulcsértékpárokkal, amelyeket a konfigurációs beállítások bővítménynek való átadásához kell használni. Ha ezt a paramétert használja a parancsban, akkor --configuration-settings nem használható ugyanabban a parancsban.
--configuration-protected-settings Ezek a beállítások nem kérhetők GET le API-hívásokkal vagy az k8s-extension show parancsokkal, így bizalmas beállítások átadására szolgálnak. Adja át az értékeket szóközzel elválasztott key=value párként a paraméter neve után. Ha ezt a paramétert használja a parancsban, akkor --configuration-protected-settings-file nem használható ugyanabban a parancsban.
--configuration-protected-settings-file A JSON-fájl elérési útja kulcsértékpárokkal, amelyeket a bizalmas beállítások bővítménynek való átadásához kell használni. Ha ezt a paramétert használja a parancsban, akkor --configuration-protected-settings nem használható ugyanabban a parancsban.
--scope A bővítmény telepítésének hatóköre – cluster vagy namespace
--release-namespace Ez a paraméter azt a névteret jelzi, amelyen belül létre kívánja hozni a kiadást. Ez a paraméter csak akkor releváns, ha scope a paraméter értéke cluster.
--release-train A bővítményszerzők különböző kiadási vonatokon, például Stable, Previewstb. tehetnek közzé verziókat. Ha ez a paraméter nincs explicit módon beállítva, Stable akkor a rendszer alapértelmezésként használja. Ez a paraméter nem használható, ha --auto-upgrade-minor-version a paraméter értéke false.
--target-namespace Ez a paraméter azt a névteret jelzi, amelyen belül a kiadás létrejön. A bővítménypéldányhoz létrehozott rendszerfiók engedélye erre a névtérre lesz korlátozva. Ez a paraméter csak akkor releváns, ha a scope paraméter értéke namespace.
--plan-name A bővítmény csomagazonosítója, amely a Azure Portal Marketplace oldalán, a Használati adatok + támogatás területen található.
--plan-product A bővítmény termékazonosítója, amely a Azure Portal Marketplace oldalán, a Használati adatok + támogatás területen található. Erre példa a használt ISV-ajánlat neve.
--plan-publisher A bővítmény közzétevői azonosítója, amely a Azure Portal Marketplace oldalán, a Használati adatok + támogatás területen található.

Bővítménypéldány részleteinek megjelenítése

Egy jelenleg telepített bővítménypéldány részleteinek megtekintéséhez használja k8s-extension showa parancsot, és adja meg a kötelező paraméterek értékeit.

az k8s-extension show --name azureml --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

A fürtön telepített összes bővítmény listázása

A fürtön telepített összes bővítmény listázásához használja k8s-extension lista parancsot, és adja meg a kötelező paraméterek értékeit.

az k8s-extension list --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Bővítménypéldány frissítése

Megjegyzés

Az adott bővítménytípus dokumentációjában --configuration-settings--configuration-protected-settings megismerheti az adott és frissíthető beállításokat. A esetében --configuration-protected-settingsaz összes beállítást meg kell adni, még akkor is, ha csak egy beállítás van frissítve. Ha ezen beállítások bármelyikét kihagyja, ezek a beállítások elavultnak minősülnek, és törlődnek.

Meglévő bővítménypéldány frissítéséhez használja k8s-extension updatea parancsot, és adja meg a kötelező paraméterek értékeit. Az alábbi parancs frissíti egy Azure Machine Learning-bővítménypéldány automatikus frissítési beállítását:

az k8s-extension update --name azureml --extension-type Microsoft.AzureML.Kubernetes --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

A frissítéshez szükséges paraméterek

Paraméter neve Leírás
--name A bővítménypéldány neve
--extension-type A fürtre telepíteni kívánt bővítmény típusa. Például: Microsoft.AzureML.Kubernetes
--cluster-name Annak az AKS-fürtnek a neve, amelyen létre kell hozni a bővítménypéldányt
--resource-group Az AKS-fürtöt tartalmazó erőforráscsoport
--cluster-type Az a fürttípus, amelyen létre kell hozni a bővítménypéldányt. Adja meg managedClusters az AKS-fürtökre való leképezést

Ha a Marketplace-en keresztül beszerzett Kubernetes-alkalmazás frissítése folyamatban van, a következő paraméterekre is szükség van:

Paraméter neve Leírás
--plan-name A bővítmény csomagazonosítója, amely a Azure Portal Marketplace oldalán, a Használati adatok + támogatás területen található.
--plan-product A bővítmény termékazonosítója, amely a Azure Portal Marketplace oldalán, a Használati adatok + támogatás területen található. Erre példa a használt ISV-ajánlat neve.
--plan-publisher A bővítmény közzétevői azonosítója, amely a Azure Portal Marketplace oldalán, a Használati adatok + támogatás területen található.

Nem kötelező paraméterek a frissítéshez

Paraméter neve Leírás
--auto-upgrade-minor-version Logikai tulajdonság, amely meghatározza, hogy a bővítmény alverziója automatikusan frissül-e. Alapértelmezett: true. Ha ez a paraméter igaz értékre van állítva, nem állíthatja be version a paramétert, mivel a verzió dinamikusan frissül. Ha a értékre van állítva, falsea bővítmény még a javításverziók esetében sem frissül automatikusan.
--version A telepíteni kívánt bővítmény verziója (a bővítménypéldány rögzítésére szolgáló adott verzió). Nem adható meg, ha az automatikus frissítés alverziója értékre truevan állítva.
--configuration-settings A bővítménybe a funkció szabályozásához adható beállítások. Csak a frissítést igénylő beállításokat kell megadni. A megadott beállításokat a megadott értékek váltják fel. Adja át az értékeket szóközzel elválasztott key=value párként a paraméter neve után. Ha ezt a paramétert használja a parancsban, akkor --configuration-settings-file nem használható ugyanabban a parancsban.
--configuration-settings-file A JSON-fájl elérési útja kulcsértékpárokkal, amelyeket a konfigurációs beállítások bővítménynek való átadásához kell használni. Ha ezt a paramétert használja a parancsban, akkor --configuration-settings nem használható ugyanabban a parancsban.
--configuration-protected-settings Ezek a beállítások nem kérhetők GET le API-hívásokkal vagy az k8s-extension show parancsokkal, így bizalmas beállítások átadására szolgálnak. Amikor frissít egy beállítást, a rendszer minden beállítást meg fog adni. Ha egyes beállítások nincsenek megadva, a rendszer elavultnak és töröltnek tekinti ezeket a beállításokat. Adja át az értékeket szóközzel elválasztott key=value párként a paraméter neve után. Ha ezt a paramétert használja a parancsban, akkor --configuration-protected-settings-file nem használható ugyanabban a parancsban.
--configuration-protected-settings-file A JSON-fájl elérési útja kulcsértékpárokkal, amelyeket a bizalmas beállítások bővítménynek való átadásához kell használni. Ha ezt a paramétert használja a parancsban, akkor --configuration-protected-settings nem használható ugyanabban a parancsban.
--scope A bővítmény telepítésének hatóköre – cluster vagy namespace
--release-train A bővítményszerzők különböző kiadási vonatokon, például Stable, Previewstb. tehetnek közzé verziókat. Ha ez a paraméter nincs explicit módon beállítva, Stable akkor a rendszer alapértelmezésként használja. Ez a paraméter nem használható, ha autoUpgradeMinorVersion a paraméter értéke false.

Bővítménypéldány törlése

Ha törölni szeretne egy bővítménypéldányt egy fürtön, használja a parancsot k8s-extension-delete, és adja meg a kötelező paraméterek értékeit.

az k8s-extension delete --name azureml --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Megjegyzés

A bővítményt képviselő Azure-erőforrás azonnal törlődik. A bővítményhez társított fürt Helm-kiadása csak akkor törlődik, ha a Kubernetes-fürtön futó ügynökök hálózati kapcsolattal rendelkeznek, és újra kapcsolatba lépnek az Azure-szolgáltatásokkal a kívánt állapot lekéréséhez.

Következő lépések