Creación de un clúster de Red Hat OpenShift en Azure 4

Artículo
09/13/2024

Red Hat OpenShift en Azure es un servicio de OpenShift administrado que le permite implementar y administrar clústeres rápidamente. En este artículo se muestra cómo implementar un clúster de Red Hat OpenShift en Azure mediante la CLI de Azure o Azure Portal.

CLI de Azure
Azure Portal

Antes de empezar

Si decide instalar y usar la CLI localmente, deberá ejecutar la versión 2.30.0 o posterior de la CLI de Azure. Ejecute az --version para encontrar la versión. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.

Red Hat OpenShift en Azure requiere 40 núcleos como mínimo para crear y ejecutar un clúster de OpenShift. La cuota predeterminada de recursos de Azure de una suscripción nueva de Azure no cumple este requisito. Para solicitar un aumento del límite de recursos, consulte Cuota estándar: Aumento de los límites por serie de máquinas virtuales.

Por ejemplo, para comprobar la cuota de suscripción actual de la SKU "Standard DSv3" de la máquina virtual más pequeña admitida:
```
LOCATION=eastus
az vm list-usage -l $LOCATION \
--query "[?contains(name.value, 'standardDSv3Family')]" \
-o table
```

Comprobación de los permisos

En este tutorial, creará un grupo de recursos que contendrá la red virtual del clúster. Para ello, será necesario que tenga permisos de administrador de acceso de usuario y de colaborador, o permisos de propietario, ya sea directamente en la red virtual o en el grupo de recursos, o bien en la suscripción que lo contenga.

También necesitará suficientes permisos de Microsoft Entra (un usuario miembro del inquilino o un invitado asignado con el rol de Administrador de aplicaciones) para que las herramientas creen una aplicación y una entidad de servicio en su nombre para el clúster. Consulte Miembros e invitados y Asignación de roles de administrador y no administrador a usuarios con Microsoft Entra ID para obtener más información.

Registro de los proveedores de recursos

Si tiene varias suscripciones de Azure, especifique el identificador de la relevante:
```
az account set --subscription <SUBSCRIPTION ID>
```
Registre el proveedor de recursos Microsoft.RedHatOpenShift:
```
az provider register -n Microsoft.RedHatOpenShift --wait
```
Registre el proveedor de recursos Microsoft.Compute:
```
az provider register -n Microsoft.Compute --wait
```
Registre el proveedor de recursos Microsoft.Storage:
```
az provider register -n Microsoft.Storage --wait
```
Registre el proveedor de recursos Microsoft.Authorization:
```
az provider register -n Microsoft.Authorization --wait
```

Obtención de un secreto de extracción de Red Hat (opcional)

Nota:

El secreto de extracción de ARO no cambia el costo de la licencia de RH OpenShift para ARO.

Los secretos de extracción de Red Hat permiten al clúster acceder a los registros de contenedor de Red Hat, junto con otro contenido, como operadores de OperatorHub. Este paso es opcional pero recomendable. Si decidiera agregar el secreto de extracción más adelante, siga estas instrucciones. El campo cloud.openshift.com se quitará del secreto incluso aunque el secreto de extracción contenga ese campo. Este campo habilita una característica de supervisión adicional que envía datos a RedHat y, por tanto, está deshabilitada de manera predeterminada. Para habilitar esta característica, consulte https://docs.openshift.com/container-platform/4.11/support/remote_health_monitoring/enabling-remote-health-reporting.html.

Vaya al portal del administrador de clústeres de Red Hat OpenShift e inicie sesión.

Tendrá que iniciar sesión en su cuenta de Red Hat, o bien crear una cuenta de Red Hat con su correo electrónico empresarial y aceptar los términos y condiciones.
Seleccione Descargar secreto de extracción y descargue el secreto de extracción que se usará con el clúster de ARO.

Mantenga el archivo de pull-secret.txt guardado en algún lugar seguro. El archivo se usará en cada creación de un clúster si necesita crear un clúster que incluya ejemplos u operadores para Red Hat o asociados certificados.

Al ejecutar el comando az aro create, puede hacer referencia al secreto de incorporación de cambios mediante el parámetro --pull-secret @pull-secret.txt. Ejecute az aro create desde el directorio donde haya almacenado el archivo pull-secret.txt. De lo contrario, reemplace @pull-secret.txt por @/path/to/my/pull-secret.txt.

Si va a copiar el secreto de incorporación de cambios o hacer referencia a él en otros scripts, debe tener el formato de una cadena JSON válida.

Preparación de un dominio personalizado para el clúster (opcional)

Al ejecutar el comando az aro create, puede especificar un dominio personalizado para el clúster mediante el parámetro --domain foo.example.com.

Nota:

Aunque agregar un nombre de dominio es opcional al crear un clúster a través de la CLI de Azure, se necesita un nombre de dominio (o un prefijo que se use como parte del nombre DNS generado automáticamente para la consola de OpenShift y los servidores de API) al agregar un clúster a través del portal. Consulte Inicio rápido: Implementación de un clúster de Red Hat OpenShift en Azure mediante Azure Portal para obtener más información.

Si proporciona un dominio personalizado para el clúster, tenga en cuenta los siguientes puntos:

