Denozordec
da301b1a94
quality / commitlint (push) Skipped
quality / changes (push) Successful in 20s
quality / docker-check (push) Skipped
quality / openapi (push) Successful in 2m54s
quality / web (push) Successful in 1m22s
quality / go (push) Successful in 3m37s
quality / bird2 (push) Successful in 15s
CD / quality (push) Successful in 8m37s
CD / publish (push) Failing after 1m51s
- Added `@redocly/cli` version 1.34.5 to `package.json` and `pnpm-lock.yaml` for OpenAPI linting. - Updated CI workflows to reflect changes in job names and processes, including adjustments to the `publish` job in the CD workflow. - Enhanced documentation to clarify the new CI/CD processes and Docker build configurations.
56 lines
3.3 KiB
Markdown
56 lines
3.3 KiB
Markdown
# EvoBGP
|
||
|
||
Control plane для управления префиксами, модулями ingest, ревизиями конфигурации BIRD и выкладкой на BGP-спикеры. Репозиторий включает HTTP API на Go, веб-интерфейс (`web/`), CLI для реплик (`evobgp-node`), агент и Docker Compose для локального и эталонного развёртывания.
|
||
|
||
## Документация
|
||
|
||
| Документ | Содержание |
|
||
|----------|------------|
|
||
| [AGENTS.md](AGENTS.md) | Краткая карта репозитория и советы для ИИ-агентов (экономия контекста) |
|
||
| [docs/README.md](docs/README.md) | Оглавление и навигация по разделам |
|
||
| [docs/overview.md](docs/overview.md) | Ключевые возможности продукта |
|
||
| [docs/quickstart.md](docs/quickstart.md) | Быстрый запуск (Docker, локально, фронтенд) |
|
||
| [docs/architecture.md](docs/architecture.md) | Архитектура компонентов и потоков данных |
|
||
| [docs/api.md](docs/api.md) | Как работать с REST API и OpenAPI |
|
||
| [docs/access.md](docs/access.md) | API-ключи, роли, нода, CORS, безопасность |
|
||
|
||
Контракт HTTP API: [docs/openapi.yaml](docs/openapi.yaml). Человекочитаемый просмотр: [docs/openapi.html](docs/openapi.html) (см. [docs/OPENAPI-GITEA.md](docs/OPENAPI-GITEA.md)).
|
||
|
||
## Быстрый старт (Docker)
|
||
|
||
Из каталога [deploy/compose](deploy/compose) (PowerShell):
|
||
|
||
```powershell
|
||
cd deploy\compose
|
||
Copy-Item .env.example .env -Force # EVOBGP_REGISTRY=git.shx.one/<owner>
|
||
docker login git.shx.one
|
||
docker compose --profile microvps pull
|
||
docker compose --profile microvps up -d
|
||
```
|
||
|
||
Профиль **microvps** поднимает `evobgp-all`, PostgreSQL, BIRD2 и агент (образы из Container Registry, без `--build`). API по умолчанию: `http://localhost:8080`.
|
||
|
||
Эталонный стек (несколько сервисов, NATS, веб UI, Prometheus):
|
||
|
||
```powershell
|
||
docker compose --profile reference pull
|
||
docker compose --profile reference up -d
|
||
```
|
||
|
||
Подробности портов и переменных окружения — в [docs/quickstart.md](docs/quickstart.md) и в комментариях в [deploy/compose/docker-compose.yaml](deploy/compose/docker-compose.yaml).
|
||
|
||
## Разработка
|
||
|
||
- **Go:** модуль `evobgp`, точки входа в `cmd/`.
|
||
- **Веб:** SvelteKit в каталоге `web/` (см. [web/README.md](web/README.md)).
|
||
|
||
## Версионирование и релизы
|
||
|
||
Версии определяются автоматически из Conventional Commits при merge в `main` (semantic-release на Gitea Actions). Первая версия — **1.0.0**; ручной bump не нужен.
|
||
|
||
- [docs/releasing.md](docs/releasing.md) — пайплайн, commit conventions, секреты CI
|
||
- API: `GET /version` и `GET /v1/version` (поле `version`)
|
||
- Docker-образы: теги `latest`, `vX.Y.Z`, `X.Y.Z` — в **том же CD run**, что и релиз (job `publish`)
|
||
|
||
Лицензия и условия использования — по политике владельца репозитория.
|