Tutorial: Creación de un clúster de la versión 4 de Red Hat OpenShift en AzureTutorial: Create an Azure Red Hat OpenShift 4 cluster

En este tutorial, el primero de un conjunto de tres, preparará el entorno para crear clústeres de Red Hat OpenShift en Azure que ejecute OpenShift 4 y creará un clúster.In this tutorial, part one of three, you'll prepare your environment to create an Azure Red Hat OpenShift cluster running OpenShift 4, and create a cluster. Aprenderá a:You will learn how to:

  • Configurar los requisitos previos y crear la red virtual y las subredes necesarias.Setup the prerequisites and create the required virtual network and subnets
  • Implementación de un clústerDeploy a cluster

Antes de empezarBefore you begin

Si decide instalar y usar la CLI de forma local, en este tutorial es preciso que ejecute la CLI de Azure de la versión 2.6.0, u otra posterior.If you choose to install and use the CLI locally, this tutorial requires that you are running the Azure CLI version 2.6.0 or later. Ejecute az --version para encontrar la versión.Run az --version to find the version. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.If you need to install or upgrade, see Install Azure CLI.

Red Hat OpenShift en Azure requiere 40 núcleos como mínimo para crear y ejecutar un clúster de OpenShift.Azure Red Hat OpenShift requires a minimum of 40 cores to create and run an OpenShift cluster. La cuota predeterminada de recursos de Azure para una suscripción nueva de Azure no cumple este requisito.The default Azure resource quota for a new Azure subscription does not meet this requirement. Para solicitar un aumento del límite de recursos, consulte Cuota estándar: Aumento de los límites por serie de máquinas virtuales.To request an increase in your resource limit, see Standard quota: Increase limits by VM series.

Comprobación de los permisosVerify your permissions

Para crear un clúster de Red Hat OpenShift en Azure, compruebe los siguientes permisos en la suscripción de Azure, el usuario de Azure Active Directory o la entidad de servicio:To create an Azure Red Hat OpenShift cluster, verify the following permissions on your Azure subscription, Azure Active Directory user, or service principal:

PermisosPermissions Grupo de recursos que contiene la red virtualResource Group which contains the VNet El usuario que ejecuta az aro createUser executing az aro create Entidad de servicio que se pasa como –client-idService Principal passed as –client-id
Administrador de acceso de usuarioUser Access Administrator XX XX
ColaboradorContributor XX XX XX

Registro de los proveedores de recursosRegister the resource providers

  1. Si tiene varias suscripciones de Azure, especifique el identificador de la relevante:If you have multiple Azure subscriptions, specify the relevant subscription ID:

    az account set --subscription <SUBSCRIPTION ID>
    
  2. Registre el proveedor de recursos Microsoft.RedHatOpenShift:Register the Microsoft.RedHatOpenShift resource provider:

    az provider register -n Microsoft.RedHatOpenShift --wait
    
  3. Registre el proveedor de recursos Microsoft.Compute:Register the Microsoft.Compute resource provider:

    az provider register -n Microsoft.Compute --wait
    
  4. Registre el proveedor de recursos Microsoft.Storage:Register the Microsoft.Storage resource provider:

    az provider register -n Microsoft.Storage --wait
    

Obtención de un secreto de extracción de Red Hat (opcional)Get a Red Hat pull secret (optional)

Los secretos de extracción de Red Hat permiten al clúster acceder a los registros de contenedor de Red Hat junto con contenido adicional.A Red Hat pull secret enables your cluster to access Red Hat container registries along with additional content. Este paso es opcional pero recomendable.This step is optional but recommended.

  1. Vaya al portal del administrador de clústeres de Red Hat OpenShift e inicie sesión.Navigate to your Red Hat OpenShift cluster manager portal and log in.

    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.You will need to log in to your Red Hat account or create a new Red Hat account with your business email and accept the terms and conditions.

  2. Vaya a la página del producto OpenShift, si es la primera vez que crea un clúster.Go to the OpenShift product page if this is your first time creating a cluster. Después del registro, vaya a la página del administrador de clústeres de Red Hat OpenShift, donde puede hacer clic en Download pull secret (Descargar el secreto de extracción) y descargar un secreto de extracción para usarlo con el clúster de ARO.After registration, head to Red Hat OpenShift Cluster Manager page, where you can click Download pull secret and download a pull secret to be used with your ARO cluster.

