Руководство администратора
Этот раздел предназначен для администраторов, которые устанавливают Semaphore и обслуживают его для других людей. Всё, что описано здесь, требует доступа к самому серверу: к файлу конфигурации, переменным окружения, командной строке или к машине, на которой работает Semaphore. Работа внутри проекта через веб-интерфейс описана в Руководстве пользователя.
Semaphore — это единый бинарный файл на Go с веб-интерфейсом и REST API. Он хранит данные в SQLite, MySQL или PostgreSQL, держит учётные данные в зашифрованном виде и выполняет задачи либо на самом сервере, либо на отдельных runner'ах. Поэтому рабочая установка сводится к четырём решениям: как её установить, где будет находиться база данных, как пользователи будут входить в систему и где будут выполняться задачи.
Настройка
Всё, что вы настраиваете до запуска сервера или вокруг него.
| Страница | Содержимое |
|---|---|
| Установка | Менеджер пакетов, Docker, бинарный файл, Kubernetes и ручная настройка. |
| Настройка | Файл config.json, переменные окружения и все поддерживаемые параметры. |
| Обновление | Переход на более новый выпуск и что проверить в первую очередь. |
| Обратный прокси | Работа Semaphore за nginx, Apache или Caddy с TLS. |
| Безопасность | Хеширование паролей, шифрование секретов, защита сети и JWT задач. |
| Аутентификация | Локальные учётные записи и двухфакторная аутентификация, LDAP и Active Directory, единый вход через двенадцать провайдеров OpenID Connect. |
| Runner'ы | Выполнение задач на машинах, отличных от сервера. |
| Высокая доступность | Запуск нескольких узлов Semaphore на одной базе данных. |
Эксплуатация
Всё, что вы делаете на уже работающем сервере.
| Страница | Содержимое |
|---|---|
| CLI | Управление пользователями, проектами, vault'ами, runner'ами и миграциями базы данных из командной строки. |
| API | Аутентификация по токену и программное управление Semaphore. |
| Интеграция с CI/CD | Запуск задач Semaphore из внешнего конвейера. |
| Логи | Логи сервера, логи задач и их пересылка в другие системы. |
| Метрики | Эндпоинт Prometheus и метрики, которые он предоставляет. |
| Уведомления | Каналы доставки оповещений: электронная почта, Telegram, Slack и другие. |
| Лицензия | Активация подписки Pro или Enterprise. |
С чего начать
Если вы устанавливаете Semaphore впервые, прочитайте Установку и выберите один способ, а затем Настройку, чтобы понять, как задаются параметры. Поставьте сервер за обратный прокси с TLS, прежде чем им начнёт пользоваться кто-то ещё.
Чтобы узнать, что даёт платная подписка, см. Редакции.