Sdílet prostřednictvím

Nasazení a správa rozšíření clusteru pomocí Azure CLI

  • Článek

V clusteru AKS můžete vytvářet instance rozšíření, nastavit požadované a volitelné parametry, včetně možností souvisejících s aktualizacemi a konfiguracemi. Můžete také zobrazit, zobrazit, zobrazit, aktualizovat a odstranit instance rozšíření.

Než začnete, přečtěte si o rozšířeních clusteru.

Poznámka:

Příklady uvedené v tomto článku nejsou úplné a jsou určené pouze k prezentaci funkcí. Úplný seznam příkazů a jejich parametrů najdete v referenčních informacích k rozhraní příkazového řádku az k8s-extension.

Požadavky

  • Předplatné Azure. Pokud ještě nemáte předplatné Azure, můžete si vytvořit bezplatný účet.

  • Poskytovatelé Microsoft.ContainerService prostředků a Microsoft.KubernetesConfiguration poskytovatelé prostředků musí být zaregistrovaní ve vašem předplatném. Pokud chcete zaregistrovat tyto poskytovatele, spusťte následující příkaz:

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

  • Cluster AKS. Tento cluster se musí vytvořit se spravovanou identitou, protože rozšíření clusteru nebudou fungovat s clustery založenými na instančním objektu. U nových clusterů vytvořených pomocí az aks createspravované identity je ve výchozím nastavení nakonfigurovaná spravovaná identita. U existujících clusterů založených na instančním objektu přepněte na správu identity spuštěním az aks update příznaku --enable-managed-identity . Další informace najdete v tématu Použití spravované identity.

  • Nainstalovaná verze >Azure CLI = 2.16.0. Doporučujeme používat nejnovější verzi.

  • Nejnovější verze k8s-extension rozšíření Azure CLI. Nainstalujte rozšíření spuštěním následujícího příkazu:

    az extension add --name k8s-extension

    Pokud už je rozšíření nainstalované, pomocí následujícího příkazu se ujistěte, že používáte nejnovější verzi:

    az extension update --name k8s-extension

Vytvoření instance rozšíření

Vytvořte novou instanci rozšíření s předáváním k8s-extension createhodnot pro povinné parametry. Tento ukázkový příkaz vytvoří instanci rozšíření Azure Machine Learning ve vašem clusteru AKS:

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

Tento ukázkový příkaz vytvoří ukázkovou aplikaci Kubernetes (publikovanou na Marketplace) ve vašem clusteru AKS:

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

Poznámka:

Služba Rozšíření clusteru nemůže uchovávat citlivé informace po dobu delší než 48 hodin. Pokud agenti rozšíření clusteru nemají připojení k síti déle než 48 hodin a nemůžou určit, jestli se má v clusteru vytvořit rozšíření, pak rozšíření přejde do Failed stavu. Jakmile budete ve Failed stavu, budete muset znovu spustit k8s-extension create , abyste vytvořili novou instanci rozšíření.

Povinné parametry

Název parametru Popis
--name Název instance rozšíření
--extension-type Typ rozšíření, které chcete nainstalovat do clusteru. Příklad: Microsoft.AzureML.Kubernetes
--cluster-name Název clusteru AKS, na kterém se má instance rozšíření vytvořit
--resource-group Skupina prostředků obsahující cluster AKS
--cluster-type Typ clusteru, na kterém se má instance rozšíření vytvořit. Určení managedClusters , jak se mapuje na clustery AKS

Volitelné parametry

