Repolode
Предложить
alexellis

alexellis/k3sup

Устанавливает K3s Kubernetes на удалённую или локальную VM через CLI, используя SSH, и получает kubeconfig для доступа через kubectl.

Открыть на GitHubСайт
Звёзды
7,439
Форки
432
Открытые issues
34
Последний коммит
2 месяца назад

Что это?

k3sup — небольшая CLI-утилита на Go, которая превращает обычную Linux-машину в работающий кластер K3s Kubernetes. Запустите её на своём компьютере, укажите хост, доступный по SSH, — утилита установит на нём K3s и скопирует kubeconfig обратно, чтобы kubectl сразу заработал. Также она может подключать к кластеру дополнительные Linux-хосты в качестве агентов K3s и поддерживает локальный режим установки без SSH.

Утилита предназначена для Linux-хостов, например облачных VM, bare-metal-серверов и устройств Raspberry Pi. Бинарные файлы собраны для Linux, Windows и macOS. Среди настроек — выбор версии или канала K3s, SSH-порта и ключа, отключение встроенных компонентов вроде traefik, настройка HA с несколькими серверами и встроенным etcd либо внешним SQL-хранилищем, а также объединение сгенерированного kubeconfig с существующим файлом под заданным именованным контекстом.

В репозитории также описана коммерческая версия k3sup Pro: в ней есть команды plan и apply для параллельной установки на множестве узлов в стиле GitOps, а также команды exec, uninstall и get-config. Основной инструмент CE распространяется по лицензии MIT.

Ключевые возможности

  • 01Устанавливает K3s на удалённый Linux-хост через SSH одной командой.
  • 02Загружает kubeconfig на ваш компьютер и может объединить его с существующим файлом под заданным именованным контекстом.
  • 03Подключает к кластеру дополнительные Linux-хосты в качестве агентов K3s.
  • 04Поддерживает HA-конфигурации серверов со встроенным etcd или внешним SQL-хранилищем.
  • 05Устанавливает K3s в локальном режиме без SSH на текущую машину.
  • 06Поставляется в виде статических бинарных файлов для Linux, Windows и macOS.

Сценарии использования

  • Развёртывание одноузлового или многоузлового кластера K3s на облачных VM.
  • Создание домашнего Kubernetes-кластера на устройствах Raspberry Pi.
  • Начальная настройка K3s из CI-задач или скриптов cloud-init.
  • Настройка отказоустойчивого control plane K3s с несколькими серверами.

Быстрый старт

  1. 1

    Установите бинарный файл k3sup с помощью официального скрипта установки из README

  2. 2

    Поместите бинарный файл в PATH

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

    Установите K3s на локальную машину без SSH

    k3sup install --local

Что важно знать

  • На целевых хостах должен быть настроен sudo без пароля, если это уже не разрешено облачными образами.
  • Для использования K3sup Pro требуется GitHub Sponsorship или коммерческая лицензия; на него распространяется EULA.
  • В метаданных не указана однозначная лицензия (NOASSERTION), поэтому перед коммерческим использованием проверьте файл LICENSE.

Темы

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

Частые вопросы

Что такое k3sup?
Устанавливает K3s Kubernetes на удалённую или локальную VM через CLI, используя SSH, и получает kubeconfig для доступа через kubectl. k3sup — небольшая CLI-утилита на Go, которая превращает обычную Linux-машину в работающий кластер K3s Kubernetes. Запустите её на своём компьютере, укажите хост, доступный по SSH, — утилита установит на нём K3s и скопирует kubeconfig обратно, чтобы kubectl сразу заработал. Также она может подключать к кластеру дополнительные Linux-хосты в качестве агентов K3s и поддерживает локальный режим установки без SSH.
k3sup можно использовать бесплатно? Какая у него лицензия?
k3sup распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
k3sup всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в k3sup — 3 сент. 2026 г..
Для чего можно использовать k3sup?
Развёртывание одноузлового или многоузлового кластера K3s на облачных VM. Создание домашнего Kubernetes-кластера на устройствах Raspberry Pi. Начальная настройка K3s из CI-задач или скриптов cloud-init. Настройка отказоустойчивого control plane K3s с несколькими серверами.
Как установить k3sup?
Установите бинарный файл k3sup с помощью официального скрипта установки из README Поместите бинарный файл в PATH: sudo install k3sup /usr/local/bin/ Установите K3s на локальную машину без SSH: k3sup install --local
Где скачать k3sup?
Исходный код и инструкции по установке — на GitHub: https://github.com/alexellis/k3sup

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты