Condividi tramite

az k8s-extension

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione k8s per l'interfaccia della riga di comando di Azure (versione 2.51.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az k8s-extension . Altre informazioni sulle estensioni.

Comandi per gestire le estensioni Kubernetes.

Comandi

Nome Descrizione Tipo Status
az k8s-extension create

Creare un'estensione del cluster Kubernetes, inclusa l'acquisto di un'offerta di estensione da Azure Marketplace (solo servizio Azure Kubernetes). Fare riferimento all'esempio alla fine per vedere come creare un'estensione o acquistare un'offerta di estensione.

 Estensione Disponibilità generale
az k8s-extension delete

Eliminare un'estensione Kubernetes.

 Estensione Disponibilità generale
az k8s-extension extension-types

Comandi per individuare i tipi di estensione Kubernetes.

 Estensione Anteprima
az k8s-extension extension-types list

Elencare i tipi di estensione del cluster disponibili per un cluster esistente.

 Estensione Anteprima e deprecato
az k8s-extension extension-types list-by-cluster

Elencare i tipi di estensione del cluster disponibili per un cluster esistente. Le proprietà usate per filtrare includono il tipo di cluster (gestito, connesso e così via), la versione kubernetes, la posizione del cluster.

 Estensione Anteprima
az k8s-extension extension-types list-by-location

Elencare i tipi di estensione del cluster disponibili in un'area.

 Estensione Anteprima
az k8s-extension extension-types list-versions

Elencare le versioni disponibili per un tipo di estensione cluster per un determinato cluster.

 Estensione Anteprima e deprecato
az k8s-extension extension-types list-versions-by-cluster

Elencare le versioni disponibili per un tipo di estensione cluster per un determinato cluster. Le proprietà usate per filtrare includono il tipo di cluster (gestito, connesso e così via), la versione kubernetes, la posizione del cluster.

 Estensione Anteprima
az k8s-extension extension-types list-versions-by-location

Elencare le versioni disponibili per un tipo di estensione cluster in un'area.

 Estensione Anteprima
az k8s-extension extension-types show

Ottenere le proprietà per un tipo di estensione cluster in un'area.

 Estensione Anteprima e deprecato
az k8s-extension extension-types show-by-cluster

Mostra le proprietà per un tipo di estensione cluster per un cluster esistente. Le proprietà usate per filtrare includono il tipo di cluster (gestito, connesso e così via), la versione kubernetes, la posizione del cluster.

 Estensione Anteprima
az k8s-extension extension-types show-by-location

Mostra le proprietà per un tipo di estensione cluster in un'area.

 Estensione Anteprima
az k8s-extension extension-types show-version-by-cluster

Mostra le proprietà associate a una versione del tipo di estensione cluster per un cluster esistente. Le proprietà usate per filtrare includono il tipo di cluster (gestito, connesso e così via), la versione kubernetes, la posizione del cluster.

 Estensione Anteprima
az k8s-extension extension-types show-version-by-location

Mostra le proprietà associate a una versione del tipo di estensione cluster in un'area.

 Estensione Anteprima
az k8s-extension list

Elencare le estensioni Kubernetes.

 Estensione Disponibilità generale
az k8s-extension show

Visualizzare un'estensione Kubernetes.

 Estensione Disponibilità generale
az k8s-extension update

Aggiornare le proprietà modificabili di un'estensione Kubernetes.

 Estensione Disponibilità generale

az k8s-extension create

Creare un'estensione del cluster Kubernetes, inclusa l'acquisto di un'offerta di estensione da Azure Marketplace (solo servizio Azure Kubernetes). Fare riferimento all'esempio alla fine per vedere come creare un'estensione o acquistare un'offerta di estensione.

Creare un'estensione Kubernetes. L'output include segreti che è necessario proteggere. Assicurarsi di non includere questi segreti nel controllo del codice sorgente. Verificare anche che nei log del comando o dello script non siano presenti segreti. Per ulteriori informazioni, vedere 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]

Esempio

Creare un'estensione Kubernetes

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

Creare un'estensione del Marketplace Kubernetes

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

Parametri necessari

--cluster-name -c

Nome del cluster Kubernetes.

--cluster-type -t

Specificare cluster Arc o cluster gestiti del servizio Azure Kubernetes o appliance Arc o provisionedClusters.

Valori accettati: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Nome del tipo di estensione.

--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

Aggiornare automaticamente la versione secondaria dell'istanza dell'estensione.

Valori accettati: false, true
--cluster-resource-provider --cluster-rp

Nome del provider di risorse cluster per questo clusterType (obbligatorio per provisionedClusters).

--config --configuration-settings

Configurazione Impostazioni come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Non usarlo per i segreti, perché questo valore viene restituito in risposta.

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

Percorso del file JSON per le impostazioni di configurazione.

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

Configurazione Impostazioni protetta come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Solo la chiave viene restituita in risposta, il valore non è .

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

Percorso del file JSON per le impostazioni protette dalla configurazione.

--config-settings
Deprecato

L'opzione '--config-settings' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--configuration-settings'.

Configurazione Impostazioni come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Non usarlo per i segreti, perché questo valore viene restituito in risposta.

--configuration-protected-settings
Deprecato

L'opzione '--configuration-protected-settings' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--config-protected-settings'.

Configurazione Impostazioni protetta come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Solo la chiave viene restituita in risposta, il valore non è .

--configuration-protected-settings-file
Deprecato

L'opzione '--configuration-protected-settings-file' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--config-protected-file'.

Percorso del file JSON per le impostazioni protette dalla configurazione.

--configuration-settings-file
Deprecato

L'opzione '--configuration-settings-file' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--config-settings-file'.

Percorso del file JSON per le impostazioni di configurazione.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--plan-name

Il nome del piano fa riferimento all'ID piano dell'estensione acquisita dal portale del Marketplace in Informazioni sull'utilizzo e supporto.

--plan-product

Il prodotto del piano fa riferimento all'ID prodotto dell'estensione acquisita dal portale del Marketplace in Informazioni sull'utilizzo e supporto tecnico. Un esempio è il nome dell'offerta ISV usata.

--plan-publisher

L'editore del piano fa riferimento all'ID editore dell'estensione acquisita dal portale di Marketplace in Informazioni sull'utilizzo e supporto.

--release-namespace

Specificare lo spazio dei nomi per installare la versione dell'estensione.

--release-train

Specificare il training della versione per il tipo di estensione.

--scope

Specificare l'ambito dell'estensione.

Valori accettati: cluster, namespace
--target-namespace

Specificare lo spazio dei nomi di destinazione da installare per l'istanza dell'estensione. Questo parametro è obbligatorio se l'ambito dell'estensione è impostato su 'namespace'.

--version

Specificare la versione da installare per l'istanza dell'estensione se --auto-upgrade-minor-version non è abilitato.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az k8s-extension delete

Eliminare un'estensione Kubernetes.

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

Esempio

Eliminare un'estensione Kubernetes esistente

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

Parametri necessari

--cluster-name -c

Nome del cluster Kubernetes.

--cluster-type -t

Specificare cluster Arc o cluster gestiti del servizio Azure Kubernetes o appliance Arc o provisionedClusters.

Valori accettati: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

Nome del provider di risorse cluster per questo clusterType (obbligatorio per provisionedClusters).

--force

Specificare se forzare l'eliminazione dell'estensione dal cluster.

Valore predefinito: False
--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--yes -y

Ignorare le richieste di conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az k8s-extension list

Elencare le estensioni Kubernetes.

Elencare tutte le estensioni Kubernetes in un cluster, incluse le relative proprietà. L'output include segreti che è necessario proteggere. Assicurarsi di non includere questi segreti nel controllo del codice sorgente. Verificare anche che nei log del comando o dello script non siano presenti segreti. Per ulteriori informazioni, vedere http://aka.ms/clisecrets.

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

