Compartir a través de


az aro

Administración de clústeres de Red Hat OpenShift en Azure.

Comandos

Nombre Description Tipo Estado
az aro create

Cree un clúster.

Core GA
az aro delete

Elimine un clúster.

Core GA
az aro get-admin-kubeconfig

Enumerar kubeconfig de administrador de un clúster.

Core GA
az aro get-versions

Enumera las versiones disponibles para la instalación.

Core GA
az aro list

List clusters.

Core GA
az aro list-credentials

Enumerar las credenciales de un clúster.

Core GA
az aro show

Obtenga los detalles de un clúster.

Core GA
az aro update

Actualizar un clúster.

Core GA
az aro validate

Valide los permisos necesarios para crear un clúster.

Core GA
az aro wait

Espere a que un clúster alcance un estado deseado.

Core GA

az aro create

Cree un clúster.

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]

Ejemplos

Cree un clúster.

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

Cree un clúster con una versión compatible de OpenShift.

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

Cree un clúster con 5 nodos de proceso y un secreto de extracción de 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

Cree un clúster privado.

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

Parámetros requeridos

--master-subnet

Nombre o identificador de la subred de red virtual maestra. Si se proporciona el nombre, --vnet se debe proporcionar.

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--worker-subnet

Nombre o identificador de la subred de red virtual de trabajo. Si se proporciona el nombre, --vnet se debe proporcionar.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--apiserver-visibility

Visibilidad del servidor de API.

Propiedad Valor
Valor predeterminado: Public
Valores aceptados: Private, Public
--client-id

Identificador de cliente de la entidad de servicio del clúster.

--client-secret

Secreto de cliente de la entidad de servicio del clúster.

--cluster-resource-group

Grupo de recursos del clúster.

--disk-encryption-set

ResourceID del objeto DiskEncryptionSet que se usará para las máquinas virtuales maestras y de trabajo.

--domain

Dominio del clúster.

--enable-preconfigured-nsg

Use grupos de seguridad de red preconfigurados.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--fips --fips-validated-modules

Use módulos de criptografía validados por FIPS.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--ingress-visibility

Ingress visibility.

Propiedad Valor
Valor predeterminado: Public
Valores aceptados: Private, Public
--lb-ip-count --load-balancer-managed-outbound-ip-count

Número deseado de direcciones IP de salida IPv4 creadas y administradas por Azure para el equilibrador de carga público del clúster.

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

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

Cifrado en la marca de host para máquinas virtuales maestras.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--master-vm-size

Tamaño de las máquinas virtuales maestras.

Propiedad Valor
Valor predeterminado: Standard_D8s_v5
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--outbound-type

Tipo de clúster saliente. Debe ser "Loadbalancer" o "UserDefinedRouting".

Propiedad Valor
Valor predeterminado: Loadbalancer
--pod-cidr

CIDR de la red de pods. Debe ser un mínimo de /18 o superior.

Propiedad Valor
Valor predeterminado: 10.128.0.0/14
--pull-secret

Secreto de extracción del clúster.

--service-cidr

CIDR de la red de servicio. Debe ser un mínimo de /18 o superior.

Propiedad Valor
Valor predeterminado: 172.30.0.0/16
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--version

Versión de OpenShift que se usará para la creación del clúster.

--vnet

Nombre o identificador de la red virtual. Si se proporciona el nombre, --vnet-resource-group se debe proporcionar.

--vnet-resource-group

Nombre del grupo de recursos de red virtual.

--worker-count

Recuento de máquinas virtuales de trabajo.

Propiedad Valor
Valor predeterminado: 3
--worker-enc-host --worker-encryption-at-host

Cifrado en la marca de host para máquinas virtuales de trabajo.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--worker-vm-disk-size-gb

Tamaño del disco en GB de máquinas virtuales de trabajo.

Propiedad Valor
Valor predeterminado: 128
--worker-vm-size

Tamaño de las máquinas virtuales de trabajo.

Propiedad Valor
Valor predeterminado: Standard_D4s_v5
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro delete

Elimine un clúster.

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

Ejemplos

Elimine un clúster.

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

Parámetros requeridos

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro get-admin-kubeconfig

Enumerar kubeconfig de administrador de un clúster.

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

Ejemplos

Enumerar kubeconfig de administrador de un clúster. El valor predeterminado es guardarlo en un archivo denominado "kubeconfig".

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

Parámetros requeridos

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--file -f

Ruta de acceso al archivo donde se debe guardar kubeconfig. Valor predeterminado: kubeconfig en el directorio local.

Propiedad Valor
Valor predeterminado: kubeconfig
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro get-versions

Enumera las versiones disponibles para la instalación.

az aro get-versions --location

Ejemplos

Enumere las versiones de instalación disponibles para la región Este de EE. UU.

az aro get-versions --location eastus

Enumere las versiones de instalación disponibles para la región Este de EE. UU. con salida con formato de tabla.

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

Parámetros requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro list

List clusters.

az aro list [--resource-group]

Ejemplos

List clusters.

az aro list

Enumeración de clústeres con vista de tabla.

az aro list -o table

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro list-credentials

Enumerar las credenciales de un clúster.

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

Ejemplos

Enumerar las credenciales de un clúster.

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

Parámetros requeridos

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro show

Obtenga los detalles de un clúster.

az aro show --name
            --resource-group

Ejemplos

Obtenga los detalles de un clúster.

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

Parámetros requeridos

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro update

Actualizar un clúster.

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

Ejemplos

Actualizar un clúster.

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

Parámetros requeridos

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--client-id

Identificador de cliente de la entidad de servicio del clúster.

--client-secret

Secreto de cliente de la entidad de servicio del clúster.

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

Número deseado de direcciones IP de salida IPv4 creadas y administradas por Azure para el equilibrador de carga público del clúster.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--refresh-credentials

Actualice las credenciales de la aplicación de clúster.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro validate

Valide los permisos necesarios para crear un clúster.

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]

Ejemplos

Validate permissions.

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

Validación de permisos y versión de OpenShift

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

Parámetros requeridos

--master-subnet

Nombre o identificador de la subred de red virtual maestra. Si se proporciona el nombre, --vnet se debe proporcionar.

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--worker-subnet

Nombre o identificador de la subred de red virtual de trabajo. Si se proporciona el nombre, --vnet se debe proporcionar.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--client-id

Identificador de cliente de la entidad de servicio del clúster.

--client-secret

Secreto de cliente de la entidad de servicio del clúster.

--cluster-resource-group

Grupo de recursos del clúster.

--disk-encryption-set

ResourceID del objeto DiskEncryptionSet que se usará para las máquinas virtuales maestras y de trabajo.

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--pod-cidr

CIDR de la red de pods. Debe ser un mínimo de /18 o superior.

--service-cidr

CIDR de la red de servicio. Debe ser un mínimo de /18 o superior.

--version

Versión de OpenShift que se usará para la creación del clúster.

--vnet

Nombre o identificador de la red virtual. Si se proporciona el nombre, --vnet-resource-group se debe proporcionar.

--vnet-resource-group

Nombre del grupo de recursos de red virtual.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az aro wait

Espere a que un clúster alcance un estado deseado.

Si se interrumpió una operación en un clúster o se inició con --no-wait, use este comando para esperar a que se complete.

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

Parámetros requeridos

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propiedad Valor
Parameter group: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: 30
--timeout

Espera máxima en segundos.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False