az k8s-extension
Hinweis
Diese Referenz ist Teil der k8s-Erweiterungserweiterung für die Azure CLI (Version 2.51.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az k8s-Erweiterungsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen
Befehle zum Verwalten von Kubernetes-Erweiterungen.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az k8s-extension create |
Erstellen Sie eine Kubernetes-Clustererweiterung, einschließlich des Kaufs eines Erweiterungsangebots von Azure Marketplace (nur AKS). Weitere Informationen zum Erstellen einer Erweiterung oder zum Kauf eines Erweiterungsangebots finden Sie im Beispiel am Ende. |
Durchwahl | Allgemein verfügbar |
az k8s-extension delete |
Löschen Sie eine Kubernetes-Erweiterung. |
Durchwahl | Allgemein verfügbar |
az k8s-extension extension-types |
Befehle zum Ermitteln von Kubernetes-Erweiterungstypen. |
Durchwahl | Vorschau |
az k8s-extension extension-types list |
Auflisten der verfügbaren Clustererweiterungstypen für einen vorhandenen Cluster. |
Durchwahl | Vorschau und veraltet |
az k8s-extension extension-types list-by-cluster |
Auflisten der verfügbaren Clustererweiterungstypen für einen vorhandenen Cluster. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters. |
Durchwahl | Vorschau |
az k8s-extension extension-types list-by-location |
Auflisten der verfügbaren Clustererweiterungstypen in einer Region. |
Durchwahl | Vorschau |
az k8s-extension extension-types list-versions |
Auflisten der verfügbaren Versionen für einen Clustererweiterungstyp für einen bestimmten Cluster. |
Durchwahl | Vorschau und veraltet |
az k8s-extension extension-types list-versions-by-cluster |
Auflisten der verfügbaren Versionen für einen Clustererweiterungstyp für einen bestimmten Cluster. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters. |
Durchwahl | Vorschau |
az k8s-extension extension-types list-versions-by-location |
Listet die verfügbaren Versionen für eine Clustererweiterungstypversion in einer Region auf. |
Durchwahl | Vorschau |
az k8s-extension extension-types show |
Dient zum Abrufen von Eigenschaften für einen Clustererweiterungstyp in einem Bereich. |
Durchwahl | Vorschau und veraltet |
az k8s-extension extension-types show-by-cluster |
Eigenschaften für einen Clustererweiterungstyp für einen vorhandenen Cluster anzeigen. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters. |
Durchwahl | Vorschau |
az k8s-extension extension-types show-by-location |
Eigenschaften für einen Clustererweiterungstyp in einem Bereich anzeigen. |
Durchwahl | Vorschau |
az k8s-extension extension-types show-version-by-cluster |
Eigenschaften anzeigen, die einer Clustererweiterungstypversion für einen vorhandenen Cluster zugeordnet sind. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters. |
Durchwahl | Vorschau |
az k8s-extension extension-types show-version-by-location |
Eigenschaften anzeigen, die einer Clustererweiterungstypversion in einer Region zugeordnet sind. |
Durchwahl | Vorschau |
az k8s-extension list |
Kubernetes-Erweiterungen auflisten. |
Durchwahl | Allgemein verfügbar |
az k8s-extension show |
Zeigen Sie eine Kubernetes-Erweiterung an. |
Durchwahl | Allgemein verfügbar |
az k8s-extension update |
Aktualisieren sie veränderbare Eigenschaften einer Kubernetes-Erweiterung. |
Durchwahl | Allgemein verfügbar |
az k8s-extension create
Erstellen Sie eine Kubernetes-Clustererweiterung, einschließlich des Kaufs eines Erweiterungsangebots von Azure Marketplace (nur AKS). Weitere Informationen zum Erstellen einer Erweiterung oder zum Kauf eines Erweiterungsangebots finden Sie im Beispiel am Ende.
Erstellen Sie eine Kubernetes-Erweiterung. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Weitere Informationen finden Sie unter http://aka.ms/clisecrets.
az k8s-extension create --cluster-name
--cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
--extension-type
--name
--resource-group
[--auto-upgrade {false, true}]
[--cluster-resource-provider]
[--config]
[--config-file]
[--config-protected]
[--config-protected-file]
[--config-settings]
[--configuration-protected-settings]
[--configuration-protected-settings-file]
[--configuration-settings-file]
[--no-wait]
[--plan-name]
[--plan-product]
[--plan-publisher]
[--release-namespace]
[--release-train]
[--scope {cluster, namespace}]
[--target-namespace]
[--version]
Beispiele
Erstellen einer Kubernetes-Erweiterung
az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --extension-type microsoft.openservicemesh --scope cluster --release-train stable
Erstellen einer Kubernetes Marketplace-Erweiterung
az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type managedClusters --name myextension --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --release-train stable --plan-name testplan --plan-product kubernetest_apps_demo_offer --plan-publisher test_test_mix3pptest0011614206850774
Erforderliche Parameter
Name des Kubernetes-Clusters.
Geben Sie Arc-Cluster oder verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster an.
Name des Erweiterungstyps.
Name der Erweiterungsinstanz.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Automatisches Upgrade der Nebenversion der Erweiterungsinstanz.
Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).
Configuration Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Verwenden Sie dies nicht für geheime Schlüssel, da dieser Wert als Antwort zurückgegeben wird.
JSON-Dateipfad für Konfigurationseinstellungen.
Configuration Protected Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Nur der Schlüssel wird als Antwort zurückgegeben, der Wert ist nicht.
JSON-Dateipfad für konfigurationsgeschützte Einstellungen.
Option "--config-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--configuration-settings".
Configuration Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Verwenden Sie dies nicht für geheime Schlüssel, da dieser Wert als Antwort zurückgegeben wird.
Option "--configuration-protected-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-settings".
Configuration Protected Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Nur der Schlüssel wird als Antwort zurückgegeben, der Wert ist nicht.
Option "--configuration-protected-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-file".
JSON-Dateipfad für konfigurationsgeschützte Einstellungen.
Option "--configuration-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-settings-file".
JSON-Dateipfad für Konfigurationseinstellungen.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Der Planname verweist auf die Plan-ID der Erweiterung, die vom Marketplace-Portal unter Nutzungsinformationen + Support übernommen wird.
Das Planprodukt verweist auf die Produkt-ID der Erweiterung, die vom Marketplace-Portal unter Nutzungsinformationen + Support übernommen wird. Ein Beispiel hierfür ist der Name des verwendeten ISV-Angebots.
Der Planherausgeber verweist auf die Herausgeber-ID der Erweiterung, die vom Marketplace-Portal unter Nutzungsinformationen + Support übernommen wird.
Geben Sie den Namespace an, um die Erweiterungsversion zu installieren.
Geben Sie den Release-Zug für den Erweiterungstyp an.
Geben Sie den Erweiterungsbereich an.
Geben Sie den Zielnamespace an, der für die Erweiterungsinstanz installiert werden soll. Dieser Parameter ist erforderlich, wenn der Erweiterungsbereich auf "namespace" festgelegt ist.
Geben Sie die version an, die für die Erweiterungsinstanz installiert werden soll, wenn --auto-upgrade-minor-version nicht aktiviert ist.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az k8s-extension delete
Löschen Sie eine Kubernetes-Erweiterung.
az k8s-extension delete --cluster-name
--cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
--name
--resource-group
[--cluster-resource-provider]
[--force]
[--no-wait]
[--yes]
Beispiele
Löschen einer vorhandenen Kubernetes-Erweiterung
az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension
Erforderliche Parameter
Name des Kubernetes-Clusters.
Geben Sie Arc-Cluster oder verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster an.
Name der Erweiterungsinstanz.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).
Geben Sie an, ob das Löschen der Erweiterung aus dem Cluster erzwungen werden soll.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Bestätigungsaufforderungen ignorieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az k8s-extension list
Kubernetes-Erweiterungen auflisten.
Listet alle Kubernetes-Erweiterungen in einem Cluster auf, einschließlich ihrer Eigenschaften. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Weitere Informationen finden Sie unter http://aka.ms/clisecrets.
az k8s-extension list --cluster-name
--cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
--resource-group
[--cluster-resource-provider]
Beispiele
Auflisten aller Kubernetes-Erweiterungen auf einem Cluster
az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters
Erforderliche Parameter
Name des Kubernetes-Clusters.
Geben Sie Arc-Cluster oder verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster an.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az k8s-extension show
Zeigen Sie eine Kubernetes-Erweiterung an.
Zeigen Sie eine Kubernetes-Erweiterung einschließlich der zugehörigen Eigenschaften an. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Weitere Informationen finden Sie unter http://aka.ms/clisecrets.
az k8s-extension show --cluster-name
--cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
--name
--resource-group
[--cluster-resource-provider]
Beispiele
Details einer Kubernetes-Erweiterung anzeigen
az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension
Erforderliche Parameter
Name des Kubernetes-Clusters.
Geben Sie Arc-Cluster oder verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster an.
Name der Erweiterungsinstanz.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az k8s-extension update
Aktualisieren sie veränderbare Eigenschaften einer Kubernetes-Erweiterung.
Informationen zum Aktualisieren auf Config Einstellungen und ConfigProtected Einstellungen finden Sie in der Dokumentation des Clustererweiterungsdiensts, um die Aktualisierung dieser Eigenschaften zu überprüfen, bevor diese Eigenschaften aktualisiert werden. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Weitere Informationen finden Sie unter http://aka.ms/clisecrets.
az k8s-extension update --cluster-name
--cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
--name
--resource-group
[--auto-upgrade {false, true}]
[--cluster-resource-provider]
[--config]
[--config-file]
[--config-protected]
[--config-protected-file]
[--config-settings]
[--configuration-protected-settings]
[--configuration-protected-settings-file]
[--configuration-settings-file]
[--no-wait]
[--release-train]
[--version]
[--yes]
Beispiele
Aktualisieren einer Kubernetes-Erweiterung
az k8s-extension update --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --auto-upgrade true/false --version extension-version --release-train stable --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file
Erforderliche Parameter
Name des Kubernetes-Clusters.
Geben Sie Arc-Cluster oder verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster an.
Name der Erweiterungsinstanz.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Automatisches Upgrade der Nebenversion der Erweiterungsinstanz.
Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).
Configuration Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Verwenden Sie dies nicht für geheime Schlüssel, da dieser Wert als Antwort zurückgegeben wird.
JSON-Dateipfad für Konfigurationseinstellungen.
Configuration Protected Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Nur der Schlüssel wird als Antwort zurückgegeben, der Wert ist nicht.
JSON-Dateipfad für konfigurationsgeschützte Einstellungen.
Option "--config-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--configuration-settings".
Configuration Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Verwenden Sie dies nicht für geheime Schlüssel, da dieser Wert als Antwort zurückgegeben wird.
Option "--configuration-protected-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-settings".
Configuration Protected Einstellungen as key=value pair. Wiederholen Sie den Parameter für jede Einstellung. Nur der Schlüssel wird als Antwort zurückgegeben, der Wert ist nicht.
Option "--configuration-protected-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-file".
JSON-Dateipfad für konfigurationsgeschützte Einstellungen.
Option "--configuration-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-settings-file".
JSON-Dateipfad für Konfigurationseinstellungen.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Geben Sie den Release-Zug für den Erweiterungstyp an.
Geben Sie die version an, die für die Erweiterungsinstanz installiert werden soll, wenn --auto-upgrade-minor-version nicht aktiviert ist.
Bestätigungsaufforderungen ignorieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.