Debafr

Deploy Backend/Frontend application

Установка

# Установка последней версии
curl -LsSf https://raw.githubusercontent.com/dimns/debafr/refs/heads/master/scripts/install.sh | bash

# Установка конкретной версии
curl -LsSf https://raw.githubusercontent.com/dimns/debafr/refs/heads/master/scripts/install.sh | bash -s -- -v v0.6.0

# Тестовый прогон (без изменений)
curl -LsSf https://raw.githubusercontent.com/dimns/debafr/refs/heads/master/scripts/install.sh | bash -s -- --dry-run

# Удаление
curl -LsSf https://raw.githubusercontent.com/dimns/debafr/refs/heads/master/scripts/install.sh | bash -s -- --uninstall

# Тихая установка
curl -LsSf https://raw.githubusercontent.com/dimns/debafr/refs/heads/master/scripts/install.sh | bash -s -- --quiet

Команды

Команда	Описание
debafr	TUI: деплой blue/green с проверками и переключением nginx
debafr status	Текущий деплой: версия, стратегия, порты, состояние контейнеров
debafr update	Обновить debafr до последней версии
debafr version	Показать версию debafr (--version, -v)

Использование

Обратите внимание команды выполняются для каталога: /opt/project

1. Структура каталога /opt/project

   compose.blue.yaml
   compose.green.yaml
   debafr.toml
   nginx.conf >> /etc/nginx/sites-available/project.ru

2. Создайте символическую ссылку на файл конфига nginx

   ln -sf /etc/nginx/sites-available/project.ru /opt/project/nginx.conf

3. Создайте конфигурационный файл проекта /opt/project/debafr.toml, пример можно посмотреть здесь: .dev/debafr.toml

   Параметр	Тип	Значение по умолчанию	Обязательное
   app.project_name	string	"myapp"	✅ Да
   app.proxy_pass_prefix	string	"proxy_pass http://127.0.0.1:"	✅ Да
   app.location_ports	array of objects	[{location="/api", blue_port="3001", green_port="3011"}, ...]	✅ Да
   app.images	array of string	["ghcr.io/app/api", "ghcr.io/app/ui", ]	✅ Да
   app.victoriametrics.enabled	bool	false	Нет
   app.victoriametrics.targets_output_file_path	string	""	Нет
   app.victoriametrics.target_blue	string	""	Нет
   app.victoriametrics.target_green	string	""	Нет
   docker_login.enabled	bool	false	Нет
   docker_login.registry	string	""	Нет
   docker_login.username	string	""	Нет
   docker_login.password	string	""	Нет
   files.compose_blue	string	"compose.blue.yaml"	Нет
   files.compose_green	string	"compose.green.yaml"	Нет
   files.nginx_conf	string	"nginx.conf"	Нет
   binpaths.docker	string	"/usr/bin/docker"	Нет
   binpaths.curl	string	"/usr/bin/curl"	Нет
   binpaths.nginx	string	"/usr/sbin/nginx"	Нет
   timeouts.default	string	"5m"	Нет
   healthcheck.max_retries	integer	30	Нет
   healthcheck.retry_delay	string	"5s"	Нет

4. Запустите деплой

   debafr