Operations Overview
Канонический operations-корпус AngaraBase для DBA и SRE. Здесь собраны runbooks, baselines и контрольные списки, поддерживаемые в синхронизации с кодом и release trains.
Если вы только начинаете — начните с пользовательских руководств в Эксплуатация (How-to): они короче и подходят как entry point. Этот раздел — operator-level deep-dives.
Как ориентироваться
| Задача | Куда идти |
|---|---|
| Поднять инстанс с нуля | Установка → Configuration |
| Запустить контейнер / k8s minimal | Container deployment quickstart |
| Перевести в production | Operational policies baseline → Hardening → Security operations baseline |
| Настроить мониторинг и алерты | Observability metrics checklist → Parallel runtime observability |
| Расследовать проблему в production | Troubleshooting guide → Diagnostics bundle runbook → Error debug runbook |
| Читать планы запросов | How to read query plans → Performance tuning guide |
| Оптимизировать производительность | Performance tuning guide → How to read query plans → Parallel runtime observability |
| Резервная копия / восстановление | Backup and restore (operator-level) → Disaster recovery playbook |
| Обновить версию | Upgrade and migration |
| Подключить незнакомый клиент / ORM | Client compatibility baseline |
| Подготовить voucher для bug-репорта | Diagnostics bundle runbook → Support |
Каноничные operations-страницы
Lifecycle
- Upgrade and migration — pre-flight, rolling steps, verification.
- MVCC and GC operator minimum — поведение AngaraGC и операторские knobs.
- Checkpoint operations — управление процессом checkpoint.
Reliability
- Container deployment quickstart — image-first запуск, cgroup probe, k8s minimal smoke.
- Backup and restore — operator-level baseline (cold + online/PITR).
- Disaster recovery playbook — DR-сценарии, host migration.
- Replication v2 operations guide — AngaraReplica v2.
Performance
- Performance tuning guide — workload-driven knobs, what to measure first.
- Statistics and ANALYZE — сбор и персистенция статистики.
- How to read query plans —
EXPLAIN, operators, diagnostics, cache/replan signals. - Parallel runtime observability runbook — DOP-капы, partitioned join.
- jemalloc heap profiling runbook — диагностика памяти.
Observability
- Observability metrics checklist — обязательный минимум метрик.
- Diagnostics bundle runbook — что собирать при инциденте.
Security
- Security operations baseline — security knobs registry, регулярные проверки.
Reference
- Configuration schema reference — все TOML/env параметры с типами и дефолтами.
- Client compatibility baseline — список протестированных клиентов и оговорки.
- Known issues baseline — operator-уровень known issues.
- Operational policies baseline — production-policy baseline.
Troubleshooting
- Troubleshooting guide — типовые инциденты и действия.
- Runbooks index — оглавление всех runbooks.
Validation
- Testing and validation baseline — что проверять перед production.
- Golden dataset management — управление эталонными данными.
- CI reproducibility contract — контракт воспроизводимости сборки.
Ссылки
- Architecture overview — как устроена БД (контекст для эксплуатации).
- Security model — модель безопасности целиком.
- SQL compatibility — границы поддерживаемого SQL.
- Support — как сообщить о проблеме.