Быстрый старт
От чистого сервера до первого выкатанного приложения. Закладывайте около 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. Проверьте
Страница проекта показывает текущий образ, поды и их перезапуски, сборки с логами и историю релизов. Если что-то не так, причина указана в релизе; см. Решение проблем.
Дальше
- Привязать свой домен: Домены и сертификаты.
- Добавить коллег и роли: Команда и безопасность.
- Получать уведомления о сбоях: Уведомления и SIEM.