Název parametru Popis
--auto-upgrade-minor-version Logická vlastnost, která určuje, jestli se podverze rozšíření upgraduje automaticky nebo ne. Výchozí hodnota: true. Pokud je tento parametr nastavený na hodnotu true, nemůžete nastavit version parametr, protože verze se bude dynamicky aktualizovat. Pokud je nastavená hodnota false, rozšíření se automaticky neupgraduje ani pro verze oprav.
--version Verze rozšíření, ke které se má nainstalovat (konkrétní verze pro připnutí instance rozšíření). Pokud je nastavena truemožnost automatického upgradu podverze, nesmí být zadána .
--configuration-settings Nastavení, která lze předat do rozšíření pro řízení jeho funkčnosti. Předejte hodnoty jako dvojice oddělené key=value mezerami za název parametru. Pokud se tento parametr použije v příkazu, --configuration-settings-file nedá se použít ve stejném příkazu.
--configuration-settings-file Cesta k souboru JSON s páry klíč-hodnota, které se mají použít pro předávání konfiguračních nastavení rozšíření. Pokud se tento parametr použije v příkazu, --configuration-settings nedá se použít ve stejném příkazu.
--configuration-protected-settings Tato nastavení se nedají načíst pomocí GET volání rozhraní API nebo az k8s-extension show příkazů, a proto se používají k předávání citlivých nastavení. Předejte hodnoty jako dvojice oddělené key=value mezerami za název parametru. Pokud se tento parametr použije v příkazu, --configuration-protected-settings-file nedá se použít ve stejném příkazu.
--configuration-protected-settings-file Cesta k souboru JSON s páry klíč-hodnota, které se mají použít pro předávání citlivých nastavení do rozšíření. Pokud se tento parametr použije v příkazu, --configuration-protected-settings nedá se použít ve stejném příkazu.
--scope Rozsah instalace pro rozšíření – cluster nebo namespace
--release-namespace Tento parametr označuje obor názvů, ve kterém se má verze vytvořit. Tento parametr je relevantní pouze v případě, že scope je parametr nastaven na cluster.
--release-train Autoři rozšíření mohou publikovat verze v různých verzích vlaků, jako Stableje , Previewatd. Pokud tento parametr není explicitně nastavený, Stable použije se jako výchozí. Tento parametr nelze použít, pokud --auto-upgrade-minor-version je parametr nastaven na falsehodnotu .
--target-namespace Tento parametr označuje obor názvů, ve kterém bude verze vytvořena. Oprávnění systémového účtu vytvořeného pro tuto instanci rozšíření bude omezeno na tento obor názvů. Tento parametr je relevantní pouze v případě, že scope je parametr nastaven na namespace.
--plan-name ID plánu rozšíření, které najdete na stránce Marketplace na webu Azure Portal v části Informace o využití a podpora
--plan-product ID produktu rozšíření, které najdete na stránce Marketplace na webu Azure Portal v části Informace o využití a podpora Příkladem je název použité nabídky nezávislých výrobců softwaru.
--plan-publisher ID vydavatele rozšíření, které najdete na stránce Marketplace na webu Azure Portal v části Informace o využití a podpora.

Zobrazení podrobností o instanci rozšíření

Pokud chcete zobrazit podrobnosti o aktuálně nainstalované instanci rozšíření, použijte k8s-extension showpředávání hodnot povinných parametrů.

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

Výpis všech rozšíření nainstalovaných v clusteru

Pokud chcete zobrazit seznam všech rozšíření nainstalovaných v clusteru, použijte k8s-extension listfunkci předávání hodnot povinných parametrů.

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

Aktualizace instance rozšíření

Poznámka:

Informace o konkrétních nastaveních a --configuration-protected-settings možnostech aktualizace najdete v --configuration-settings dokumentaci ke konkrétnímu typu rozšíření. Očekává --configuration-protected-settingsse, že budou všechna nastavení k dispozici, i když se aktualizuje jenom jedno nastavení. Pokud některá z těchto nastavení vynecháte, budou tato nastavení považována za za zastaralá a odstraněná.

Pokud chcete aktualizovat existující instanci rozšíření, použijte k8s-extension updatepředávání hodnot povinných parametrů. Následující příkaz aktualizuje nastavení automatického upgradu instance rozšíření Azure Machine Learning:

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

Požadované parametry pro aktualizaci

