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

От чистого сервера до первого выкатанного приложения. Закладывайте около 20 минут.

Что понадобится

  • Сервер с Ubuntu 22.04/24.04 или Debian 12, не менее 4 ГБ ОЗУ и 20 ГБ диска, доступ в интернет и root.
  • Git-репозиторий с приложением. Dockerfile поможет, но не обязателен.
  • По желанию: доменное имя с A-записью на сервер, для HTTPS.

Платформа вместе с базой и реестром занимает около 1,3 ГБ ОЗУ и 4 ГБ диска; ваши приложения работают на том же сервере.

1. Установка

Запустите установщик от root. Он ставит k3s (Kubernetes), Helm, локальный реестр образов и платформу. Обычный запуск занимает около 5 минут, повторно запускать безопасно.

sudo ./deploy/quickstart/install-single-node.sh \
  --chart ./deploy/helm/devsecops-platform \
  --image <реестр>/control-plane:<версия> \
  --host panel.example.com --email you@example.com

Без --host панель открывается по адресу <ip>.sslip.io, это работает без своего DNS. С --host сначала создайте A-запись, чтобы Let's Encrypt выпустил сертификат (порты 80 и 443 должны быть открыты).

В конце скрипт печатает: - адрес панели; - путь к токену администратора (/root/dsp-admin-token); - путь к ключу шифрования секретов.

Сразу скопируйте ключ шифрования в надёжное место. Без него секреты в базе не прочитать. Подробности и параметры: Установка.

2. Вход

Откройте адрес, выберите «Войти токеном» и вставьте токен администратора. Вы увидите пустую консоль.

3. Подключите репозиторий

«Проекты», «Подключить репозиторий». Вставьте ссылку, проверьте предложенные настройки, выберите, куда выкатывать, и подтвердите. Платформа создаст проект и первую среду и запустит первую сборку. Подробности: Подключение проекта.

4. Добавьте webhook

Последний шаг мастера показывает адрес webhook, секрет и события. Добавьте их в настройки репозитория (или нажмите кнопку, которая создаст webhook сама, если у платформы есть токен репозитория). С этого момента push в ветку среды выкатывается автоматически.

5. Добавьте секреты

Если приложению нужны пароль базы данных или ключи API, откройте проект, «Секреты» и добавьте их (или импортируйте файл .env). См. Секреты. Они попадают в приложение при следующем выкате или сразу по действию «Синхронизировать секреты»; поды перезапускаются автоматически, когда значение меняется.

6. Проверьте

Страница проекта показывает текущий образ, поды и их перезапуски, сборки с логами и историю релизов. Если что-то не так, причина указана в релизе; см. Решение проблем.

Дальше