R
Это факт. Я тоже выступаю за ведение API в формате OpenAPI + Git. Просто хотел послушать альтернативные мнения =)
Size: a a a
2020 February 24
PD
Есть экспорт из git в Confluence. Нормально, когда в CI при сборке обновляется и конфа тоже.
R
Есть экспорт из git в Confluence. Нормально, когда в CI при сборке обновляется и конфа тоже.
Экспорт именно спецификации API?
PD
Про спецификацию - не помню, но созданный html можно.
Может есть и генерация confluence страниц по спецификации...
Может есть и генерация confluence страниц по спецификации...
2020 February 25
I
Кстати, раз уж начали за всеобъемлющий Confluence. Что вы думаете про ведение спецификации API там?
Ну для этого есть специализированные решения - посмотрите в сторону ReDoc. Причем можно писать описание в md прямо в openapi. Ну а если вы большой и кровавый энтерпрайс то вам надо в сторону порталов разработчика смотреть :)
I
Это факт. Я тоже выступаю за ведение API в формате OpenAPI + Git. Просто хотел послушать альтернативные мнения =)
У меня gitlab через ci/cd генерирует статические страницы ReDoc и хостит их на gitlab pages. Для небольших api вполне подойдет.
AL
Про спецификацию - не помню, но созданный html можно.
Может есть и генерация confluence страниц по спецификации...
Может есть и генерация confluence страниц по спецификации...
Занимаюсь сейчас этим из моделера.
R
Ну для этого есть специализированные решения - посмотрите в сторону ReDoc. Причем можно писать описание в md прямо в openapi. Ну а если вы большой и кровавый энтерпрайс то вам надо в сторону порталов разработчика смотреть :)
Да-да, это все я как раз применяю. OpenAPI+ReDoc. Хотел послушать про альтернативы и аргументы в их пользу)
I
Да-да, это все я как раз применяю. OpenAPI+ReDoc. Хотел послушать про альтернативы и аргументы в их пользу)
У нас еще есть портал - с auth, контролем доступа, централизованным поиском и прочими плюшками. Портал в данном случае это часть API Management платформы.
R
У нас еще есть портал - с auth, контролем доступа, централизованным поиском и прочими плюшками. Портал в данном случае это часть API Management платформы.
На базе чего это сделано?
I
На данный момент это часть коммерческого продукта. Фактически у всех такое есть - apigee, akana, kong. Из бесплатных можно в сторону tyk или gravitee смотреть.
R
На данный момент это часть коммерческого продукта. Фактически у всех такое есть - apigee, akana, kong. Из бесплатных можно в сторону tyk или gravitee смотреть.
Благодарю за информацию. Гляну. Не пользовался этим софтом
I
Благодарю за информацию. Гляну. Не пользовался этим софтом
Всегда пожалуйста 😉 Если еще будут вопросы - обращайтесь.
I
Наткнулся тут недавно на интересный концепт архитектуры. Интересно, у себя никто такое делать не решился?
https://github.com/wso2/reference-architecture/blob/master/reference-architecture-cell-based.md
https://github.com/wso2/reference-architecture/blob/master/reference-architecture-cell-based.md
AK
На данный момент это часть коммерческого продукта. Фактически у всех такое есть - apigee, akana, kong. Из бесплатных можно в сторону tyk или gravitee смотреть.
А вы в итоге что выбрали из перечисленных решений по api managment?
I
А вы в итоге что выбрали из перечисленных решений по api managment?
Хм. Ну тут вопрос сложный. Выбрали apigee но есть и akana :) Правда сейчас больше в сторонку Service mesh смотрим. solo.io очень интересный вариант.
I
А вы в итоге что выбрали из перечисленных решений по api managment?
А вы тоже присматриваетесь?
AK
А вы тоже присматриваетесь?
apigee тоже выбрали, сейчас работаем над service mesh
I
apigee тоже выбрали, сейчас работаем над service mesh
Шортлист из кого сформировали?
RM
На данный момент это часть коммерческого продукта. Фактически у всех такое есть - apigee, akana, kong. Из бесплатных можно в сторону tyk или gravitee смотреть.
+ было бы интересно услышать что не устроило в tyk и gravitee. Api Management сейчас у многих видимо болит (