Instalación Rancher Server

A continuación se presenta el proceso de instalación de Rancher Server como elemento de software utilizado para ayudar a los equipos de DEVOPS en la administración de los clusters de Kubernetes.

Laboratorio: Instalación Rancher Server

Descripción

Rancher Server se puede instalar en cualquier clúster de Kubernetes o puede usar una de las distribuciones de Kubernetes de Rancher como RKE, o puede ser un clúster de Kubernetes administrado de un proveedor como Amazon EKS.

Objetivos

Realizar la instalación Rancher Server sobre un Rancher Kubernetes Engine (RKE)

Antes de comenzar

Contar con el acceso al ambiente de laboratorio
Haber realizado la guía de Instalación Rancher Kubernetes Engine (RKE)

Inicio de laboratorio

Ingresar al servidor student-#-aio con las credenciales o llave proporcionados

Instalar la herramienta HELM, un manejador de paquetes para Kubernetes, HELM es necesario ya qué Rancher Server se instala mediante un paquete Helm.

cd ~/
wget https://get.helm.sh/helm-v3.3.1-linux-amd64.tar.gz
tar -xf helm-v3.3.1-linux-amd64.tar.gz
mv linux-amd64/helm  ~/bin/helm
chmod +x  ~/bin/helm

Verificar la versión de la herramienta HELM
```
helm version
```
Use el comando helm repo add para agregar el repositorio de Charts de Helm que contiene Charts para instalar Rancher
```
helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
```

Proporcione accesos administrativos al cluster de Kubernetes

export KUBECONFIG=~/rke-cluster-aio/kube_config_cluster.yml

Cree y defina un espacio de nombres de Kubernetes donde se deben instalar los recursos creados por Chart.Esto siempre debe ser cattle-system
```
kubectl create namespace cattle-system
```
Instale el administrador de certificados a utilizar, para este caso se instalará cert-manager, a continuación se crean los custom resources neecsarios.
```
kubectl apply -f \
https://github.com/jetstack/cert-manager/releases/download/v1.13.3/cert-manager.crds.yaml
```

Agregar el repositorio Helm para jetstack

helm repo add jetstack https://charts.jetstack.io

Actualizar Helm chart repository cache
```
helm repo update
```

Instalar cert-manager Helm chart

helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace \
  --version v1.13.3

Una vez instalado el cert-manager, puede verificar que se haya implementado de manera correcta, comprobando el espacio de nombres de cert-manager para ejecutar pods

kubectl get pods --namespace cert-manager

NAME                                            READY        STATUS    RESTARTS            AGE
cert-manager-5c6866597-zw7kh                    1/1          Running   0                   2m
cert-manager-cainjector-577f6d9fd7-tr77l        1/1          Running   0                   2m
cert-manager-webhook-787858fcdb-nlzsq           1/1          Running   0                   2m

Defina la URL a utilizar para Rancher Server

AIO_WILDCARD=$(curl http://showip.net|tr '.' '-').nip.io

RANCHER_URL=rancher.$AIO_WILDCARD

Verificar la URL a utilizar para Rancher Server
```
echo $RANCHER_URL
```

Instale Rancher Server utilizando Helm

helm install rancher rancher-stable/rancher \
  --namespace cattle-system \
  --set hostname=${RANCHER_URL} \
  --set bootstrapPassword=admin \
  --version 2.7.9

Verifique que el servidor Rancher se haya implementado correctamente
```
kubectl -n cattle-system rollout status deploy/rancher
```
Si ve el siguiente error: deployment "rancher" exceeded its progress deadline, puede verificar el estado de la implementación ejecutando el siguiente comando
```
kubectl -n cattle-system get deploy rancher
```
Debería mostrar el mismo conteo para DESIRED y AVAILABLE. Asegúrese de guardar las opciones --set que utilizó. Deberá usar las mismas opciones cuando actualice Rancher a nuevas versiones con Helm.
Ejecute el siguiente comando para obtener la URL de Rancher Server, utilice un navegador web para ecceder.
```
echo https://$RANCHER_URL
```
En la ventana del Navegador Web aparecerá la página de Bienvenida Welcome to Rancher!, debe completar la información de la siguiente manera:
En Bootstrap Password coloque admin
Seleccione Set a specific password to use
En New y Confirm New Password coloque la siguiente contraseña Sns3Rancher123
NO MODIFIQUE la casilla de Server URL
Desmarcar Allow collection of...
Marcar I agree to the...
Dar click en el Botón Continue