Condividi tramite


az aro

Gestire i cluster Azure Red Hat OpenShift.

Comandi

Nome Descrizione Tipo Status
az aro create

Creare un cluster.

Core GA
az aro delete

Eliminare un cluster.

Core GA
az aro get-admin-kubeconfig

Elencare l'amministratore kubeconfig di un cluster.

Core GA
az aro get-versions

Elencare le versioni disponibili per l'installazione.

Core GA
az aro list

Elencare i cluster.

Core GA
az aro list-credentials

Elencare le credenziali di un cluster.

Core GA
az aro show

Ottenere i dettagli di un cluster.

Core GA
az aro update

Aggiornare un cluster.

Core GA
az aro validate

Convalidare le autorizzazioni necessarie per creare un cluster.

Core GA
az aro wait

Attendere che un cluster raggiunga uno stato desiderato.

Core GA

az aro create

Creare un cluster.

az aro create --master-subnet
              --name
              --resource-group
              --worker-subnet
              [--apiserver-visibility {Private, Public}]
              [--client-id]
              [--client-secret]
              [--cluster-resource-group]
              [--disk-encryption-set]
              [--domain]
              [--enable-preconfigured-nsg {false, true}]
              [--fips --fips-validated-modules {false, true}]
              [--ingress-visibility {Private, Public}]
              [--lb-ip-count --load-balancer-managed-outbound-ip-count]
              [--location]
              [--master-enc-host --master-encryption-at-host {false, true}]
              [--master-vm-size]
              [--no-wait]
              [--outbound-type]
              [--pod-cidr]
              [--pull-secret]
              [--service-cidr]
              [--tags]
              [--version]
              [--vnet]
              [--vnet-resource-group]
              [--worker-count]
              [--worker-enc-host --worker-encryption-at-host {false, true}]
              [--worker-vm-disk-size-gb]
              [--worker-vm-size]

Esempio

Creare un cluster.

az aro create --resource-group MyResourceGroup --name MyCluster --vnet MyVnet --master-subnet MyMasterSubnet --worker-subnet MyWorkerSubnet

Creare un cluster con una versione di OpenShift supportata.

az aro create --resource-group MyResourceGroup --name MyCluster --vnet MyVnet --master-subnet MyMasterSubnet --worker-subnet MyWorkerSubnet --version X.Y.Z

Creare un cluster con 5 nodi di calcolo e un segreto di pull di Red Hat.

az aro create --resource-group MyResourceGroup --name MyCluster --vnet MyVnet --master-subnet MyMasterSubnet --worker-subnet MyWorkerSubnet --worker-count 5 --pull-secret pullsecret.txt

Creare un cluster privato.

az aro create --resource-group MyResourceGroup --name MyCluster --vnet MyVnet --master-subnet MyMasterSubnet --worker-subnet MyWorkerSubnet --apiserver-visibility Private --ingress-visibility Private

Parametri necessari

--master-subnet

Nome o ID della subnet della rete virtuale master. Se viene specificato il nome, --vnet è necessario specificare .

--name -n

Nome del cluster.

--resource-group -g

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

--worker-subnet

Nome o ID della subnet della rete virtuale del ruolo di lavoro. Se viene specificato il nome, --vnet è necessario specificare .

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.

--apiserver-visibility

Visibilità del server API.

Proprietà Valore
Valore predefinito: Public
Valori accettati: Private, Public
--client-id

ID client dell'entità servizio del cluster.

--client-secret

Segreto client dell'entità servizio del cluster.

--cluster-resource-group

Gruppo di risorse del cluster.

--disk-encryption-set

ResourceID dell'oggetto DiskEncryptionSet da usare per le macchine virtuali master e di lavoro.

--domain

Dominio del cluster.

--enable-preconfigured-nsg

Usare gruppi di sicurezza di rete preconfigurati.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--fips --fips-validated-modules

Usare i moduli di crittografia convalidati FIPS.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--ingress-visibility

Visibilità in ingresso.