Después de crear el clúster, deberá crear dos registros de DNS A en el servidor DNS para el --domain especificado:
- API: apunta a la dirección IP del servidor de API.
- *.apps: apunta a la dirección IP de entrada.
- Para recuperar estos valores, ejecute el comando siguiente después de la creación del clúster: az aro show -n -g --query '{api:apiserverProfile.ip, ingress:ingressProfiles[0].ip}'.
La consola de OpenShift estará disponible en una dirección URL como https://console-openshift-console.apps.example.com, en lugar del dominio integrado https://console-openshift-console.apps.<random>.<location>.aroapp.io.
De forma predeterminada, OpenShift usa certificados autofirmados para todas las rutas creadas en los dominios personalizados *.apps.example.com. Si decide usar DNS personalizado después de conectarse al clúster, tendrá que seguir la documentación de OpenShift para configurar una entidad de certificación personalizada para el controlador de entrada y una entidad de certificación personalizada para el servidor de API.

Creación de una red virtual que contenga dos subredes vacías

A continuación, creará una red virtual que contenga dos subredes vacías. Si ya tiene una red virtual adaptada a sus necesidades, puede omitir este paso.

Establezca las siguientes variables en el entorno de shell en el que se ejecutarán los comandos az.

LOCATION=eastus                 # the location of your cluster
RESOURCEGROUP=aro-rg            # the name of the resource group where you want to create your cluster
CLUSTER=cluster                 # the name of your cluster

Cree un grupo de recursos. .

Un grupo de recursos de Azure es un grupo lógico en el que se implementan y administran recursos de Azure. Cuando se crea un grupo de recursos, se le pide que especifique una ubicación. Esta ubicación es donde se almacenan los metadatos del grupo de recursos, y es también el lugar en el que los recursos se ejecutan en Azure si no se especifica otra región al crearlos. Cree un grupo de recursos con el comando az group create.

Nota

Red Hat OpenShift en Azure no está disponible en todas las regiones en las que se puede crear un grupo de recursos de Azure. Consulte Regiones disponibles para obtener información sobre dónde se admite Red Hat OpenShift en Azure.
```
az group create \
  --name $RESOURCEGROUP \
  --location $LOCATION
```
En la siguiente salida de ejemplo se muestra que los recursos se crearon correctamente:
```
{
  "id": "/subscriptions/<guid>/resourceGroups/aro-rg",
  "location": "eastus",
  "name": "aro-rg",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.Resources/resourceGroups"
}
```

Cree una red virtual.

Los clústeres de Red Hat OpenShift en Azure que ejecutan OpenShift 4 requieren una red virtual con dos subredes vacías, una para los nodos maestros y otra para los nodos de trabajo. Puede crear una red virtual para ello o usar una ya existente.

Cree una red virtual en el mismo grupo de recursos que creó anteriormente:

az network vnet create \
   --resource-group $RESOURCEGROUP \
   --name aro-vnet \
   --address-prefixes 10.0.0.0/22

En la siguiente salida de ejemplo se muestra la red virtual creada correctamente:

{
  "newVNet": {
    "addressSpace": {
      "addressPrefixes": [
        "10.0.0.0/22"
      ]
    },
    "dhcpOptions": {
      "dnsServers": []
    },
    "id": "/subscriptions/<guid>/resourceGroups/aro-rg/providers/Microsoft.Network/virtualNetworks/aro-vnet",
    "location": "eastus",
    "name": "aro-vnet",
    "provisioningState": "Succeeded",
    "resourceGroup": "aro-rg",
    "type": "Microsoft.Network/virtualNetworks"
  }
}

Agregue una subred vacía para los nodos maestros.

az network vnet subnet create \
  --resource-group $RESOURCEGROUP \
  --vnet-name aro-vnet \
  --name master-subnet \
  --address-prefixes 10.0.0.0/23

Agregue una subred vacía para los nodos de trabajo.

az network vnet subnet create \
  --resource-group $RESOURCEGROUP \
  --vnet-name aro-vnet \
  --name worker-subnet \
  --address-prefixes 10.0.2.0/23

Creación del clúster

Ejecute el siguiente comando para crear un clúster. Si decide usar cualquiera de las siguientes opciones, modifique el comando según corresponda:

Opcionalmente, también puede pasar el secreto de incorporación de cambios de Red Hat, que permite al clúster acceder a los registros de contenedor de Red Hat junto con otro contenido. Agregue el argumento --pull-secret @pull-secret.txt al comando.
Si lo desea, puede usar un dominio personalizado. Agregue el argumento --domain foo.example.com al comando, reemplazando foo.example.com por su propio dominio personalizado.

Nota:

El número máximo de nodos de trabajo que se pueden definir en el momento de la creación es 50. Puede escalar horizontalmente hasta 250 nodos después de crear el clúster.

az aro create \
  --resource-group $RESOURCEGROUP \
  --name $CLUSTER \
  --vnet aro-vnet \
  --master-subnet master-subnet \
  --worker-subnet worker-subnet

Después de ejecutar el comando az aro create, se tarda aproximadamente 45 minutos en crear un clúster.

Clústeres de ARO a gran escala

Si desea implementar un clúster de Red Hat OpenShift en Azure con más de 100 nodos de trabajo, consulte Implementar un clúster de Red Hat OpenShift en Azure grande

Selección de una versión de ARO diferente

Puede seleccionar usar una versión específica de ARO al crear el clúster. En primer lugar, use la CLI para consultar las versiones de ARO disponibles:

az aro get-versions --location <region>

Una vez que haya elegido la versión, especifíquela con el parámetro --version en el comando az aro create:

az aro create \
  --resource-group $RESOURCEGROUP \
  --name $CLUSTER \
  --vnet aro-vnet \
  --master-subnet master-subnet \
  --worker-subnet worker-subnet \
  --version <x.y.z>

Antes de empezar

Inicie sesión en Azure Portal.

Registre el proveedor de recursos Microsoft.RedHatOpenShift. Para obtener instrucciones sobre cómo registrar proveedores de recursos mediante Azure Portal, consulte Registro del proveedor de recursos.