Repolode
Enviar
alexellis

alexellis/k3sup

Herramienta de línea de comandos que instala K3s Kubernetes por SSH en una VM local o remota y obtiene un kubeconfig para acceder con kubectl.

Ver en GitHubSitio web
Estrellas
7,439
Forks
432
Issues abiertos
34
Último commit
hace 2 meses

¿Qué es?

k3sup es una pequeña utilidad de línea de comandos escrita en Go que convierte una máquina Linux recién preparada en un clúster de K3s Kubernetes funcional. Se ejecuta desde tu propio equipo, se indica un host accesible por SSH y la herramienta instala K3s en él. Después, copia el kubeconfig a tu equipo para que kubectl funcione de inmediato. También puede añadir otros hosts Linux como agentes de K3s y ofrece un modo de instalación local que no requiere SSH.

La herramienta está pensada para hosts Linux, como VM en la nube, servidores bare-metal y dispositivos Raspberry Pi. El binario se compila de forma cruzada para Linux, Windows y macOS. Sus opciones permiten elegir la versión o el canal de K3s, configurar el puerto y la clave SSH, desactivar componentes incluidos como traefik, crear configuraciones HA con varios servidores y etcd integrado o un almacén de datos SQL externo, y combinar el kubeconfig generado con un archivo existente usando un contexto con nombre.

El repositorio también describe una edición comercial, k3sup Pro, que añade los comandos plan y apply para realizar instalaciones paralelas al estilo GitOps en muchos nodos, además de los comandos exec, uninstall y get-config. La herramienta CE principal tiene licencia MIT.

Funciones clave

  • 01Instala K3s en un host Linux remoto por SSH con un solo comando.
  • 02Obtiene el kubeconfig en tu equipo y puede combinarlo con un archivo existente usando un contexto con nombre.
  • 03Añade otros hosts Linux al clúster como agentes de K3s.
  • 04Admite configuraciones HA de servidores con etcd integrado o un almacén de datos SQL externo.
  • 05Funciona en modo local sin SSH cuando se instala en la máquina actual.
  • 06Se distribuye como un binario estático para Linux, Windows y macOS.

Casos de uso

  • Poner en marcha un clúster K3s de uno o varios nodos en VM en la nube.
  • Crear un clúster Kubernetes para un laboratorio doméstico con dispositivos Raspberry Pi.
  • Configurar K3s desde trabajos de CI o scripts de cloud-init.
  • Configurar un plano de control de K3s de alta disponibilidad con varios servidores.

Inicio rápido

  1. 1

    Instala el binario de k3sup con el script oficial de instalación del README

  2. 2

    Mueve el binario a tu PATH

    sudo install k3sup /usr/local/bin/
  3. 3

    Instala K3s en la máquina local sin SSH

    k3sup install --local

Antes de usarlo

  • Los hosts de destino necesitan sudo sin contraseña, salvo que las imágenes en la nube ya lo permitan.
  • K3sup Pro requiere una GitHub Sponsorship o una licencia comercial, y se rige por un EULA.
  • Los metadatos no indican una licencia clara (NOASSERTION), así que consulta el archivo LICENSE antes de usarlo con fines comerciales.

Temas

#kubernetes#k3s#ssh#devops#raspberry-pi#cluster-setup#cloud#cloud-native#devtools#edge

Preguntas frecuentes

¿Qué es k3sup?
Herramienta de línea de comandos que instala K3s Kubernetes por SSH en una VM local o remota y obtiene un kubeconfig para acceder con kubectl. k3sup es una pequeña utilidad de línea de comandos escrita en Go que convierte una máquina Linux recién preparada en un clúster de K3s Kubernetes funcional. Se ejecuta desde tu propio equipo, se indica un host accesible por SSH y la herramienta instala K3s en él. Después, copia el kubeconfig a tu equipo para que kubectl funcione de inmediato. También puede añadir otros hosts Linux como agentes de K3s y ofrece un modo de instalación local que no requiere SSH.
¿k3sup es gratuito? ¿Qué licencia tiene?
k3sup es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿k3sup sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de k3sup fue el 3 sept 2026.
¿Para qué puedo usar k3sup?
Poner en marcha un clúster K3s de uno o varios nodos en VM en la nube. Crear un clúster Kubernetes para un laboratorio doméstico con dispositivos Raspberry Pi. Configurar K3s desde trabajos de CI o scripts de cloud-init. Configurar un plano de control de K3s de alta disponibilidad con varios servidores.
¿Cómo se instala k3sup?
Instala el binario de k3sup con el script oficial de instalación del README Mueve el binario a tu PATH: sudo install k3sup /usr/local/bin/ Instala K3s en la máquina local sin SSH: k3sup install --local
¿Dónde consigo k3sup?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/alexellis/k3sup

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados