az aks extension

Note

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

Comandi per gestire le estensioni nel cluster Kubernetes.

Comandi

Nome	Descrizione	Tipo	Status
az aks extension create	Crea l'istanza dell'estensione cluster nel cluster gestito. Fare riferimento all'esempio alla fine per informazioni su come creare un'estensione del cluster.	Extension	GA
az aks extension delete	Eliminare un'estensione cluster.	Extension	GA
az aks extension list	Elencare le estensioni del cluster.	Extension	GA
az aks extension show	Visualizzare un'estensione cluster.	Extension	GA
az aks extension type	Gestire i tipi di estensione in servizio Azure Kubernetes.	Extension	GA
az aks extension type list	Elencare i tipi di estensione del cluster disponibili. Le proprietà usate per il filtro includono la versione kubernetes, la posizione del cluster.	Extension	GA
az aks extension type show	Mostra le proprietà per un tipo di estensione cluster. Le proprietà usate per il filtro includono la versione kubernetes, la posizione del cluster.	Extension	GA
az aks extension type version	Gestire la versione dei tipi di estensione in servizio Azure Kubernetes.	Extension	GA
az aks extension type version list	Elencare le versioni del tipo di estensione cluster disponibili. Le proprietà usate per il filtro includono la versione kubernetes, la posizione del cluster.	Extension	GA
az aks extension type version show	Mostra le proprietà associate a una versione del tipo di estensione cluster. Le proprietà usate per il filtro includono la versione kubernetes, la posizione del cluster.	Extension	GA
az aks extension update	Aggiornare le proprietà modificabili di un'estensione cluster.	Extension	GA

az aks extension create

Crea l'istanza dell'estensione cluster nel cluster gestito. Fare riferimento all'esempio alla fine per informazioni su come creare un'estensione del cluster.

Creare un'estensione cluster. 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 altre informazioni, vedere http://aka.ms/clisecrets.

az aks extension create --cluster-name
                        --extension-type
                        --name
                        --resource-group
                        [--acquire-policy-token]
                        [--change-reference]
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--release-namespace]
                        [--scope {cluster, namespace}]
                        [--target-namespace]

Esempio

Installare l'estensione cluster nel cluster del servizio Azure Kubernetes con i parametri obbligatori

az aks extension create --resource-group my-resource-group --cluster-name mycluster --name myextension --extension-type microsoft.flux

Installare l'estensione cluster con le impostazioni di configurazione dei parametri facoltative

az aks extension create --resource-group abc --cluster-name test --name flux --extension-type microsoft.flux --config useKubeletIdentity=true

Parametri necessari

--cluster-name -c

Nome del cluster AKS.

--extension-type -t

Nome del tipo di estensione.

--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--config --configuration-settings

Impostazioni di configurazione come coppia chiave=valore.

Impostazioni di configurazione come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Non usarlo per i segreti, perché questo valore viene restituito in risposta. Se non specificato, il valore predefinito è Nessuno.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

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

Percorso del file JSON per le impostazioni di configurazione.

Percorso del file JSON per le impostazioni di configurazione. Se non specificato, il valore predefinito è Nessuno.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

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

Configurazione delle impostazioni protette come coppia chiave=valore.

Impostazioni di configurazione come coppia chiave=valore. Ripetere il parametro per ogni impostazione. Solo la chiave viene restituita in risposta, il valore non è . Se non specificato, il valore predefinito è Nessuno.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

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

Percorso del file JSON per le impostazioni protette dalla configurazione.

Percorso del file JSON per le impostazioni protette dalla configurazione. Se non specificato, il valore predefinito è Nessuno.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valore predefinito:	False

--release-namespace

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

--scope

Specificare l'ambito del tipo di estensione, accetta lo spazio dei nomi o il cluster come ambito.

Specificare l'ambito del tipo di estensione, accetta lo spazio dei nomi o il cluster come ambito Se non specificato, verrà usato l'ambito predefinito impostato nella registrazione del tipo di estensione.

