Acktide

Acktide Free · быстрый старт

От нуля до ACK на телефоне

Получите бесплатную поставку, поднимите сервер, подключите мониторинг и проверьте ACK на своём телефоне. Free можно использовать постоянно; облачный аккаунт и лицензионный ключ не нужны.

1. Получить Free и поднять сервер

Публичный репозиторий пока не открыт. Запросите бесплатную поставку, распакуйте архив и перейдите в его каталог, где находится compose.yaml. Нужны Docker с Compose и доступ к образам зависимостей для первой сборки.

В каталоге поставки сгенерируйте пароль базы и bootstrap-токен, затем запустите установку:

python3 - <<'PY'
from pathlib import Path
import secrets
p = Path('.env')
if p.exists():
    raise SystemExit('.env уже существует; изменения не внесены')
p.write_text('POSTGRES_PASSWORD=' + secrets.token_hex(24) +
             '\nBOOTSTRAP_TOKEN=' + secrets.token_hex(24) +
             '\nPUBLIC_URL=http://localhost:8080\n')
p.chmod(0o600)
PY

docker compose up --build -d

Откройте http://localhost:8080 и войдите по значению BOOTSTRAP_TOKEN из .env. Для постоянной установки в Kubernetes есть Helm-чарт.

HTTP годится для локальной проверки. Release-сборка Android-приложения принимает только HTTPS с действительным сертификатом — для работы с телефоном понадобится публичный адрес и TLS.

Быстрее — в облачном кабинете

Создайте аккаунт и пройдите настройку источника, Android и тестового алерта прямо в кабинете. Пробный доступ — 30 дней без карты. Инструкция ниже — для установки Free на свой сервер.

Начать в облаке

2. Подключить Alertmanager

Создайте в Acktide источник типа Alertmanager и сохраните выданный webhook URL в Kubernetes Secret — так токен не попадёт в values-файл. Затем добавьте receiver:

- name: platform
  webhook_configs:
    - url_file: "/etc/alertmanager/secrets/acktide-webhook/url"
      send_resolved: true
      max_alerts: 0

Существующие receiver'ы Slack, почты и прочих интеграций остаются на месте — вы добавляете ещё один путь, а не заменяете текущий. Secret нужно перечислить в alertmanagerSpec.secrets. Перед применением проверьте конфигурацию через amtool check-config.

Кроме Alertmanager поддерживаются Grafana, Sentry, Zabbix и произвольный сервис через generic-webhook.

3. Привязать телефон

  1. Откройте «Настройки → Подключить Android»На экране появится QR-код с адресом сервера и одноразовым кодом. Код действует 10 минут.
  2. Отсканируйте его камерой телефонаНа открывшейся странице нажмите «Открыть Acktide» — адрес и код подставятся сами. Если приложения ещё нет, там же лежит ссылка на подписанный APK.
  3. Разрешите уведомления и работу в фонеНа прошивках с агрессивным энергосбережением разрешите автозапуск и косвенный запуск, настройте канал Critical. В приложении есть диагностика разрешений.
  4. Добавьте инженера в получатели маршрутаПриглашение само по себе не меняет маршруты: нового участника нужно явно указать получателем нужного источника.
Скачать APK

4. Проверить полный цикл

Внедрение считается состоявшимся, когда сработали все четыре события, а не первое из них.

  • Тестовый алерт принят сервером и появился в списке
  • Телефон получил событие и показал системное уведомление при выключенном экране
  • ACK из шторки отметил конкретного ответственного в карточке алерта
  • Resolved от источника закрыл событие после восстановления

Эти четыре факта Acktide хранит отдельно. Если что-то не сработало, в истории доставки видно, на каком именно шаге цепочка оборвалась.