Mantenga el archivo de pull-secret.txt guardado en algún lugar seguro.Keep the saved pull-secret.txt file somewhere safe. 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.The file will be used in each cluster creation if you need to create a cluster that includes samples or operators for Red Hat or certified partners.

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.When running the az aro create command, you can reference your pull secret using the --pull-secret @pull-secret.txt parameter. Ejecute az aro create desde el directorio donde haya almacenado el archivo pull-secret.txt.Execute az aro create from the directory where you stored your pull-secret.txt file. De lo contrario, reemplace @pull-secret.txt por @<path-to-my-pull-secret-file>.Otherwise, replace @pull-secret.txt with @<path-to-my-pull-secret-file>.

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.If you are copying your pull secret or referencing it in other scripts, your pull secret should be formatted as a valid JSON string.

Preparación de un dominio personalizado para el clúster (opcional)Prepare a custom domain for your cluster (optional)

Al ejecutar el comando az aro create, puede especificar un dominio personalizado para el clúster mediante el parámetro --domain foo.example.com.When running the az aro create command, you can specify a custom domain for your cluster by using the --domain foo.example.com parameter.

Si proporciona un dominio personalizado para el clúster, tenga en cuenta los siguientes puntos:If you provide a custom domain for your cluster note the following points:

  • Después de crear el clúster, debe crear dos registros de DNS A en el servidor DNS para el --domain especificado:After creating your cluster, you must create 2 DNS A records in your DNS server for the --domain specified:

    • API: apunta al servidor de APIapi - pointing to the api server
    • *.apps: apunta a la entrada*.apps - pointing to the ingress
    • Para recuperar estos valores, ejecute el comando siguiente: az aro show -n -g --query '{api:apiserverProfile.ip, ingress:ingressProfiles[0].ip}'.Retrieve these values by executing the following command: 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.foo.example.com, en lugar del dominio integrado https://console-openshift-console.apps.<random>.<location>.aroapp.io.The OpenShift console will be available at a URL such as https://console-openshift-console.apps.foo.example.com, instead of the built-in domain https://console-openshift-console.apps.<random>.<location>.aroapp.io.

  • De forma predeterminada, OpenShift usa certificados autofirmados para todas las rutas creadas en *.apps.<random>.<location>.aroapp.io.By default, OpenShift uses self-signed certificates for all of the routes created on *.apps.<random>.<location>.aroapp.io. 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.If you choose to use custom DNS after connecting to the cluster, you will need to follow the OpenShift documentation to configure a custom CA for your ingress controller and a custom CA for your API server.

Creación de una red virtual que contenga dos subredes vacíasCreate a virtual network containing two empty subnets

A continuación, creará una red virtual que contenga dos subredes vacías.Next, you will create a virtual network containing two empty subnets.

  1. Establezca las siguientes variables en el entorno de shell en el que se ejecutarán los comandos az.Set the following variables in the shell environment in which you will execute the az commands.

    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
    
  2. Cree un grupo de recursos. .Create a resource group.

Un grupo de recursos de Azure es un grupo lógico en el que se implementan y administran recursos de Azure.An Azure resource group is a logical group in which Azure resources are deployed and managed. Cuando se crea un grupo de recursos, se le pide que especifique una ubicación.When you create a resource group, you are asked to specify a location. Dicha ubicación es donde se almacenan los metadatos del grupo de recursos, así como el lugar en el que los recursos se ejecutan en Azure si no se especifica otra región al crear los recursos.This location is where resource group metadata is stored, it is also where your resources run in Azure if you don't specify another region during resource creation. Cree un grupo de recursos con el comando az group create.Create a resource group using the az group create command.

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.Azure Red Hat OpenShift is not available in all regions where an Azure resource group can be created. Consulte Regiones disponibles para obtener información sobre dónde se admite Red Hat OpenShift en Azure.See Available regions for information on where Azure Red Hat OpenShift is supported.

