Condividi tramite

az aro

  • Riferimento

Gestire i cluster Azure Red Hat OpenShift.

Comandi

Nome Descrizione Tipo Status
az aro create

Creare un cluster.

 Nucleo GA
az aro delete

Eliminare un cluster.

 Nucleo GA
az aro get-admin-kubeconfig

Elencare l'amministratore kubeconfig di un cluster.

 Nucleo GA
az aro get-versions

Elencare le versioni disponibili per l'installazione.

 Nucleo GA
az aro list

Elencare i cluster.

 Nucleo GA
az aro list-credentials

Elencare le credenziali di un cluster.

 Nucleo GA
az aro show

Ottenere i dettagli di un cluster.

 Nucleo GA
az aro update

Aggiornare un cluster.

 Nucleo GA
az aro validate

Convalidare le autorizzazioni necessarie per creare un cluster.

 Nucleo GA
az aro wait

Attendere che un cluster raggiunga uno stato desiderato.

 Nucleo GA

az aro create

Modifica

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

--apiserver-visibility

Visibilità del server API.

Valori accettati: Private, Public
Valore predefinito: 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.

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

Usare i moduli di crittografia convalidati FIPS.

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

Visibilità in ingresso.

Valori accettati: Private, Public
Valore predefinito: 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

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

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

Dimensioni delle macchine virtuali master.

Valore predefinito: Standard_D8s_v5
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False
--outbound-type

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

Valore predefinito: Loadbalancer
--pod-cidr

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

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.

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.

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

Crittografia nel flag host per le macchine virtuali di lavoro.

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

Dimensioni del disco in GB di macchine virtuali di lavoro.

Valore predefinito: 128
--worker-vm-size

Dimensioni delle macchine virtuali del ruolo di lavoro.

Valore predefinito: Standard_D4s_v5
Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro delete

Modifica

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

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False
--yes -y

Non richiedere conferma.

Valore predefinito: False
Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro get-admin-kubeconfig

Modifica

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

--file -f

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

Valore predefinito: kubeconfig
Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro get-versions

Modifica

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

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro list

Modifica

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

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro list-credentials

Modifica

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.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro show

Modifica

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.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro update

Modifica

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

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

Valore predefinito: False
--refresh-credentials

Aggiornare le credenziali dell'applicazione cluster.

Valori accettati: false, true
Valore predefinito: False
Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro validate

Modifica

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

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

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.

az aro wait

Modifica

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

--created

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

Valore predefinito: False
--custom

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

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

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

Valore predefinito: False
Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 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.