Proprietà	Valore
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'.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--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

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

Proprietà	Valore
Valore predefinito:	False

az aks extension delete

Eliminare un'estensione cluster.

az aks extension delete --cluster-name
                        --name
                        --resource-group
                        [--acquire-policy-token]
                        [--change-reference]
                        [--force]
                        [--no-wait]
                        [--yes]

Esempio

Eliminare un'estensione cluster esistente nel cluster del servizio Azure Kubernetes

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext

Eliminare un'estensione cluster esistente nel cluster del servizio Azure Kubernetes con parametri facoltativi

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext --yes --force

Parametri necessari

--cluster-name -c

Nome del cluster AKS.

--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--force

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

Specificare se forzare l'eliminazione dell'estensione dal cluster Se non specificato, il valore predefinito è false.

Proprietà	Valore
Valore predefinito:	False

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valore predefinito:	False

--yes -y

Ignora la richiesta di conferma.

Ignora la richiesta di conferma. Se non specificato, il valore predefinito è false.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--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

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

Proprietà	Valore
Valore predefinito:	False

az aks extension list

Elencare le estensioni del cluster.

Elencare tutte le estensioni cluster 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 altre informazioni, vedere http://aka.ms/clisecrets.

az aks extension list --cluster-name
                      --resource-group

Esempio

Elencare tutte le estensioni del cluster in un cluster

az aks extension list --resource-group <group> --cluster-name <name>

Parametri necessari

--cluster-name -c

Nome del cluster AKS.

--resource-group -g

Nome del gruppo di risorse.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--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

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

Proprietà	Valore
Valore predefinito:	False

az aks extension show

Visualizzare un'estensione cluster.

Mostra un'estensione 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 altre informazioni, vedere http://aka.ms/clisecrets.

az aks extension show --cluster-name
                      --name
                      --resource-group

Esempio

Visualizzare i dettagli di un'estensione del cluster

az aks extension show --resource-group my-resource-group --cluster-name mycluster --name myextension

Parametri necessari

--cluster-name -c

Nome del cluster AKS.

--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--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

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

Proprietà	Valore
Valore predefinito:	False

az aks extension update

Aggiornare le proprietà modificabili di un'estensione cluster.

Per l'aggiornamento a ConfigSettings e ConfigProtectedSettings, vedere la documentazione del servizio estensione 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 altre informazioni, vedere http://aka.ms/clisecrets.

az aks extension update --cluster-name
                        --name
                        --resource-group
                        [--acquire-policy-token]
                        [--change-reference]
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--yes]

Esempio

Aggiornare l'estensione cluster nel cluster del servizio Azure Kubernetes

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension

Aggiornare l'estensione cluster nel cluster del servizio Azure Kubernetes con parametri facoltativi inclusi

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension --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 AKS.

--name -n

Nome dell'istanza dell'estensione.

--resource-group -g

Nome del gruppo di risorse.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--config --configuration-settings

Impostazioni di configurazione come coppia chiave=valore.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

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

Percorso del file JSON per le impostazioni di configurazione.

Percorso del file JSON per le impostazioni di configurazione. Se non specificato, il valore predefinito è Nessuno.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

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

Configurazione delle impostazioni protette come coppia chiave=valore.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

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

Percorso del file JSON per le impostazioni protette dalla configurazione.

Percorso del file JSON per le impostazioni protette dalla configurazione. Se non specificato, il valore predefinito è Nessuno.

Proprietà	Valore
Gruppo di parametri:	Configuration Arguments

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valore predefinito:	False

--yes -y

Ignora la richiesta di conferma.

Ignora la richiesta di conferma. Se non specificato, il valore predefinito è false.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--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

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

Proprietà	Valore
Valore predefinito:	False

Commenti e suggerimenti

Questa pagina è stata utile?