32 lines
No EOL
1.9 KiB
Markdown
32 lines
No EOL
1.9 KiB
Markdown
# api
|
||
|
||
Пакет api реализует протокол, по которому общаются компоненты системы.
|
||
|
||
Этот пакет не занимается передачей файлов и артефактов, соответствующие функции находятся в
|
||
пакетах `filecache` и `artifact`.
|
||
|
||
## Worker <-> Coordinator
|
||
|
||
- Worker и Coordinator общаются через один запрос `POST /heartbeat`.
|
||
- Worker посылает `HeartbeatRequest` и получает в ответ `HeartbeatResponse`.
|
||
- Запрос и ответ передаются в формате json.
|
||
- Ошибка обработки heartbeat передаётся как текстовая строка.
|
||
|
||
## Client <-> Coordinator
|
||
|
||
Client и Coordinator общаются через два вызова.
|
||
|
||
- `POST /build` - стартует новый билд.
|
||
* Client посылает в Body запроса json c описанием сборки.
|
||
* Coordinator стримит в body ответа json сообщения описывающие прогресс сборки.
|
||
* Первым сообщением в ответе Coordinator присылает `buildID`.
|
||
* _Тут можно было бы использовать websocket, но нас устраивает более простое решение._
|
||
|
||
- `POST /signal?build_id=12345` - посылает сигнал бегущему билду.
|
||
* Запрос и ответ передаются в формате json.
|
||
|
||
# Замечания
|
||
|
||
- Конструкторы клиентов и хендлеров принимают первым параметром `*zap.Logger`. Запишите в лог события
|
||
получения/отправки запроса и все ошибки. Это поможет вам отлаживать интеграционные тесты
|
||
в следующей части задания. |