az group create \
  --name $RESOURCEGROUP \
  --location $LOCATION

En la siguiente salida de ejemplo se muestra que los recursos se crearon correctamente:The following example output shows the resource group created successfully:

    {
    "id": "/subscriptions/<guid>/resourceGroups/aro-rg",
    "location": "eastus",
    "managedBy": null,
    "name": "aro-rg",
    "properties": {
        "provisioningState": "Succeeded"
    },
    "tags": null
    }
  1. Cree una red virtual.Create a virtual network.

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.Azure Red Hat OpenShift clusters running OpenShift 4 require a virtual network with two empty subnets, for the master and worker nodes.

Cree una red virtual en el mismo grupo de recursos que creó anteriormente:Create a new virtual network in the same resource group you created earlier:

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:The following example output shows the virtual network created successfully:

    {
    "newVNet": {
        "addressSpace": {
        "addressPrefixes": [
            "10.0.0.0/22"
        ]
        },
        "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"
    }
    }
  1. Agregue una subred vacía para los nodos maestros.Add an empty subnet for the master nodes.

    az network vnet subnet create \
    --resource-group $RESOURCEGROUP \
    --vnet-name aro-vnet \
    --name master-subnet \
    --address-prefixes 10.0.0.0/23 \
    --service-endpoints Microsoft.ContainerRegistry
    
  2. Agregue una subred vacía para los nodos de trabajo.Add an empty subnet for the worker nodes.

    az network vnet subnet create \
    --resource-group $RESOURCEGROUP \
    --vnet-name aro-vnet \
    --name worker-subnet \
    --address-prefixes 10.0.2.0/23 \
    --service-endpoints Microsoft.ContainerRegistry
    
  3. Deshabilite las directivas de punto de conexión privado en la subred maestra.Disable subnet private endpoint policies on the master subnet. Esto es necesario para poder conectarse al clúster y administrarlo.This is required to be able to connect and manage the cluster.

    az network vnet subnet update \
    --name master-subnet \
    --resource-group $RESOURCEGROUP \
    --vnet-name aro-vnet \
    --disable-private-link-service-network-policies true
    

Creación del clústerCreate the cluster

Ejecute el siguiente comando para crear un clúster.Run the following command to create a cluster. Si decide usar cualquiera de las siguientes opciones, modifique el comando según corresponda:If you choose to use either of the following options, modify the command accordingly:

  • 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 contenido adicional.Optionally, you can pass your Red Hat pull secret which enables your cluster to access Red Hat container registries along with additional content. Agregue el argumento --pull-secret @pull-secret.txt al comando.Add the --pull-secret @pull-secret.txt argument to your command.
  • Si lo desea, puede usar un dominio personalizado.Optionally, you can use a custom domain. Agregue el argumento --domain foo.example.com al comando, reemplazando foo.example.com por su propio dominio personalizado.Add the --domain foo.example.com argument to your command, replacing foo.example.com with your own custom domain.

Nota

Si va a agregar argumentos opcionales al comando, asegúrese de cerrar el argumento de la línea anterior del comando con una barra diagonal inversa al final.If you're adding any optional arguments to your command, be sure to close the argument on the preceding line of the command with a trailing backslash.

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 35 minutos en crear un clúster.After executing the az aro create command, it normally takes about 35 minutes to create a cluster.

Pasos siguientesNext steps

En esta parte del tutorial, ha aprendido a:In this part of the tutorial, you learned how to:

  • Configurar los requisitos previos y crear la red virtual y las subredes necesariasSet up the prerequisites and create the required virtual network and subnets
  • Implementación de un clústerDeploy a cluster

Avance hasta el siguiente tutorial:Advance to the next tutorial: