121 lines
3.7 KiB
Markdown
121 lines
3.7 KiB
Markdown
**Language / Язык:** [English](../operations.md) | [Русский](operations.md)
|
|
|
|
# Эксплуатация
|
|
|
|
## Compose день за днём
|
|
|
|
```bash
|
|
make up # сборка + старт + wait
|
|
make restart # force recreate
|
|
make logs # логи всех сервисов
|
|
make down # остановка
|
|
make seed # перезагрузка minimal
|
|
make seed-demo # перезагрузка demo (~1000 ВМ)
|
|
make smoke # Basic auth + список ВМ
|
|
```
|
|
|
|
## Миграции
|
|
|
|
Сервис Compose `migrate` / init-контейнер Helm запускает
|
|
`python -m app.db.migrate_cli` до готовности симулятора. Не направляйте клиенты
|
|
на Engine, пока `/health/ready` не успешен.
|
|
|
|
История схемы начинается с `001_ovirt_core.sql`. Если обновляетесь с более
|
|
ранней pre-release БД, пересоздайте том:
|
|
|
|
```bash
|
|
docker compose down -v
|
|
make up && make seed
|
|
```
|
|
|
|
## Reseed
|
|
|
|
Reseed **очищает** лабораторные таблицы. В общем CI предпочитайте `minimal`;
|
|
`demo` — когда нужна плотность.
|
|
|
|
```bash
|
|
make seed-demo
|
|
# или Web UI → Data → demo
|
|
```
|
|
|
|
## Смена series
|
|
|
|
**Cold start** — измените `OVIRT_SERIES` и пересоздайте контейнер симулятора:
|
|
|
|
```bash
|
|
OVIRT_SERIES=4.4 make restart
|
|
```
|
|
|
|
**Hot-swap** (in-memory, без пересборки) — Web UI **API catalog** → **Apply as runtime**, или:
|
|
|
|
```bash
|
|
curl -s http://127.0.0.1:5000/ui/api/ovirt/contracts/activate \
|
|
-H 'Content-Type: application/json' \
|
|
-d '{"series":"4.4"}'
|
|
```
|
|
|
|
См. [Версии API](api-versions.md) и [Web UI](web-ui.md).
|
|
|
|
## Очистка клиентской лаборатории
|
|
|
|
```bash
|
|
make clean-test-resources
|
|
```
|
|
|
|
Удаляет ресурсы, созданные [`pulumi-tests/`](../../pulumi-tests/README.ru.md).
|
|
|
|
## Публикация в Docker Hub
|
|
|
|
`make release` собирает **runtime**-образ (production target — не локальный
|
|
bind-mounted образ `dev`) и публикует его в Docker Hub:
|
|
|
|
```bash
|
|
docker login # once; account must own or can push to DOCKERHUB_USER
|
|
make release
|
|
```
|
|
|
|
Значения по умолчанию:
|
|
|
|
| Переменная | По умолчанию | Назначение |
|
|
|---|---|---|
|
|
| `DOCKERHUB_USER` | `inecs` | Namespace/org в Docker Hub |
|
|
| `IMAGE_NAME` | `ovirt-api-simulator` | Имя репозитория |
|
|
| `VERSION` | from `pyproject.toml` | Тег образа |
|
|
| `PUSH_LATEST` | `1` | Также тегировать/пушить `:latest` |
|
|
|
|
Примеры:
|
|
|
|
```bash
|
|
make release
|
|
make release VERSION=0.2.0
|
|
make release DOCKERHUB_USER=myorg PUSH_LATEST=0
|
|
make release-build # build/tag locally without pushing
|
|
```
|
|
|
|
Опубликованные теги:
|
|
|
|
- `inecs/ovirt-api-simulator:<version>`
|
|
- `inecs/ovirt-api-simulator:latest` (если не `PUSH_LATEST=0`)
|
|
|
|
## Быстрый старт с опубликованным compose-файлом
|
|
|
|
[`docker-compose.release.yml`](../../docker-compose.release.yml) подтягивает
|
|
runtime-образ из Hub и запускает PostgreSQL + migrate + simulator + Engine gateway:
|
|
|
|
```bash
|
|
docker compose -f docker-compose.release.yml up -d
|
|
docker compose -f docker-compose.release.yml run --rm --entrypoint python \
|
|
simulator -m app.ovirt.seed_cli --profile minimal
|
|
|
|
curl -skf https://127.0.0.1/health/ready
|
|
```
|
|
|
|
Вспомогательные команды из git checkout:
|
|
|
|
```bash
|
|
make release-up
|
|
make release-seed PROFILE=minimal
|
|
# или: make release-seed PROFILE=demo
|
|
make release-down
|
|
```
|