Proprietà Valore
Valore predefinito: Public
Valori accettati: Private, Public
--lb-ip-count --load-balancer-managed-outbound-ip-count

Numero desiderato di indirizzi IP in uscita IPv4 creati e gestiti da Azure per il servizio di bilanciamento del carico pubblico del cluster.

--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--master-enc-host --master-encryption-at-host

Crittografia nel flag host per le macchine virtuali master.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--master-vm-size

Dimensioni delle macchine virtuali master.

Proprietà Valore
Valore predefinito: Standard_D8s_v5
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--outbound-type

Tipo di cluster in uscita. Deve essere "Loadbalancer" o "UserDefinedRouting".

Proprietà Valore
Valore predefinito: Loadbalancer
--pod-cidr

CIDR della rete pod. Deve essere almeno /18 o superiore.

Proprietà Valore
Valore predefinito: 10.128.0.0/14
--pull-secret

Segreto pull del cluster.

--service-cidr

CIDR della rete del servizio. Deve essere almeno /18 o superiore.

Proprietà Valore
Valore predefinito: 172.30.0.0/16
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--version

Versione di OpenShift da usare per la creazione del cluster.

--vnet

Nome o ID della rete virtuale. Se viene specificato il nome, --vnet-resource-group è necessario specificare .

--vnet-resource-group

Nome del gruppo di risorse della rete virtuale.

--worker-count

Numero di macchine virtuali di lavoro.

Proprietà Valore
Valore predefinito: 3
--worker-enc-host --worker-encryption-at-host

Crittografia nel flag host per le macchine virtuali di lavoro.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--worker-vm-disk-size-gb

Dimensioni del disco in GB di macchine virtuali di lavoro.

Proprietà Valore
Valore predefinito: 128
--worker-vm-size

Dimensioni delle macchine virtuali del ruolo di lavoro.

Proprietà Valore
Valore predefinito: Standard_D4s_v5
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 posizione predefinito 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 aro delete

Eliminare un cluster.

az aro delete --name
              --resource-group
              [--no-wait]
              [--yes]

Esempio

Eliminare un cluster.

az aro delete --name MyCluster --resource-group MyResourceGroup

Parametri necessari

--name -n

Nome del cluster.

--resource-group -g

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

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.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--yes -y

Non richiedere conferma.

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 posizione predefinito 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 aro get-admin-kubeconfig

Elencare l'amministratore kubeconfig di un cluster.

az aro get-admin-kubeconfig --name
                            --resource-group
                            [--file]

Esempio

Elencare l'amministratore kubeconfig di un cluster. L'impostazione predefinita consiste nel salvarlo in un file denominato "kubeconfig".

az aro get-admin-kubeconfig --name MyCluster --resource-group MyResourceGroup

Parametri necessari

--name -n

Nome del cluster.

--resource-group -g

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

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.

--file -f

Percorso del file in cui deve essere salvato kubeconfig. Impostazione predefinita: kubeconfig nella directory locale.

Proprietà Valore
Valore predefinito: kubeconfig
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 posizione predefinito 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 aro get-versions

Elencare le versioni disponibili per l'installazione.

az aro get-versions --location

Esempio

Elencare le versioni di installazione disponibili per l'area Stati Uniti orientali.

az aro get-versions --location eastus

Elencare le versioni di installazione disponibili per l'area Stati Uniti orientali con output formattato in tabella.

az aro get-versions --location eastus -o table

Parametri necessari

--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

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 posizione predefinito 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 aro list

Elencare i cluster.

az aro list [--resource-group]

Esempio

Elencare i cluster.

az aro list

Elencare i cluster con vista tabella.

az aro list -o table

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.

--resource-group -g

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

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 posizione predefinito 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 aro list-credentials

Elencare le credenziali di un cluster.

az aro list-credentials --name
                        --resource-group

Esempio

Elencare le credenziali di un cluster.

az aro list-credentials --name MyCluster --resource-group MyResourceGroup

Parametri necessari

--name -n

Nome del cluster.

--resource-group -g

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

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 posizione predefinito 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 aro show

Ottenere i dettagli di un cluster.

az aro show --name
            --resource-group

Esempio

Ottenere i dettagli di un cluster.

az aro show --name MyCluster --resource-group MyResourceGroup

Parametri necessari

--name -n

Nome del cluster.

--resource-group -g

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

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 posizione predefinito 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 aro update

Aggiornare un cluster.

az aro update --name
              --resource-group
              [--client-id]
              [--client-secret]
              [--lb-ip-count --load-balancer-managed-outbound-ip-count]
              [--no-wait]
              [--refresh-credentials {false, true}]

Esempio

Aggiornare un cluster.

az aro update --name MyCluster --resource-group MyResourceGroup

Parametri necessari

--name -n

Nome del cluster.

--resource-group -g

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

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.

--client-id

ID client dell'entità servizio del cluster.

--client-secret

Segreto client dell'entità servizio del cluster.

--lb-ip-count --load-balancer-managed-outbound-ip-count

Numero desiderato di indirizzi IP in uscita IPv4 creati e gestiti da Azure per il servizio di bilanciamento del carico pubblico del cluster.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--refresh-credentials

Aggiornare le credenziali dell'applicazione cluster.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
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 posizione predefinito 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 aro validate

Convalidare le autorizzazioni necessarie per creare un cluster.

az aro validate --master-subnet
                --name
                --resource-group
                --worker-subnet
                [--client-id]
                [--client-secret]
                [--cluster-resource-group]
                [--disk-encryption-set]
                [--location]
                [--pod-cidr]
                [--service-cidr]
                [--version]
                [--vnet]
                [--vnet-resource-group]

Esempio

Convalidare le autorizzazioni.

az aro validate --resource-group MyGroup --name MyName --vnet MyVnet --master-subnet MyMasterSubnet --worker-subnet MyWorkerSubnet

Convalidare le autorizzazioni e la versione di OpenShift

az aro validate --resource-group MyGroup --name MyName --vnet MyVnet --master-subnet MyMasterSubnet --worker-subnet MyWorkerSubnet --version X.Y.Z

Parametri necessari

--master-subnet

Nome o ID della subnet della rete virtuale master. Se viene specificato il nome, --vnet è necessario specificare .

--name -n

Nome del cluster.

--resource-group -g

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

--worker-subnet

Nome o ID della subnet della rete virtuale del ruolo di lavoro. Se viene specificato il nome, --vnet è necessario specificare .

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.

--client-id

ID client dell'entità servizio del cluster.

--client-secret

Segreto client dell'entità servizio del cluster.

--cluster-resource-group

Gruppo di risorse del cluster.

--disk-encryption-set

ResourceID dell'oggetto DiskEncryptionSet da usare per le macchine virtuali master e di lavoro.

--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--pod-cidr

CIDR della rete pod. Deve essere almeno /18 o superiore.

--service-cidr

CIDR della rete del servizio. Deve essere almeno /18 o superiore.

--version

Versione di OpenShift da usare per la creazione del cluster.

--vnet

Nome o ID della rete virtuale. Se viene specificato il nome, --vnet-resource-group è necessario specificare .

--vnet-resource-group

Nome del gruppo di risorse della rete virtuale.

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 posizione predefinito 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 aro wait

Attendere che un cluster raggiunga uno stato desiderato.

Se un'operazione in un cluster è stata interrotta o è stata avviata con --no-wait, usare questo comando per attendere il completamento.

az aro wait --name
            --resource-group
            [--created]
            [--custom]
            [--deleted]
            [--exists]
            [--interval]
            [--timeout]
            [--updated]

Parametri necessari

--name -n

Nome del cluster.

--resource-group -g

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

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.

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
--deleted

Attendere l'eliminazione.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--exists

Attendere che la risorsa esista.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--interval

Intervallo di polling in secondi.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: 30
--timeout

Attesa massima in secondi.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
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 posizione predefinito 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