Esempio

Elencare tutte le estensioni Kubernetes in un cluster

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

Parametri necessari

--cluster-name -c

Nome del cluster Kubernetes.

--cluster-type -t

Specificare cluster Arc o cluster gestiti del servizio Azure Kubernetes o appliance Arc o provisionedClusters.

Valori accettati: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

Nome del provider di risorse cluster per questo clusterType (obbligatorio per provisionedClusters).

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az k8s-extension show

Visualizzare un'estensione Kubernetes.

Visualizzare un'estensione Kubernetes, incluse le relative proprietà. L'output include segreti che è necessario proteggere. Assicurarsi di non includere questi segreti nel controllo del codice sorgente. Verificare anche che nei log del comando o dello script non siano presenti segreti. Per ulteriori informazioni, vedere http://aka.ms/clisecrets.

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

Esempio

Visualizzare i dettagli di un'estensione Kubernetes

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

Parametri necessari

--cluster-name -c

Nome del cluster Kubernetes.

--cluster-type -t

Specificare cluster Arc o cluster gestiti del servizio Azure Kubernetes o appliance Arc o provisionedClusters.

Valori accettati: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

Nome del provider di risorse cluster per questo clusterType (obbligatorio per provisionedClusters).

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az k8s-extension update

Aggiornare le proprietà modificabili di un'estensione Kubernetes.

Per l'aggiornamento a Config Impostazioni e ConfigProtected Impostazioni, vedere la documentazione del servizio di estensione del cluster per verificare che l'aggiornamento a queste proprietà sia supportato prima di aggiornare queste proprietà. L'output include segreti che è necessario proteggere. Assicurarsi di non includere questi segreti nel controllo del codice sorgente. Verificare anche che nei log del comando o dello script non siano presenti segreti. Per ulteriori informazioni, vedere 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]

Esempio

Aggiornare un'estensione Kubernetes

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

Parametri necessari

--cluster-name -c

Nome del cluster Kubernetes.

--cluster-type -t

Specificare cluster Arc o cluster gestiti del servizio Azure Kubernetes o appliance Arc o provisionedClusters.

Valori accettati: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

Aggiornare automaticamente la versione secondaria dell'istanza dell'estensione.

Valori accettati: false, true
--cluster-resource-provider --cluster-rp

Nome del provider di risorse cluster per questo clusterType (obbligatorio per provisionedClusters).

--config --configuration-settings

Configurazione Impostazioni come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Non usarlo per i segreti, perché questo valore viene restituito in risposta.

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

Percorso del file JSON per le impostazioni di configurazione.

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

Configurazione Impostazioni protetta come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Solo la chiave viene restituita in risposta, il valore non è .

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

Percorso del file JSON per le impostazioni protette dalla configurazione.

--config-settings
Deprecato

L'opzione '--config-settings' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--configuration-settings'.

Configurazione Impostazioni come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Non usarlo per i segreti, perché questo valore viene restituito in risposta.

--configuration-protected-settings
Deprecato

L'opzione '--configuration-protected-settings' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--config-protected-settings'.

Configurazione Impostazioni protetta come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Solo la chiave viene restituita in risposta, il valore non è .

--configuration-protected-settings-file
Deprecato

L'opzione '--configuration-protected-settings-file' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--config-protected-file'.

Percorso del file JSON per le impostazioni protette dalla configurazione.

--configuration-settings-file
Deprecato

L'opzione '--configuration-settings-file' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--config-settings-file'.

Percorso del file JSON per le impostazioni di configurazione.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--release-train

Specificare il training della versione per il tipo di estensione.

--version

Specificare la versione da installare per l'istanza dell'estensione se --auto-upgrade-minor-version non è abilitato.

--yes -y

Ignorare le richieste di conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.