Руководство пользователя
Этот раздел предназначен для тех, у кого уже есть доступ к проекту Semaphore. Всё, что описано здесь, происходит в веб-интерфейсе или через API проекта. Установка сервера, его настройка и подключение провайдера идентификации описаны в Руководстве администратора.
Работа в Semaphore выстроена в одну цепочку. Проект содержит всё остальное. Внутри него вы регистрируете ресурсы, необходимые для запуска: репозиторий с вашими playbook'ами или скриптами, ключи для доступа к нему и к вашим хостам, инвентарь целевых машин и группы переменных со значениями и секретами. Шаблон задачи объединяет всё это в описание того, что нужно запустить, а каждый запуск такого шаблона — это задача. Расписания, рабочие процессы и входящие вебхуки запускают шаблоны за вас.
Настройка проекта
Именно в этом порядке, потому что каждый шаг зависит от предыдущего.
| Страница | Содержимое |
|---|---|
| Проекты | Создание проекта, разделы боковой панели, резервное копирование и восстановление. |
| Команды | Четыре встроенные роли и пользовательские роли в Enterprise. |
| Хранилище ключей | SSH-ключи, логины и внешние хранилища секретов. |
| Репозитории | Git-репозитории и локальные каталоги с вашей автоматизацией. |
| Инвентарь | Хосты и параметры подключения для Ansible, рабочие пространства для Terraform. |
| Группы переменных | Переиспользуемые переменные и секреты, передаваемые в задачи. |
Описание и выполнение работы
| Страница | Содержимое |
|---|---|
| Шаблоны задач | Все поля формы шаблона, а также типы шаблонов. |
| Приложения | Что запускает каждое приложение: Ansible, Terraform, OpenTofu, Terragrunt и скрипты. |
| Задачи | Запуск задачи, статусы задач, логи, остановка и повторный запуск. |
| Расписания | Запуск шаблонов по расписанию cron. |
| Рабочие процессы | Объединение шаблонов в цепочки с согласованиями и ветвлением. |
| Интеграции | Запуск задач по входящим вебхукам. |
| Раннеры проекта | Отправка задач проекта на ваши собственные runner'ы. |
| Ваша учётная запись | Личные настройки и API-токены. |
С чего начать
Если вас тольк о что добавили в проект, прочитайте Проекты, чтобы освоиться, а затем Задачи, чтобы запустить задачу и прочитать её лог. Если вы настраиваете проект с нуля, следуйте таблице выше по порядку.
Совсем новичок в Semaphore? Начните с Начала работы.