Delen via

az aro

  • Referentie

Azure Red Hat OpenShift-clusters beheren.

Opdracht

Name Description Type Status
az aro create

Een cluster maken.

 Basis GA
az aro delete

Een cluster verwijderen.

 Basis GA
az aro get-admin-kubeconfig

Geef de kubeconfig van een beheerder van een cluster weer.

 Basis GA
az aro get-versions

Lijst met beschikbare versies voor installatie.

 Basis GA
az aro list

Clusters weergeven.

 Basis GA
az aro list-credentials

Geef referenties van een cluster weer.

 Basis GA
az aro show

De details van een cluster ophalen.

 Basis GA
az aro update

Een cluster bijwerken.

 Basis GA
az aro validate

Valideer de vereiste machtigingen voor het maken van een cluster.

 Basis GA
az aro wait

Wacht totdat een cluster de gewenste status heeft bereikt.

 Basis GA

az aro create

Bewerken

Een cluster maken.

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 {false, true}]
              [--ingress-visibility {Private, Public}]
              [--location]
              [--master-enc-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 {false, true}]
              [--worker-vm-disk-size-gb]
              [--worker-vm-size]

Voorbeelden

Een cluster maken.

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

Maak een cluster met een ondersteunde OpenShift-versie.

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

Maak een cluster met 5 rekenknooppunten en Red Hat-pull-geheim.

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

Maak een privécluster.

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

Vereiste parameters

--master-subnet

Naam of id van hoofd-vnetsubnet. Als de naam wordt opgegeven, --vnet moet u deze opgeven.

--name -n

Naam van cluster.

--resource-group -g

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

--worker-subnet

Naam of id van het vnet-subnet van de werkrol. Als de naam wordt opgegeven, --vnet moet u deze opgeven.

Optionele parameters

--apiserver-visibility

Zichtbaarheid van API-server.

geaccepteerde waarden: Private, Public
standaardwaarde: Public
--client-id

Client-id van de service-principal van het cluster.

--client-secret

Clientgeheim van de service-principal van het cluster.

--cluster-resource-group

Resourcegroep van cluster.

--disk-encryption-set

ResourceID van de DiskEncryptionSet die moet worden gebruikt voor hoofd- en werkrol-VM's.

--domain

Domein van cluster.

--enable-preconfigured-nsg

Gebruik vooraf geconfigureerde NSG's. Standaard: Onwaar.

geaccepteerde waarden: false, true
standaardwaarde: False
--fips --fips-validated-modules

Fips gevalideerde cryptografiemodules gebruiken. Standaard: Onwaar.

geaccepteerde waarden: false, true
standaardwaarde: False
--ingress-visibility

Zichtbaarheid van inkomend verkeer.

geaccepteerde waarden: Private, Public
standaardwaarde: Public
--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

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

Versleuteling bij hostvlag voor hoofd-VM's. Standaard: Onwaar.

geaccepteerde waarden: false, true
standaardwaarde: False
--master-vm-size

Grootte van hoofd-VM's.

standaardwaarde: Standard_D8s_v3
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--outbound-type

Uitgaand type cluster. Moet 'Loadbalancer' of 'UserDefinedRouting' zijn.

standaardwaarde: Loadbalancer
--pod-cidr

CIDR van podnetwerk. Moet minimaal /18 of groter zijn.

standaardwaarde: 10.128.0.0/14
--pull-secret

Pull-geheim van cluster.

--service-cidr

CIDR van servicenetwerk. Moet minimaal /18 of groter zijn.

standaardwaarde: 172.30.0.0/16
--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--version

OpenShift-versie die moet worden gebruikt voor het maken van clusters.

--vnet

Naam of id van vnet. Als de naam wordt opgegeven, --vnet-resource-group moet u deze opgeven.

--vnet-resource-group

Naam van vnet-resourcegroep.

--worker-count

Aantal werkrol-VM's.

standaardwaarde: 3
--worker-enc-host --worker-encryption-at-host

Versleuteling bij hostvlag voor werkrol-VM's. Standaard: Onwaar.

geaccepteerde waarden: false, true
standaardwaarde: False
--worker-vm-disk-size-gb

Schijfgrootte in GB van werkrol-VM's.

standaardwaarde: 128
--worker-vm-size

Grootte van werkrol-VM's.

standaardwaarde: Standard_D4s_v3
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 aro delete