Název parametru Popis
--name Název instance rozšíření
--extension-type Typ rozšíření, které chcete nainstalovat do clusteru. Příklad: Microsoft.AzureML.Kubernetes
--cluster-name Název clusteru AKS, na kterém se má instance rozšíření vytvořit
--resource-group Skupina prostředků obsahující cluster AKS
--cluster-type Typ clusteru, na kterém se má instance rozšíření vytvořit. Určení managedClusters , jak se mapuje na clustery AKS

Pokud se aktualizace aplikace Kubernetes, která se pořizuje prostřednictvím Marketplace, vyžadují se také následující parametry:

Název parametru Popis
--plan-name ID plánu rozšíření, které najdete na stránce Marketplace na webu Azure Portal v části Informace o využití a podpora
--plan-product ID produktu rozšíření, které najdete na stránce Marketplace na webu Azure Portal v části Informace o využití a podpora Příkladem je název použité nabídky nezávislých výrobců softwaru.
--plan-publisher ID vydavatele rozšíření, které najdete na stránce Marketplace na webu Azure Portal v části Informace o využití a podpora.

Volitelné parametry pro aktualizaci

Název parametru Popis
--auto-upgrade-minor-version Logická vlastnost, která určuje, jestli se podverze rozšíření upgraduje automaticky nebo ne. Výchozí hodnota: true. Pokud je tento parametr nastaven na hodnotu true, nelze nastavit version parametr, protože verze se bude dynamicky aktualizovat. Pokud je nastavená hodnota false, rozšíření se automaticky neupgraduje ani pro verze oprav.
--version Verze rozšíření, ke které se má nainstalovat (konkrétní verze pro připnutí instance rozšíření). Pokud je nastavena truemožnost automatického upgradu podverze, nesmí být zadána .
--configuration-settings Nastavení, která lze předat do rozšíření pro řízení jeho funkčnosti. Je potřeba zadat pouze nastavení, která vyžadují aktualizaci. Zadaná nastavení by se nahradila zadanými hodnotami. Předejte hodnoty jako dvojice oddělené key=value mezerami za název parametru. Pokud se tento parametr použije v příkazu, --configuration-settings-file nedá se použít ve stejném příkazu.
--configuration-settings-file Cesta k souboru JSON s páry klíč-hodnota, které se mají použít pro předávání konfiguračních nastavení rozšíření. Pokud se tento parametr použije v příkazu, --configuration-settings nedá se použít ve stejném příkazu.
--configuration-protected-settings Tato nastavení se nedají načíst pomocí GET volání rozhraní API nebo az k8s-extension show příkazů, a proto se používají k předávání citlivých nastavení. Při aktualizaci nastavení se očekává, že budou zadána všechna nastavení. Pokud některá nastavení vynecháte, budou tato nastavení považována za za zastaralá a odstraněná. Předejte hodnoty jako dvojice oddělené key=value mezerami za název parametru. Pokud se tento parametr použije v příkazu, --configuration-protected-settings-file nedá se použít ve stejném příkazu.
--configuration-protected-settings-file Cesta k souboru JSON s páry klíč-hodnota, které se mají použít pro předávání citlivých nastavení do rozšíření. Pokud se tento parametr použije v příkazu, --configuration-protected-settings nedá se použít ve stejném příkazu.
--scope Rozsah instalace pro rozšíření – cluster nebo namespace
--release-train Autoři rozšíření mohou publikovat verze v různých verzích vlaků, jako Stableje , Previewatd. Pokud tento parametr není explicitně nastavený, Stable použije se jako výchozí. Tento parametr nelze použít, pokud autoUpgradeMinorVersion je parametr nastaven na falsehodnotu .

Odstranění instance rozšíření

Pokud chcete odstranit instanci rozšíření v clusteru, použijte k8s-extension-deletepředávání hodnot povinných parametrů.

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

Poznámka:

Prostředek Azure představující toto rozšíření se okamžitě odstraní. Verze Helm v clusteru přidruženém k tomuto rozšíření se odstraní jenom v případě, že agenti spuštění v clusteru Kubernetes mají síťové připojení a můžou se znovu spojit se službami Azure a načíst požadovaný stav.

Další kroky