Примеры¶

Готовые примеры конфигураций для разных сценариев.

Содержание раздела¶

REST API — простой REST API сервис
gRPC сервис — gRPC с REST gateway
CLI приложение — CLI с генерацией команд из YAML
Telegram бот — Telegram бот
Multi-app — несколько приложений из одной кодовой базы

Быстрый выбор¶

Сценарий	Пример
Простой REST API	REST API
gRPC с REST gateway	gRPC сервис
CLI утилита / admin tool	CLI приложение
Telegram бот	Telegram бот
E-commerce с воркерами	Multi-app
Микросервис с Kafka	Multi-app

Минимальная конфигурация¶

Простейший сервис с одним REST API:

main:
  name: simple-api
  logger: zerolog

git:
  repo: github.com/myorg/simple-api
  module_path: github.com/myorg/simple-api

rest:
  - name: api
    path: [./api/openapi.yaml]
    generator_type: ogen
    port: 8080
    version: v1

  - name: sys
    generator_type: template
    generator_template: sys
    port: 9090
    version: v1

applications:
  - name: server
    transport: [api, sys]

Что генерируется¶

Для каждого примера генерируется:

~50 файлов, готовых к запуску
Docker и Docker Compose
GitHub Actions CI/CD
Makefile с 40+ целями
Prometheus метрики
Structured logging

Следующие шаги¶

Выберите пример, наиболее близкий к вашему сценарию, и адаптируйте под свои нужды.