Megosztás a következőn keresztül:

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ésekhez és konfigurációkhoz kapcsolódó 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ényeket.

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

  • Microsoft.KubernetesConfiguration Az Microsoft.ContainerService és 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 felügyelt identitással az aks createlétrehozott új fürtök esetében a rendszer alapértelmezés szerint konfigurálja a felügyelt identitást. Meglévő szolgáltatásnév-alapú fürtök esetén váltson az identitás kezelésére a --enable-managed-identity jelölővel való futtatássalaz aks update. 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 kötelező paraméterek értékeinek átadásával k8s-extension create. 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

Feljegyzé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 kell futnia 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 a bővítménypéldányt létre kell hozni
--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íthat be version paramétert, mivel a verzió dinamikusan frissül. Ha be van falseállítva, a bővítmény nem frissül automatikusan még a javításverziók esetében sem.
--version A telepíteni kívánt bővítmény verziója (a bővítménypéldány rögzítéséhez megadott verzió). Nem adható meg, ha az automatikus frissítés alverziója be van állítva true.
--configuration-settings A bővítménynek átadható beállítások a funkció szabályozásához. 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 parancs, akkor --configuration-settings-file nem használható ugyanabban a parancsban.
--configuration-settings-file Annak a JSON-fájlnak az elérési útja, amely kulcsértékpárokkal rendelkezik a konfigurációs beállítások bővítményhez való továbbításához. Ha ezt a paramétert használja a parancs, akkor --configuration-settings nem használható ugyanabban a parancsban.
--configuration-protected-settings Ezek a beállítások api-hívások vagy az k8s-extension show parancsok használatával GET nem kérhetők le, ezért bizalmas beállítások megadá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 parancs, akkor --configuration-protected-settings-file nem használható ugyanabban a parancsban.
--configuration-protected-settings-file Annak a JSON-fájlnak az elérési útja, amely kulcsértékpárokkal rendelkezik a bővítmény bizalmas beállításainak átadásához. Ha ezt a paramétert használja a parancs, 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 kell 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és szerint használja. Ez a paraméter nem használható a paraméter beállításakor --auto-upgrade-minor-version 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 az 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 az 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 az Azure Portal Marketplace lapjá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 kötelező paraméterek értékeit.

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

A fürtre 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 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

Feljegyzés

Az adott bővítménytípus dokumentációjában megismerheti az adott beállításokat --configuration-settings , és --configuration-protected-settings frissíthető. Az --configuration-protected-settingsösszes beállítás várhatóan meg lesz adva, még akkor is, ha csak egy beállítás van frissítve. Ha ezek közül a beállítások közül bármelyik hiányzik, a rendszer elavultnak és töröltnek tekinti ezeket a beállításokat.

Meglévő bővítménypéldány frissítéséhez használja k8s-extension updatea 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 a bővítménypéldányt létre kell hozni
--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ást frissít, 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 az 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 az 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 az Azure Portal Marketplace lapjá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 be van falseállítva, a bővítmény nem frissül automatikusan még a javításverziók esetében sem.
--version A telepíteni kívánt bővítmény verziója (a bővítménypéldány rögzítéséhez megadott verzió). Nem adható meg, ha az automatikus frissítés alverziója be van állítva true.
--configuration-settings A bővítménynek átadható beállítások a funkció szabályozásához. 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 parancs, akkor --configuration-settings-file nem használható ugyanabban a parancsban.
--configuration-settings-file Annak a JSON-fájlnak az elérési útja, amely kulcsértékpárokkal rendelkezik a konfigurációs beállítások bővítményhez való továbbításához. Ha ezt a paramétert használja a parancs, akkor --configuration-settings nem használható ugyanabban a parancsban.
--configuration-protected-settings Ezek a beállítások api-hívások vagy az k8s-extension show parancsok használatával GET nem kérhetők le, ezért bizalmas beállítások megadására szolgálnak. Amikor frissít egy beállítást, a rendszer minden beállítást meg fog adni. Ha bizonyos beállításokat kihagy, ezek a beállítások elavultnak és töröltnek minősülnek. 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 parancs, akkor --configuration-protected-settings-file nem használható ugyanabban a parancsban.
--configuration-protected-settings-file Annak a JSON-fájlnak az elérési útja, amely kulcsértékpárokkal rendelkezik a bővítmény bizalmas beállításainak átadásához. Ha ezt a paramétert használja a parancs, 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és szerint használja. Ez a paraméter nem használható a paraméter beállításakor autoUpgradeMinorVersion false.

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

Egy fürt bővítménypéldányának törléséhez használja k8s-extension-deletea kötelező paraméterek értékeit.

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

Feljegyzé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 elérhetik az Azure-szolgáltatásokat a kívánt állapot lekéréséhez.

Következő lépések

  • Tekintse meg a jelenleg elérhető fürtbővítmények listáját.
  • Ismerje meg a Marketplace-en keresztül elérhető Kubernetes-alkalmazásokat.