Вебхуки
Вебхук (Webhook) — это механизм автоматического уведомления одного веб-приложения другим при наступлении определённого события. Вместо постоянного опроса сервера на предмет обновлений система-получатель просто ожидает входящий сигнал. Как только в системе-отправителе происходит целевое действие (например, перезапускается контейнер, запускается сборка пайплайна), она мгновенно отправляет HTTP-запрос с данными на заранее указанный URL-адрес.
Вебхуки настраиваются на уровне проекта, для одного проекта может быть несколько вебхуков.
Как это работает
- В инфраструктуре Dockhost происходит заданное событие (например, обновление контейнера или сборка пайплайна).
- Платформа автоматически отправляет POST-запрос с данными события на указанный вами URL-адрес.
- Ваш сервер проверяет аутентификацию по переданному токену (при необходимости) и обрабатывает полученные данные.
Заголовки
При отправке сообщения добавляются дополнительные заголовки, которые можно использовать для логирования или проверки аутентификации:
| Заголовок | Описание | Пример |
|---|---|---|
| X-Dockhost-Event | Название события | container.update |
| X-Dockhost-Id | ИД события | 37a5b1aa-34e5-49bc-8d84-918117c95694 |
| X-Dockhost-Token | Токен | SECRET |