az k8s-extension

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de extensie k8s voor de Azure CLI (versie 2.51.0 of hoger). De extensie installeert automatisch de eerste keer dat u een opdracht az k8s-extension uitvoert. Meer informatie over extensies.

Opdrachten voor het beheren van Kubernetes Extensions.

Opdracht

Name Description Type Status
az k8s-extension create

Maak een Kubernetes-clusterextensie, waaronder het aanschaffen van een uitbreidingsaanbieding vanuit Azure Marketplace (alleen AKS). Raadpleeg het voorbeeld aan het einde om te zien hoe u een extensie maakt of een uitbreidingsaanbieding koopt.

 Toestel GA
az k8s-extension delete

Een Kubernetes-extensie verwijderen.

 Toestel GA
az k8s-extension extension-types

Opdrachten voor het detecteren van Kubernetes-extensietypen.

 Toestel Preview
az k8s-extension extension-types list

Geef beschikbare clusteruitbreidingstypen voor een bestaand cluster weer.

 Toestel Voorbeeld en afgeschaft
az k8s-extension extension-types list-by-cluster

Geef beschikbare clusteruitbreidingstypen voor een bestaand cluster weer. De eigenschappen die worden gebruikt voor filteren zijn het type cluster (beheerd, verbonden, enzovoort), kubernetes-versie, locatie van het cluster.

 Toestel Preview
az k8s-extension extension-types list-by-location

Geef beschikbare clusteruitbreidingstypen weer in een regio.

 Toestel Preview
az k8s-extension extension-types list-versions

Geef beschikbare versies weer voor een clusterextensietype voor een bepaald cluster.

 Toestel Voorbeeld en afgeschaft
az k8s-extension extension-types list-versions-by-cluster

Geef beschikbare versies weer voor een clusterextensietype voor een bepaald cluster. De eigenschappen die worden gebruikt voor filteren zijn het type cluster (beheerd, verbonden, enzovoort), kubernetes-versie, locatie van het cluster.

 Toestel Preview
az k8s-extension extension-types list-versions-by-location

Geef beschikbare versies weer voor een clusterextensietypeversies in een regio.

 Toestel Preview
az k8s-extension extension-types show

Eigenschappen ophalen voor een clusterextensietype in een regio.

 Toestel Voorbeeld en afgeschaft
az k8s-extension extension-types show-by-cluster

Eigenschappen weergeven voor een clusterextensietype voor een bestaand cluster. De eigenschappen die worden gebruikt voor filteren zijn het type cluster (beheerd, verbonden, enzovoort), kubernetes-versie, locatie van het cluster.

 Toestel Preview
az k8s-extension extension-types show-by-location

Eigenschappen weergeven voor een clusterextensietype in een regio.

 Toestel Preview
az k8s-extension extension-types show-version-by-cluster

Eigenschappen weergeven die zijn gekoppeld aan een clusterextensietypeversie voor een bestaand cluster. De eigenschappen die worden gebruikt voor filteren zijn het type cluster (beheerd, verbonden, enzovoort), kubernetes-versie, locatie van het cluster.

 Toestel Preview
az k8s-extension extension-types show-version-by-location

Eigenschappen weergeven die zijn gekoppeld aan een clusterextensietypeversie in een regio.

 Toestel Preview
az k8s-extension list

Kubernetes-extensies weergeven.

 Toestel GA
az k8s-extension show

Een Kubernetes-extensie weergeven.

 Toestel GA
az k8s-extension update

Veranderlijke eigenschappen van een Kubernetes-extensie bijwerken.

 Toestel GA

az k8s-extension create

Maak een Kubernetes-clusterextensie, waaronder het aanschaffen van een uitbreidingsaanbieding vanuit Azure Marketplace (alleen AKS). Raadpleeg het voorbeeld aan het einde om te zien hoe u een extensie maakt of een uitbreidingsaanbieding koopt.

Maak een Kubernetes-extensie. De uitvoer bevat geheimen die u moet beveiligen. Zorg ervoor dat u deze geheimen niet opneemt in uw broncodebeheer. Controleer ook of er geen geheimen aanwezig zijn in de logboeken van uw opdracht of script. Zie http://aka.ms/clisecrets voor aanvullende informatie.

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]

Voorbeelden

Een Kubernetes-extensie maken

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

Een Kubernetes Marketplace-extensie maken

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

Vereiste parameters

--cluster-name -c

Naam van het Kubernetes-cluster.

