Быстрый старт с Starry
Добро пожаловать в руководство по началу работы с Starry! В этом разделе вы узнаете, как установить CLI, инициализировать конфигурационный репозиторий, добавить серверные узлы и развернуть первые сервисы.
1. Установка CLI
Starry распространяется в двух форматах: как автономный Native AOT исполняемый файл (не требующий установленного .NET Runtime) и как глобальный инструмент .NET Tool.
# Скачивание последнего релиза для вашей архитектуры
curl -fsSL https://github.com/starry-project/starry/releases/latest/download/starry-linux-x64 -o starry
# Предоставление прав на выполнение
chmod +x starry
# Перемещение в системную директорию PATH
sudo mv starry /usr/local/bin/starry
# Проверка установки
starry --version# Установка через .NET SDK (требуется .NET 10+)
dotnet tool install -g starrycli
# Проверка доступности команды
starry --version# Загрузка и распаковка в PowerShell
Invoke-WebRequest -Uri "https://github.com/starry-project/starry/releases/latest/download/starry-win-x64.exe" -OutFile "$HOME\starry.exe"
# Добавление в PATH текущего пользователя
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$HOME", "User")
starry --version2. Инициализация репозитория
Для управления инфраструктурой по принципам GitOps создайте отдельный git-репозиторий и выполните команду инициализации:
mkdir my-fleet && cd my-fleet
git init
starry initКоманда starry init создаст стартовую структуру проекта:
my-fleet/
├── starry.yaml # Главный декларативный манифест кластера
├── .starry/
│ ├── keys/ # Локальные SSH и WireGuard ключи (добавлены в .gitignore)
│ └── cache/ # Локальный кэш состояния
├── .gitignore # Игнорирование приватных ключей и чувствительных файлов
└── README.md3. Настройка мастер-ключа шифрования
Starry использует шифрование AES-256-GCM с алгоритмом деривации ключей PBKDF2/Argon2. Все секретные токены, пароли баз данных и сертификаты хранятся в зашифрованном виде прямо в файле starry.yaml.
Генерация мастер-ключа
Сгенерируйте криптографически стойкий мастер-ключ:
starry secret keygenКоманда выведет ключ в формате Base64. Экспортируйте его в переменную окружения:
export STARRY_MASTER_KEY="your-generated-base64-master-key"Переменные в CI/CD
Для запуска через GitHub Actions добавьте значение мастер-ключа в репозиторий как секрет: STARRY_MASTER_KEY.
Шифрование чувствительных данных
Чтобы зашифровать пароль или токен API:
starry secret encrypt "my-super-secret-password"Вывод команды будет иметь вид: ENC[AES256_GCM,data:c3VwZXJzZWNyZXQ=,iv:...,tag:...]
Вставьте полученное значение в секцию env или secrets вашего starry.yaml.
4. Подключение серверного узла (Bootstrap)
Подготовьте чистый сервер на базе любого поддерживаемого Linux-дистрибутива (Ubuntu, Debian, AlmaLinux, Rocky, Alpine, Arch).
Выполните команду первичного подключения:
starry nodes bootstrap root@203.0.113.10 --name node-01 --engine dockerВ ходе выполнения bootstrap Starry:
- Подключится по SSH и проверит окружение узла.
- Установит указанный контейнерный движок (
dockerилиpodman), если он отсутствует. - Установит и сконфигурирует пакет
wireguard-toolsиnftables. - Сгенерирует пару ключей WireGuard и выдаст ноде внутренний IP-адрес из диапазона
10.42.0.0/16. - Добавит описание ноды в
starry.yaml.
5. Планирование и применение конфигурации
Отредактируйте starry.yaml, описав желаемые сервисы:
version: "3.0"
mesh:
prefix: "fd67:b00b::/32"
port: 51820
nodes:
node-01:
ssh: "root@203.0.113.10:22"
engine: "docker"
services:
web:
image: "nginx:alpine"
node: "node-01"
ports:
- "80:80"
env:
API_SECRET: "ENC[AES256_GCM:v1:...]"Просмотр изменений (Plan)
Выполните команду dry-run для обнаружения дрифта и просмотра предстоящих изменений:
starry planStarry сопоставит фактическое состояние узлов с декларативным манифестом и выведет детальный список планируемых действий (создание контейнеров, настройка правил файрвола, обновление пакетов).
Применение (Apply)
Для применения изменений запустите:
starry apply6. Запуск фонового агента на нодах
Для автономного мониторинга, проверки состояния (Healthchecks), ротации логов и автоматического восстановления контейнеров Starry включает встроенный фоновый демон.
Установите системную службу systemd на целевом сервере:
sudo starry agent install-service
sudo systemctl status starry-agentИли запустите демон в интерактивном режиме для отладки:
starry agent run --verboseПоздравляем! Ваш первый кластер под управлением Starry успешно развернут и защищен. Переходите к разделу Обзор архитектуры, чтобы узнать подробности о внутренней работе системы.