Bewerken

Een cluster verwijderen.

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

Voorbeelden

Een cluster verwijderen.

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

Vereiste parameters

--name -n

Naam van cluster.

--resource-group -g

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

Optionele parameters

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--yes -y

Niet vragen om bevestiging.

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

Bewerken

Geef de kubeconfig van een beheerder van een cluster weer.

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

Voorbeelden

Geef de kubeconfig van een beheerder van een cluster weer. De standaardinstelling is om het op te slaan in een bestand met de naam 'kubeconfig'.

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

Vereiste parameters

--name -n

Naam van cluster.

--resource-group -g

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

Optionele parameters

--file -f

Pad naar het bestand waarin kubeconfig moet worden opgeslagen. Standaard: kubeconfig in de lokale map.

standaardwaarde: kubeconfig
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 aro get-versions

Bewerken

Lijst met beschikbare versies voor installatie.

az aro get-versions --location

Voorbeelden

Lijst met installatieversies die beschikbaar zijn voor de regio VS - oost.

az aro get-versions --location eastus

Lijst met installatieversies die beschikbaar zijn voor de regio VS - oost met tabelindeling.

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

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

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

Bewerken

Clusters weergeven.

az aro list [--resource-group]

Voorbeelden

Clusters weergeven.

az aro list

Clusters weergeven met tabelweergave.

az aro list -o table

Optionele parameters

--resource-group -g

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

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

Bewerken

Geef referenties van een cluster weer.

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

Voorbeelden

Geef referenties van een cluster weer.

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

Vereiste parameters

--name -n

Naam van cluster.

--resource-group -g

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

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

Bewerken

De details van een cluster ophalen.

az aro show --name
            --resource-group

Voorbeelden

De details van een cluster ophalen.

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

Vereiste parameters

--name -n

Naam van cluster.

--resource-group -g

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

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

Bewerken

Een cluster bijwerken.

az aro update --name
              --resource-group
              [--client-id]
              [--client-secret]
              [--no-wait]
              [--refresh-credentials {false, true}]

Voorbeelden

Een cluster bijwerken.

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

Vereiste parameters

--name -n

Naam van cluster.

--resource-group -g

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

Optionele parameters

--client-id

Client-id van de service-principal van het cluster.

--client-secret

Clientgeheim van de service-principal van het cluster.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--refresh-credentials

Vernieuw de referenties van de clustertoepassing.

geaccepteerde waarden: false, true
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 aro validate

Bewerken

Valideer de vereiste machtigingen voor het maken van een 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]

Voorbeelden

Valideer machtigingen.

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

Machtigingen en OpenShift-versie valideren

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

Vereiste parameters

--master-subnet

Naam of id van hoofd-vnetsubnet. Als de naam wordt opgegeven, --vnet moet u deze opgeven.

--name -n

Naam van cluster.

--resource-group -g

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

--worker-subnet

Naam of id van het vnet-subnet van de werkrol. Als de naam wordt opgegeven, --vnet moet u deze opgeven.

Optionele parameters

--client-id

Client-id van de service-principal van het cluster.

--client-secret

Clientgeheim van de service-principal van het cluster.

--cluster-resource-group

Resourcegroep van cluster.

--disk-encryption-set

ResourceID van de DiskEncryptionSet die moet worden gebruikt voor hoofd- en werkrol-VM's.

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--pod-cidr

CIDR van podnetwerk. Moet minimaal /18 of groter zijn.

--service-cidr

CIDR van servicenetwerk. Moet minimaal /18 of groter zijn.

--version

OpenShift-versie die moet worden gebruikt voor het maken van clusters.

--vnet

Naam of id van vnet. Als de naam wordt opgegeven, --vnet-resource-group moet u deze opgeven.

--vnet-resource-group

Naam van vnet-resourcegroep.

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

Bewerken

Wacht totdat een cluster de gewenste status heeft bereikt.

Als een bewerking op een cluster is onderbroken of is --no-waitgestart, gebruikt u deze opdracht om te wachten tot deze is voltooid.

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

Vereiste parameters

--name -n

Naam van cluster.

--resource-group -g

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

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

standaardwaarde: False
--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat deze is verwijderd.

standaardwaarde: False
--exists

Wacht tot de resource bestaat.

standaardwaarde: False
--interval

Polling-interval in seconden.

standaardwaarde: 30
--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600
--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

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.