--cluster-type -t

Geef Arc-clusters of door AKS beheerde clusters of Arc-apparaten of provisionedClusters op.

geaccepteerde waarden: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Naam van het extensietype.

--name -n

Naam van het extensie-exemplaar.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--auto-upgrade --auto-upgrade-minor-version

Automatisch een secundaire versie van het extensie-exemplaar bijwerken.

geaccepteerde waarden: false, true
--cluster-resource-provider --cluster-rp

Clusterresourceprovidernaam voor dit clustertype (vereist voor provisionedClusters).

--config --configuration-settings

Configuratie Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Gebruik dit niet voor geheimen, omdat deze waarde als antwoord wordt geretourneerd.

--config-file --config-settings-file

JSON-bestandspad voor configuratie-instellingen.

--config-protected --config-protected-settings

Met configuratie beveiligde Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Alleen de sleutel wordt als antwoord geretourneerd, de waarde is niet.

--config-protected-file --config-protected-settings-file

JSON-bestandspad voor met configuratie beveiligde instellingen.

--config-settings
Afgeschaft

Optie '--config-settings' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--configuration-settings'.

Configuratie Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Gebruik dit niet voor geheimen, omdat deze waarde als antwoord wordt geretourneerd.

--configuration-protected-settings
Afgeschaft

Optie '--configuration-protected-settings' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--config-protected-settings'.

Met configuratie beveiligde Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Alleen de sleutel wordt als antwoord geretourneerd, de waarde is niet.

--configuration-protected-settings-file
Afgeschaft

Optie '--configuration-protected-settings-file' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--config-protected-file'.

JSON-bestandspad voor met configuratie beveiligde instellingen.

--configuration-settings-file
Afgeschaft

Optie '--configuration-settings-file' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--config-settings-file'.

JSON-bestandspad voor configuratie-instellingen.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--plan-name

De naam van het plan verwijst naar de plan-id van de extensie die wordt opgehaald uit de Marketplace-portal onder Gebruiksgegevens en ondersteuning.

--plan-product

Het abonnementsproduct verwijst naar de product-id van de extensie die wordt opgehaald uit de Marketplace-portal onder Gebruiksgegevens en ondersteuning. Een voorbeeld hiervan is de naam van het gebruikte ISV-aanbod.

--plan-publisher

De uitgever van het plan verwijst naar de uitgever-id van de extensie die wordt opgehaald uit de Marketplace-portal onder Gebruiksgegevens en ondersteuning.

--release-namespace

Geef de naamruimte op om de extensierelease te installeren.

--release-train

Geef de releasetrein op voor het extensietype.

--scope

Geef het extensiebereik op.

geaccepteerde waarden: cluster, namespace
--target-namespace

Geef de doelnaamruimte op waarop u wilt installeren voor het extensie-exemplaar. Deze parameter is vereist als het extensiebereik is ingesteld op 'naamruimte'.

--version

Geef de versie op die moet worden geïnstalleerd voor het extensie-exemplaar als --auto-upgrade-minor-version niet is ingeschakeld.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az k8s-extension delete

Een Kubernetes-extensie verwijderen.

az k8s-extension delete --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--cluster-resource-provider]
                        [--force]
                        [--no-wait]
                        [--yes]

Voorbeelden

Een bestaande Kubernetes-extensie verwijderen

az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Vereiste parameters

--cluster-name -c

Naam van het Kubernetes-cluster.

--cluster-type -t

Geef Arc-clusters of door AKS beheerde clusters of Arc-apparaten of provisionedClusters op.

geaccepteerde waarden: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Naam van het extensie-exemplaar.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--cluster-resource-provider --cluster-rp

Clusterresourceprovidernaam voor dit clustertype (vereist voor provisionedClusters).

--force

Geef op of de extensie moet worden geforceerd verwijderd uit het cluster.

standaardwaarde: False
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--yes -y

Bevestigingsprompts negeren.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az k8s-extension list

Kubernetes-extensies weergeven.

Vermeld alle Kubernetes-extensies in een cluster, inclusief hun eigenschappen. De uitvoer bevat geheimen die u moet beveiligen. Zorg ervoor dat u deze geheimen niet opneemt in uw broncodebeheer. Controleer ook of er geen geheimen aanwezig zijn in de logboeken van uw opdracht of script. Zie http://aka.ms/clisecrets voor aanvullende informatie.

az k8s-extension list --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --resource-group
                      [--cluster-resource-provider]

