DevOpsTools/K3S
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
fafcc34f031aa25219b9b18da7560b477580085b
K3S/docs/make-reference.md
Sergey Antropoff fafcc34f03 docs: обновить документацию — добавить splitgw, ingress-proxypass, hysteria2-server 
docs/networking.md:
  - Раздел ingress-proxypass: архитектура, пример конфигурации с TLS и auth
  - Раздел splitgw: TPROXY-маршрутизация, systemd и k8s режимы, пример TV
  - Раздел hysteria2-server: установка на VPS, SSH-пароль, URL для клиентов

docs/make-reference.md:
  - addon-mediaserver (с флагом без Hysteria2)
  - addon-hysteria2-server (SSH-ключ и интерактивный пароль -k)
  - addon-splitgw (systemd и k8s DaemonSet)
  - addon-ingress-proxypass

docs/troubleshooting.md:
  - Строки таблицы: 502/503/404 для ingress-proxypass, TPROXY для splitgw,
    firewall/TLS для hysteria2-server, Prowlarr sidecar для mediaserver
  - Разделы диагностики: ingress-proxypass, splitgw, hysteria2-server
    с конкретными командами kubectl/systemctl/iptables
2026-04-26 07:36:46 +03:00

5.2 KiB
Raw Blame History

Make команды

Полный справочник всех доступных make команд.

Настройка и сборка

make setup          # Создать .env из шаблона
make build          # Собрать Docker образ (~3-5 мин)
make rebuild        # Пересобрать без кэша
make clean          # Удалить Docker образ
make clean-all      # Образ + kubeconfig + кэш Docker

Проверки

make ping           # SSH до всех нод
make check          # Dry-run без изменений
make lint           # Проверить синтаксис плейбуков

Установка кластера

make install              # Полный базовый стек
make install-k3s          # Только K3S HA кластер
make install-cni          # CNI плагин
make install-cni K3S_CNI=calico    # Calico
make install-cni K3S_CNI=cilium    # Cilium
make install-kubevip      # Только kube-vip
make install-nfs          # NFS сервер + CSI
make install-ingress      # ingress-nginx
make install-cert-manager # cert-manager + ClusterIssuer
make install-istio        # Istio + Kiali
make install-monitoring   # Prometheus + Grafana

Аддоны

make install-addons            # Установить все включённые аддоны
make addon-<name>              # Установить конкретный аддон

# Примеры:
make addon-prometheus-stack
make addon-argocd
make addon-gitea
make addon-harbor
make addon-jenkins
make addon-loki
make addon-promtail
make addon-tempo
make addon-vault
make addon-external-secrets
make addon-minio
make addon-longhorn
make addon-postgresql
make addon-mysql
make addon-nextcloud
make addon-owncloud
make addon-vaultwarden
make addon-smtp-relay
make addon-crowdsec
make addon-velero
make addon-netbird
make addon-ingress-nginx
make addon-cert-manager
make addon-metrics-server
make addon-kubernetes-dashboard

# Медиасервер и VPN:
make addon-mediaserver
make addon-mediaserver ARGS="-e mediaserver_hysteria2_enabled=false"   # без Hysteria2

make addon-hysteria2-server                # по SSH-ключу
make addon-hysteria2-server ARGS="-k"      # ввод SSH-пароля интерактивно

make addon-splitgw                                         # systemd на хосте
make addon-splitgw ARGS="-e splitgw_deploy_mode=k8s"      # K8s DaemonSet

make addon-ingress-proxypass
make addon-ingress-proxypass ARGS="-e ingress_proxypass_vip=192.168.1.x"

Управление нодами

make add-node NODE=worker04      # Добавить ноду в кластер
make remove-node NODE=worker04   # Безопасно удалить ноду

etcd резервное копирование

make etcd-backup                              # Создать снимок
make etcd-list-snapshots                      # Список снимков
make etcd-restore SNAPSHOT=k3s-etcd-XXX.db   # Восстановить

Тестирование (Molecule)

make molecule-k3s           # Тест роли k3s (~8-12 мин)
make molecule-prometheus    # Тест роли prometheus-stack (~2-3 мин)
make molecule-istio         # Тест роли istio (~2-3 мин)
make molecule-all           # Все тесты (~15-20 мин)
make molecule-lint          # Линтинг YAML + ansible-lint (~30 сек)

Обновление и диагностика

make upgrade VERSION=v1.30.0+k3s1   # Обновить K3S
make health                          # Полная диагностика
make verify                          # Сводка стека
make shell                           # bash в ansible-контейнере
make uninstall                       # Удалить стек (с подтверждением)

Vault

make vault-create                                    # Создать vault
make vault-edit                                      # Редактировать
make vault-view                                      # Просмотреть
make vault-encrypt-string STR="secret" NAME="name"  # Зашифровать строку

Переменные командной строки

# Подробный вывод:
ANSIBLE_VERBOSITY=2 make install
ANSIBLE_VERBOSITY=4 make install    # максимальный вывод

# Только конкретные теги:
ANSIBLE_TAGS=k3s make install
ANSIBLE_TAGS=kube_vip make install
ANSIBLE_TAGS=k3s,kube_vip make install

# Дополнительные переменные:
EXTRA_VARS="k3s_version=v1.30.0+k3s1" make install-k3s
EXTRA_VARS="prometheus_storage_size=20Gi" make addon-prometheus-stack

# Лимитировать по хостам:
ANSIBLE_LIMIT=master01 make install

Теги деплоя

make install ANSIBLE_TAGS=k3s          # только K3S
make install ANSIBLE_TAGS=kube_vip     # только kube-vip
make install ANSIBLE_TAGS=nfs          # NFS + CSI
make install ANSIBLE_TAGS=ingress      # ingress-nginx
make install ANSIBLE_TAGS=istio        # Istio + Kiali
make install ANSIBLE_TAGS=monitoring   # Prometheus stack