Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Inicio rápido de Helm CLI

Estas instrucciones capturan una forma rápida de configurar una instalación de prueba de concepto de Rancher.

Estas instrucciones asumen que tienes una máquina virtual Linux con la que te comunicarás desde tu estación de trabajo local. Rancher se instalará en la máquina Linux. Necesitarás recuperar la dirección IP de esa máquina para poder acceder a Rancher desde tu estación de trabajo local. Rancher está diseñado para gestionar clústeres de Kubernetes de forma remota, por lo que cualquier clúster de Kubernetes que Rancher gestione en el futuro también necesitará poder alcanzar esta dirección IP.

No recomendamos instalar Rancher localmente porque crea un problema de red. Instalar Rancher en host local no permite que Rancher se comunique con clústeres de Kubernetes en sentido descendente, por lo que en host local no podrías probar la provisión de clústeres o la funcionalidad de gestión de clústeres de Rancher.

Tu máquina Linux puede estar en cualquier lugar. Podría ser una instancia de Amazon EC2, un droplet de Digital Ocean o una máquina virtual de Azure, por nombrar algunos ejemplos. Otros documentos de Rancher a menudo utilizan 'nodo' como un término genérico para todos estos. Una forma posible de desplegar una máquina Linux es configurando una instancia de Amazon EC2 como se muestra en este tutorial.

Los requisitos completos de instalación están aquí.

Instalar SUSE® Rancher Prime: K3s en Linux

Rancher debe instalarse en una versión de Kubernetes compatible. Para averiguar qué versiones de Kubernetes son compatibles con tu versión de Rancher, consulta la matriz de soporte de Rancher.

Para especificar la versión de K3s (Kubernetes), utiliza la variable de entorno INSTALL_K3S_VERSION (por ejemplo, INSTALL_K3S_VERSION="v1.24.10+k3s1") al ejecutar el script de instalación de K3s.

Instala un clúster K3s ejecutando este comando en la máquina Linux:

curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=<VERSION> sh -s - server --cluster-init

Usar --cluster-init permite que K3s utilice etcd embebido como la base de datos y tiene la capacidad de convertirse en una configuración de alta disponibilidad. Consulta Alta Disponibilidad con DB Embebido.

Guarda la IP de la máquina Linux.

Guarda el kubeconfig en tu estación de trabajo

El archivo kubeconfig es importante para acceder al clúster de Kubernetes. Copia el archivo en /etc/rancher/k3s/k3s.yaml desde la máquina Linux y guárdalo en tu estación de trabajo local en el directorio ~/.kube/config. Una forma de hacerlo es utilizando la herramienta scp y ejecutar este comando en tu máquina local:

  • Mac y Linux

  • Windows

scp root@<IP_OF_LINUX_MACHINE>:/etc/rancher/k3s/k3s.yaml ~/.kube/config

En algunos casos, puede que necesites asegurarte de que tu shell tenga la variable de entorno KUBECONFIG=~/.kube/config definida; por ejemplo, se puede exportar en tu perfil o archivos rc.

Por defecto, "scp" no es un comando reconocido, así que necesitamos instalar un módulo primero.

En Windows Powershell:

Find-Module Posh-SSH
Install-Module Posh-SSH

## Get the remote kubeconfig file
scp root@<IP_OF_LINUX_MACHINE>:/etc/rancher/k3s/k3s.yaml $env:USERPROFILE\.kube\config

Edita la URL del servidor Rancher en el kubeconfig

En el archivo kubeconfig, necesitarás cambiar el valor del campo server a <IP_OF_LINUX_NODE>:6443. El servidor de la API de Kubernetes se alcanzará en el puerto 6443, mientras que el servidor de Rancher se alcanzará en los puertos 80 y 443. Esta edición es necesaria para que cuando ejecutes comandos de Helm o kubectl desde tu estación de trabajo local, puedas comunicarte con el clúster de Kubernetes en el que se instalará Rancher.

  • Mac y Linux

  • Windows

Una forma de abrir el archivo kubeconfig para editar es usar Vim:

vi ~/.kube/config

Presiona i para poner Vim en modo de inserción. Para guardar tu trabajo, presiona Esc. Luego presiona :wq y presiona Enter.

En Windows Powershell, puedes usar notepad.exe para editar el archivo kubeconfig:

notepad.exe $env:USERPROFILE\.kube\config

Una vez editado, presiona ctrl+s o ve a File > Save para guardar tu trabajo.

Instala Rancher con Helm

Luego, desde tu estación de trabajo local, ejecuta los siguientes comandos. Necesitarás tener kubectl y helm instalados.

Para ver opciones sobre cómo personalizar la instalación de cert-manager (incluyendo casos donde tu clúster utiliza PodSecurityPolicies), consulta la documentación de cert-manager.

 
helm repo add rancher-prime <helm-chart-repo-url>

To learn more about the Rancher Prime Helm chart repository URL, see our Prime-only documentation. Authentication is required. Use your SUSE Customer Center (SCC) credentials to log in.

 
kubectl create namespace cattle-system

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/<VERSION>/cert-manager.crds.yaml

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

helm repo update

helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace

# Windows Powershell
helm install cert-manager jetstack/cert-manager `
  --namespace cert-manager `
  --create-namespace

El comando final para instalar Rancher se encuentra a continuación. El comando requiere un nombre de dominio que redirija el tráfico a la máquina Linux. Por simplicidad en este tutorial, puedes usar un nombre de dominio falso para crear tu prueba de concepto. Un ejemplo de un nombre de dominio falso sería <IP_OF_LINUX_NODE>.sslip.io.

Para instalar una versión específica de Rancher, utiliza la bandera --version (por ejemplo, --version 2.6.6). De lo contrario, se instalará la última versión de Rancher por defecto.

Consulta Configuración de la Contraseña de Inicio para los requisitos de la contraseña.

helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=<IP_OF_LINUX_NODE>.sslip.io \
  --set replicas=1 \
  --set bootstrapPassword=<PASSWORD_FOR_RANCHER_ADMIN>

# Windows Powershell

helm install rancher rancher-prime/rancher `
  --namespace cattle-system `
  --set hostname=<IP_OF_LINUX_NODE>.sslip.io `
  --set replicas=1 `
  --set bootstrapPassword=<PASSWORD_FOR_RANCHER_ADMIN>

Ahora, si navegas a <IP_OF_LINUX_NODE>.sslip.io en un navegador web, deberías ver la interfaz de usuario de Rancher.

Para simplificar estas instrucciones, utilizamos un nombre de dominio falso y certificados autofirmados para realizar esta instalación. Por lo tanto, probablemente necesitarás añadir una excepción de seguridad a tu navegador web para ver la interfaz de usuario de Rancher. Ten en cuenta que para instalaciones en producción, necesitarías una configuración de alta disponibilidad con un balanceador de carga, un nombre de dominio real y certificados reales.

Estas instrucciones también omitieron los requisitos completos de instalación y otras opciones de instalación. Si tienes algún problema con estos pasos, consulta la documentación completa de instalación de Helm CLI.

Para lanzar nuevos clústeres de Kubernetes con tu nuevo servidor Rancher, puede que necesites realizar la configuración de credenciales en la nube en Rancher. Para más información, consulta Lanzamiento de clústeres de Kubernetes con Rancher.