Voorbeelden

Alle Kubernetes-extensies in een cluster weergeven

az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

Vereiste parameters

--cluster-name -c

Naam van het Kubernetes-cluster.

--cluster-type -t

Geef Arc-clusters of door AKS beheerde clusters of Arc-apparaten of provisionedClusters op.

geaccepteerde waarden: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--cluster-resource-provider --cluster-rp

Clusterresourceprovidernaam voor dit clustertype (vereist voor provisionedClusters).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az k8s-extension show

Een Kubernetes-extensie weergeven.

Een Kubernetes-extensie weergeven, inclusief de eigenschappen. De uitvoer bevat geheimen die u moet beveiligen. Zorg ervoor dat u deze geheimen niet opneemt in uw broncodebeheer. Controleer ook of er geen geheimen aanwezig zijn in de logboeken van uw opdracht of script. Zie http://aka.ms/clisecrets voor aanvullende informatie.

az k8s-extension show --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --name
                      --resource-group
                      [--cluster-resource-provider]

Voorbeelden

Details van een Kubernetes-extensie weergeven

az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Vereiste parameters

--cluster-name -c

Naam van het Kubernetes-cluster.

--cluster-type -t

Geef Arc-clusters of door AKS beheerde clusters of Arc-apparaten of provisionedClusters op.

geaccepteerde waarden: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Naam van het extensie-exemplaar.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--cluster-resource-provider --cluster-rp

Clusterresourceprovidernaam voor dit clustertype (vereist voor provisionedClusters).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az k8s-extension update

Veranderlijke eigenschappen van een Kubernetes-extensie bijwerken.

Instellingen Raadpleeg de documentatie van de clusterextensieservice om te controleren of de update van deze eigenschappen wordt ondersteund voordat u deze eigenschappen bijwerkt voordat u deze eigenschappen bij Instellingen werkt voordat u deze updates wilt bijwerken. De uitvoer bevat geheimen die u moet beveiligen. Zorg ervoor dat u deze geheimen niet opneemt in uw broncodebeheer. Controleer ook of er geen geheimen aanwezig zijn in de logboeken van uw opdracht of script. Zie http://aka.ms/clisecrets voor aanvullende informatie.

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]

Voorbeelden

Een Kubernetes-extensie bijwerken

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

Vereiste parameters

--cluster-name -c

Naam van het Kubernetes-cluster.

--cluster-type -t

Geef Arc-clusters of door AKS beheerde clusters of Arc-apparaten of provisionedClusters op.

geaccepteerde waarden: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Naam van het extensie-exemplaar.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--auto-upgrade --auto-upgrade-minor-version

Automatisch een secundaire versie van het extensie-exemplaar bijwerken.

geaccepteerde waarden: false, true
--cluster-resource-provider --cluster-rp

Clusterresourceprovidernaam voor dit clustertype (vereist voor provisionedClusters).

--config --configuration-settings

Configuratie Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Gebruik dit niet voor geheimen, omdat deze waarde als antwoord wordt geretourneerd.

--config-file --config-settings-file

JSON-bestandspad voor configuratie-instellingen.

--config-protected --config-protected-settings

Met configuratie beveiligde Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Alleen de sleutel wordt als antwoord geretourneerd, de waarde is niet.

--config-protected-file --config-protected-settings-file

JSON-bestandspad voor met configuratie beveiligde instellingen.

--config-settings
Afgeschaft

Optie '--config-settings' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--configuration-settings'.

Configuratie Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Gebruik dit niet voor geheimen, omdat deze waarde als antwoord wordt geretourneerd.

--configuration-protected-settings
Afgeschaft

Optie '--configuration-protected-settings' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--config-protected-settings'.

Met configuratie beveiligde Instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Alleen de sleutel wordt als antwoord geretourneerd, de waarde is niet.

--configuration-protected-settings-file
Afgeschaft

Optie '--configuration-protected-settings-file' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--config-protected-file'.

JSON-bestandspad voor met configuratie beveiligde instellingen.

--configuration-settings-file
Afgeschaft

Optie '--configuration-settings-file' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--config-settings-file'.

JSON-bestandspad voor configuratie-instellingen.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--release-train

Geef de releasetrein op voor het extensietype.

--version

Geef de versie op die moet worden geïnstalleerd voor het extensie-exemplaar als --auto-upgrade-minor-version niet is ingeschakeld.

--yes -y

Bevestigingsprompts negeren.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.