# Rancher

**Requisitos:**
- Ingresar a tu plataforma de _Rancher_

## Como crear un cluster
Una vez que hayas ingresado a la plataforma de _Rancher_ te redireccionará a la ruta principal donde se encuentra la lista de los clusters.


Para crear un nuevo cluster deberás dar clic sobre el botón _Add Cluster_.

Al dar clic en el botón _Add Cluster_ te llevará a una nueva ruta en donde te pedirá que selecciones el tipo de _Cluster_ que debes, en este caso selecciona _Amazon EC2_.

Al seleccionar _Amazon EC2_ te llevará a una ruta donde deberás colocar la información del Cluster.

En la primera sección deberás ingresar el nombre del Cluster, así como deberás ingresar los nodos de tu Cluster.


Para los nodos deberás seguir la siguiente convención:
- Para los nodos _master_, deberás ingresar: `<identificador-cluster>-master-<letra-zona-disponibilidad>-`
- Para los nodos _workers_, deberás ingresar: `<identificador-cluster>-worker-<letra-zona-disponibilidad>-`

En ambos casos, Rancher agregará un índice al final de cada nodo. Si quieres saber más acerca de las zonas de dispobilidad, visita la documentación de [AWS Regiones y Zonas de Disponibilidad](https://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/using-regions-availability-zones.html)

Una vez que ingreses el nombre, deberás seleccionar el _template_ del nodo. Además, deberás seleccionar el tipo de recurso a crear, en caso de un _Master_ deberás seleccionar:
- etcd
- Control pane

En el caso de un _Worker_ solo deberás seleccionar:
- Worker


Para agregar un nuevo nodo, da clic sobre el botón _Add Node Pool_.


Posteriormente, iremos a la sección de _Cluster Options_. Donde nos enfocaremos en dos puntos:
- Network provider: Aquí seleccionaremos la opción _Canal_
- Cloud Provider: Seleccionaremos _Amazon (In Tree)_


Por último, iremos a la sección de _Advanced options_, dentro de esta sección, identificaremos _etcd Snapshot Backup Target_ y seleccionaremos la opción de _s3_.


Después de seleccionar _s3_ se desplegaran algunas opciones para llenar la configuración del bucket _s3_.

Una vez que hayas llenado la configuración podrás crear el Cluster, para ello ve al final de la página y da clic en _Create_.


Posteriormente, _Rancher_ te redireccionará a la página principal, en donde podrás ver la información de tu cluster, el cual tardará algunos minutos en crearse.

## Como crear un node template (Master y Worker)
Para crear un _node template_, primero deberás acceder a tu cuenta, una vez que estes dentro de la plataforma de _Rancher_, da clic sobre el icono de tu avatar en la parte superior derecha y despliega el menú.


Posteriormente, selecciona la opción _Node Templates_.


Una vez que hayas seleccionado _Node Templates_ te redigirá a una página donde encontrarás la lista de todos los _Nodes Templates_. Para crear un nuevo _Node Template_ da clic en el botón _Add Template_.


Una vez que des clic sobre el botón _Add Template_ se abrirá una ventana de _Add Node Template_, dentro de ella deberás seleccionar el proveedor de Cloud que utilizarás para agregar los nodos, en este caso selecciona _Amazon EC2_.

Además, te pedirá la información de acceso de _Amazon EC2_, ahí deberás seleccionar la región _us-east-1_ y en las te pedirá que selecciones tus credenciales de acceso a _AWS_, en caso de que aún NO tengas una credencial asociada deberñas seleccionar _Add New_.

Una vez que tengas la información de la región y las credenciales, da clic en _Next_.


Posteriormente, se te pedirá información acerca de _Zone and Network_, ahí deberás seleccionar la _Zona de disponibilidad_ y seleccionar una _VPC_.


Una vez que hayas seleccionado la información, da clic en el botón de _Next_.

Posteriormente, iremos a la sección de _Security Groups_, en esta sección se desplegarán dos opciones:
- Standard
- Choose one group

En este caso seleccionaremos la opción _Standard_ y daremos clic en el botón de _Next_.

Por último, ingresaremos la información de la sección _Instance_, dentro de esta sección nos enfocaremos en 4 puntos:
- Instance Type
- AMI
- IAM Instance Profile Name
- Name


Comencemos con _Instance Type_, en esta opción deberemos elegir un tipo de instancia para nuestro nodo, es decir, que tipo de instancia EC2 queremos seleccionar. Aquí hay dos opciones:
- Master node: Selecciona _t3.medium_
- Worker node: Selecciona _t3.large_

Después, en la parte de _AMI_ deberás ingresar un código _AMI_, puedes seleccionar un valor de _AMI_ directamente de la lista de _RancherOS_ pero no es lo más recomendable, debido a que contiene algunos errores.

Lo mejor será ir a la consola de AWS y seleccionar un _AMI_ de _AWS_. Para ello ingresa en AWS > EC2 > Instances New > Launch Instances. Dentro de esta ventana busca _Ubuntu_ y copia la información de _AMI_ de _Ubuntu 18.04_ en su versión de _64-bit x86_.


Una vez que tengas la información del _AMI_ pegala en el campo _AMI_.

En el caso del _IAM Instance Profile Name_, deberás ingresar el perfil de acceso de IAM para EC2. En nuestro caso sera el valor: Rancher_Master.

Por último, ingresa un nombre para el nodo, siguiendo la siguiente convención de nombres: `<worker|master>-<letra-zona-disponibilidad>`.

Una vez que hayas ingresado toda la información, para terminar da clic en el botón Create.