

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Opciones de instalación
<a name="installation-options"></a>

Existen dos formas principales de instalar Red Hat OpenShift en: AWS
+ Infraestructura aprovisionada por el instalador (IPI): el usuario brinda la información básica (como el número de máquinas del plano de control) y puede elegir los valores predeterminados para la mayoría de las preguntas. El OpenShift Servicio de Red Hat en la utilidad de línea de AWS comandos (`rosa`CLI) se puede colocar en una estructura IPI, como se explica en la siguiente sección.
+ Infraestructura aprovisionada por el usuario (UPI): todos los componentes de la infraestructura, como el servidor de nombres de dominio (DNS), las nubes privadas virtuales de Amazon (VPCs), las máquinas de arranque y los planos de control, se crean manualmente y Red Hat OpenShift se instala sobre esa infraestructura.

Ambas configuraciones utilizan el mismo programa de instalación (`install-config.yaml`), que instala los componentes en función de los destinos y las dependencias. Cada destino tiene sus propias dependencias, por lo que el programa puede admitir varios destinos en paralelo y garantizar que el destino pueda ejecutar el clúster correctamente. En el siguiente diagrama, se muestran algunos de los destinos y las dependencias.

![Objetivos y dependencias de Red Hat OpenShift AWS](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/red-hat-openshift-on-aws-implementation/images/targets-dependencies.png)


## Ventajas y desventajas de cada enfoque
<a name="adv-disadv"></a>


****  

| Infraestructura aprovisionada por el instalador (IPI) | Infraestructura aprovisionada por el usuario (UPI) | 
| --- | --- | 
| Fácil de instalar. | Complejo; la configuración lleva algún tiempo. | 
| No ofrece muchas opciones de personalización. | Puede personalizar la topología y toda la infraestructura. | 
| Soportes AWS y otras opciones de nube pública. | Soportes VMware y sistemas básicos, así como AWS otras opciones de nube. | 
| Crea todos los componentes de la infraestructura, incluidos los equilibradores de carga y las redes virtuales. | Se puede utilizar cuando la plataforma subyacente no cumple con todos los requisitos. (Por ejemplo, los sistemas bare metal no ofrecen equilibradores de carga) | 
| Altamente automatizado. | Requiere que cree toda la capa de automatización para aprovisionar la infraestructura subyacente. Puede utilizar AWS CloudFormation plantillas para este propósito. | 
| Las comprobaciones de requisitos previos son fáciles de realizar. | Los requisitos previos deben validarse cuidadosamente. | 

## Por ejemplo, mediante la CLI `rosa`
<a name="ipi-example1"></a>

