Repolode
Enviar
alexellis

alexellis/k3sup

Ferramenta de linha de comando que instala K3s Kubernetes por SSH em uma VM local ou remota e busca um kubeconfig para acessar o cluster com kubectl.

Ver no GitHubSite
Estrelas
7,439
Forks
432
Issues abertas
34
Último commit
há 2 meses

O que é?

k3sup é um pequeno utilitário de linha de comando escrito em Go que transforma uma máquina Linux sem nada instalado em um cluster K3s Kubernetes funcional. Você executa a ferramenta no seu computador, aponta para um host acessível por SSH e ela instala o K3s nesse host. Depois, copia o kubeconfig para sua máquina, deixando o kubectl pronto para uso. Também é possível adicionar outros hosts Linux como agentes K3s ou usar o modo de instalação local, sem SSH.

A ferramenta é voltada a hosts Linux, como VMs na nuvem, servidores bare metal e dispositivos Raspberry Pi. O binário é compilado para Linux, Windows e macOS. As opções incluem selecionar a versão ou o canal do K3s, configurar a porta e a chave SSH, desativar componentes incluídos por padrão, como o traefik, criar configurações HA com vários servidores e usar etcd integrado ou um datastore SQL externo. Também é possível mesclar o kubeconfig gerado a um arquivo existente, associado a um contexto nomeado.

O repositório também apresenta uma edição comercial, k3sup Pro, que inclui os comandos plan e apply para instalações paralelas no estilo GitOps em vários nós, além dos comandos exec, uninstall e get-config. A ferramenta CE principal é licenciada sob MIT.

Recursos principais

  • 01Instala o K3s em um host Linux remoto por SSH com um único comando.
  • 02Busca o kubeconfig para sua máquina e pode mesclá-lo a um arquivo existente, associado a um contexto nomeado.
  • 03Adiciona outros hosts Linux ao cluster como agentes K3s.
  • 04Oferece suporte a configurações de servidores HA com etcd integrado ou um datastore SQL externo.
  • 05Executa no modo local, sem SSH, para instalar o K3s na máquina atual.
  • 06Disponibiliza um binário estático para Linux, Windows e macOS.

Casos de uso

  • Criar um cluster K3s de um ou vários nós em VMs na nuvem.
  • Montar um cluster Kubernetes para um homelab com dispositivos Raspberry Pi.
  • Inicializar o K3s a partir de jobs de CI ou scripts cloud-init.
  • Configurar um plano de controle K3s altamente disponível com vários servidores.

Início rápido

  1. 1

    Instale o binário do k3sup com o script oficial de instalação do README

  2. 2

    Mova o binário para o seu PATH

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

    Instale o K3s na máquina local sem SSH

    k3sup install --local

Antes de usar

  • Os hosts de destino precisam permitir sudo sem senha, a menos que as imagens na nuvem já permitam isso.
  • O K3sup Pro exige um GitHub Sponsorship ou uma licença comercial e é regido por um EULA.
  • Os metadados não indicam uma licença clara (NOASSERTION); confira o arquivo LICENSE antes de usar comercialmente.

Tópicos

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

Perguntas frequentes

O que é k3sup?
Ferramenta de linha de comando que instala K3s Kubernetes por SSH em uma VM local ou remota e busca um kubeconfig para acessar o cluster com kubectl. k3sup é um pequeno utilitário de linha de comando escrito em Go que transforma uma máquina Linux sem nada instalado em um cluster K3s Kubernetes funcional. Você executa a ferramenta no seu computador, aponta para um host acessível por SSH e ela instala o K3s nesse host. Depois, copia o kubeconfig para sua máquina, deixando o kubectl pronto para uso. Também é possível adicionar outros hosts Linux como agentes K3s ou usar o modo de instalação local, sem SSH.
k3sup é gratuito? Qual é a licença?
k3sup é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
k3sup ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de k3sup foi em 3 de set. de 2026.
Para que posso usar k3sup?
Criar um cluster K3s de um ou vários nós em VMs na nuvem. Montar um cluster Kubernetes para um homelab com dispositivos Raspberry Pi. Inicializar o K3s a partir de jobs de CI ou scripts cloud-init. Configurar um plano de controle K3s altamente disponível com vários servidores.
Como instalar k3sup?
Instale o binário do k3sup com o script oficial de instalação do README Mova o binário para o seu PATH: sudo install k3sup /usr/local/bin/ Instale o K3s na máquina local sem SSH: k3sup install --local
Onde consigo k3sup?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/alexellis/k3sup

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados