Documentation-Driven Development: практическое руководство по генерации Go-кода из OpenAPI спецификаций с помощью oapi-codegen

Мастер-класс

Бэкенд / другое
Архитектурные паттерны
Методы и техника разработки ПО
GO
Управление разработкой
Бизнес-процессы
Оптимизация

Программный комитет ещё не принял решения по этому докладу

Целевая аудитория

Middle/Senior Go-разработчики, технические лиды и архитекторы, которые проектируют REST API и устали от проблем с синхронизацией кода и документации

Тезисы

Устали поддерживать актуальность Swagger-документации вручную после каждого изменения API? Вам знакомо чувство, когда разработчики работают по устаревшей спецификации?

Я расскажу, как мы внедрили Documentation-Driven подход в продакшене: теперь OpenAPI-спецификация — это единственный источник истины. Из неё мы автоматически генерируем Go-код сервера на любом фреймворке (echo/chi/…), клиентские SDK и даже валидацию для 15+ микросервисов. Мы сократили время на согласование API на 70% и полностью исключили рассогласование кода и документации.

Вы получите готовое пошаговое руководство: от написания первой спецификации в openapi.yaml до интеграции генерации в CI/CD при помощи Docker. Покажу, как за два часа настроить процесс, который сэкономит вашей команде сотни человеко-часов в год.

Матвей Лихота

МТС Web Services (MWS)

Прошёл путь от стажёра до сеньора, успел потимлидить. В настоящее время развивает инфраструктуру MWS. Любит музыку и увлекается информационной безопасностью в разработке.

Видео