Red Hat OpenShift Service on AWS implementa una instalación de tipo IPI, pero ofrece ventajas adicionales. Utilice la `rosa` CLI para administrar (actualizar, eliminar o aprovisionar) un AWS clúster y recursos de Red Hat OpenShift on. Para obtener más información, consulte la [ OpenShift documentación de Red Hat](https://docs.openshift.com/rosa/rosa_getting_started/rosa-getting-started.html). 

Para aprovisionar un OpenShift clúster de Red Hat AWS, primero instale la `rosa` CLI y asegúrese de que AWS Command Line Interface (AWS CLI) apunte a su AWS cuenta. Puede entonces utilizar la CLI `rosa` para realizar validaciones y aprovisionar el clúster mediante comandos similares a los siguientes.

```
rosa verify permissions [arguments]
rosa download oc

rosa verify quota [arguments]
rosa init --token=<token> 
rosa create cluster --cluster-name=<cluster_name>
```

Una vez aprovisionado el clúster, puede verificarlo mediante OpenShift comandos.

```
oc get nodes (list all nodes if connected to cluster)
oc get ns (list all namespaces)
```

Para obtener más información, consulte la [Documentación de OpenShift ](https://docs.openshift.com/rosa/cli_reference/openshift_cli/getting-started-cli.html). 

Algunos de los beneficios de utilizar este método incluyen:
+ Es fácil de configurar y aprovisionar rápidamente el clúster en AWS.
+ Brinda información de registro y facilita la resolución de problemas si algo sale mal.
+ Puede validar los requisitos previos mediante la línea de comandos.
+ También se puede utilizar para eliminar elementos y otras operaciones.

Algunas posibles preocupaciones incluyen:
+ Las opciones de personalización pueden ser limitadas.
+ Requiere la `rosa` CLI y otra configuración básica. AWS CLI
+ Todos los desafíos del IPI también se aplican al uso de la CLI `rosa`.

## Ejemplo de IPI: uso de `openshift-install`
<a name="ipi-example2"></a>

`openshift-install` es una utilidad de línea de comandos que puede utilizar para crear un clúster rápidamente. Este comando aporta cierta flexibilidad mediante modificaciones en el archivo `install-config.yaml`. En esta sección, se comparten los pasos generales para el uso de la utilidad. Para ver los pasos de instalación detallados, consulte la [OpenShift documentación](https://docs.openshift.com/container-platform/4.6/installing/installing_aws/installing-aws-default.html).

1. Puede obtener el instalador en el [sitio web de Red Hat](https://console.redhat.com/openshift/install) (requiere una cuenta de Red Hat).

1. Descomprima el paquete. 

   ```
   tar xvf openshift-install-linux.tar.gz
   ```

1. Identifique el directorio de instalación y ejecute el comando `create cluster`.

   ```
   ./openshift-install create cluster --dir <installation_directory> --log-level=info
   ```

1. Para personalizar la instalación, genere el archivo `install-config.yaml`.

   ```
   ./openshift-install create install-config --dir <installation_directory>
   ```

A continuación, se muestra un fragmento de un archivo `install-config.yaml` de ejemplo. Para ver las opciones de configuración, consulte la [OpenShift documentación](https://docs.openshift.com/container-platform/4.7/installing/installing_aws/installing-aws-customizations.html).

```
      apiVersion: v1
baseDomain: sample.com 
credentialsMode: Mint 
controlPlane:   
  hyperthreading: Enabled 
  name: master
  platform:
    aws:
      zones:
      - us-east-2a
      - us-east-2b
      rootVolume:
        iops: 4000
        size: 500
        type: io1 
      type: m5.xlarge
  replicas: 3
compute: 
- hyperthreading: Enabled 
  name: worker
  platform:
    aws:
      rootVolume:
        iops: 2000
        size: 500
        type: io1 
      type: c5.4xlarge
      zones:
      - us-east-2c
  replicas: 3
metadata:
  name: sample-cluster 
networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16
  networkType: OpenShiftSDN
  serviceNetwork:
  - 172.30.0.0/16
platform:
  aws:
    region: us-west-2 
    userTags:
      adminContact: jdoe
      costCenter: 7536
    amiID: ami-96c6f8f7 
    serviceEndpoints: 
      - name: ec2
        url: https://vpce-id.ec2.us-west-2.vpce.amazonaws.com
fips: false 
sshKey: ssh-ed25519 AAAA... 
pullSecret: '{"auths": ...}'
```

## Ejemplo de UPI: instalación en una infraestructura aprovisionada por el usuario AWS
<a name="upi-example"></a>

Puede aprovisionar un OpenShift clúster de Red Hat en una AWS infraestructura existente que aprovisione por separado. Para aprovisionar la infraestructura, puede usar CloudFormation plantillas para crear la VPC, la zona alojada, los registros DNS y otros componentes. Para ver los pasos y CloudFormation las plantillas detallados, consulte la [OpenShift documentación](https://docs.redhat.com/en/documentation/openshift_container_platform/4.1/html/installing/installing-on-user-provisioned-aws).

Cuando se haya aprovisionado el clúster, debe aprobar todas las solicitudes de firma de certificados (CSRs) para mover los nodos de trabajo a un `Ready` estado.

```
oc get nodes

NAME      STATUS    ROLES   AGE  VERSION
master-0  Ready     master  63m  v1.13.4+b626c2fe1
master-1  Ready     master  63m  v1.13.4+b626c2fe1
master-2  Ready     master  64m  v1.13.4+b626c2fe1
worker-0  NotReady  worker  76s  v1.13.4+b626c2fe1
worker-1  NotReady  worker  70s  v1.13.4+b626c2fe1
```

Puede aprobar todos los certificados en un solo paso mediante el siguiente comando.

```
    oc get csr -ojson | jq -r '.items[] | select(.status == {} ) | .metadata.name' | xargs oc adm certificate approve
```

Puede comprobar que todos los operadores están en el estado `Ready` mediante la línea de comandos `oc` o la consola de Red Hat.

Después de la verificación, puede eliminar los recursos de arranque. Puedes determinarlo `stack-name` a partir del Consola de administración de AWS nombre que proporcionaste al crear la pila y a partir del nombre que proporcionaste.

```
aws cloudformation delete-stack --stack-name <name> 
```

Termine de aprovisionar el clúster mediante el comando siguiente.

```
./openshift-install --dir=<installation_directory> wait-for install-complete 

INFO Waiting up to 30m0s for the cluster to initialize...
```

Asegúrese de revisar los registros y confirmar que no haya errores antes de entregar el clúster a las partes interesadas.