Blackbird

Переглянути на Github

Це додаток Blackbird для Blackbird. Ми можемо почути ваші думки: чи не занадто це схоже на Blackbird-інцепцію? Навпаки! З додатком Blackbird ви можете організовувати робочі процеси, що стосуються самого Blackbird. Поширеними випадками використання є журналювання польотів, обробка помилок та управління користувачами.

За допомогою додатку Blackbird ви можете підключитися до будь-якого екземпляра Blackbird незалежно від середовища хостингу чи організації. Це означає, що ви не обмежені власною організацією.

Перед налаштуванням

Перед підключенням переконайтеся, що:

• У вас є права адміністратора в екземплярі Blackbird, до якого ви хочете підключитися.

Отримання API-ключа

• Увійшовши до своєї організації Blackbird, натисніть на іконку користувача у верхньому правому куті та виберіть Organization management.
• Натисніть на API Tokens на панелі ліворуч.
• Натисніть Generate
• Скопіюйте токен, який ви щойно згенерували, натиснувши кнопку копіювання в розділі Manage.

Підключення

1. Перейдіть до додатків і знайдіть Blackbird. Оберіть додаток Blackbird.
2. Натисніть Add connection
3. Назвіть своє підключення.
4. У полі URL введіть базову URL-адресу вашого екземпляра Blackbird. Наприклад, https://de-1.blackbird.io.
5. У полі API token введіть API-токен, який ви щойно створили.
6. Натисніть Connect.

Actions

Users

• Search users повертає всіх користувачів підключеної організації.
• Get user повертає інформацію про конкретного користувача.
• Add user to nest додає користувача до гнізда.
• Remove user from nest видаляє користувача із зазначеного гнізда.

Nests

• Search nests повертає всі гнізда підключеної організації.
• Get nest повертає інформацію про конкретне гнізда.

Birds

• Search birds повертає всіх птахів всередині конкретного гнізда. Ви можете додатково фільтрувати за статусом птаха та типом тригера.
• Get bird повертає інформацію про конкретного птаха.
• Start bird запускає новий політ цього птаха. Примітка: на даний момент це працює лише для птахів із ручними тригерами.

Flights

• Search flights повертає всі польоти конкретного птаха. Додатково ви можете фільтрувати польоти в певних часових рамках. Також можна фільтрувати за статусом польоту.
• Get flight повертає інформацію про конкретний політ.

Events

Birds

• On bird activated спрацьовує, коли птах активується (статус змінюється з suspended на active)
• On bird published спрацьовує, коли публікується нова версія птаха
• On bird suspended спрацьовує, коли птах призупиняється (статус змінюється з active на suspended)

Flights

• On flight started спрацьовує, коли політ розпочався.
• On flight succeeded спрацьовує, коли політ успішно завершується.
• On flight failed спрацьовує, коли політ не вдався. Дивіться приклад нижче.

Для подій птахів і польотів ви можете додатково вибрати гніздо, за яким хочете спостерігати. Зауважте, що події птахів і польотів не можуть запускати самі себе. Тому вам не потрібно турбуватися про нескінченні цикли.

Nests

• On nest created спрацьовує, коли створюється нове гніздо
• On nest deleted спрацьовує, коли гніздо видаляється
• On user added to nest спрацьовує, коли користувач додається до гнізда.
• On user removed from nest спрацьовує, коли користувач видаляється з гнізда.

Приклади

Обробка помилок

Цей неймовірно простий птах надсилатиме сповіщення у Slack, коли будь-який політ завершиться невдачею. Це може бути корисним для попередження людей про можливі проблеми. Альтернативною або додатковою дією до Slack може бути створення заявки, наприклад, у Jira.

Відгуки

Хочете використовувати цей додаток або маєте відгуки щодо нашої реалізації? Зв’яжіться з нами через встановлені канали або створіть проблему.