{"id":463189,"date":"2025-06-13T10:18:29","date_gmt":"2025-06-13T10:18:29","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=463189"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=463189","title":{"rendered":"\u041e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f API-first \u043f\u043e\u0434\u0445\u043e\u0434\u0430, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f OpenAPI generator \u0438 Gitlab CI<\/span>"},"content":{"rendered":"
<\/div>\n
\n
\n
\n
\n

\u041e\u0434\u043d\u0430\u0436\u0434\u044b \u044f \u0432\u043d\u0435\u0434\u0440\u0438\u043b \u0432 \u0441\u0432\u043e\u0435\u0439 \u043a\u043e\u043c\u0430\u043d\u0434\u0435 \u043f\u043e\u0434\u0445\u043e\u0434 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0447\u0435\u0440\u0435\u0437 API-first. \u0412\u0441\u0435 \u0431\u044b\u043b\u043e \u043a\u043b\u0430\u0441\u0441\u043d\u043e, \u043c\u044b \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u043b\u0438 API \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0432 \u0444\u0430\u0439\u043b\u0435, \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u043b\u0438 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e, \u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u043b\u0438 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u043d\u043e \u043c\u0435\u043d\u044f \u043d\u0435 \u043f\u043e\u043a\u0438\u0434\u0430\u043b\u043e \u0447\u0443\u0432\u0441\u0442\u0432\u043e, \u0447\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u044d\u0442\u0438\u043c \u043d\u0435 \u0442\u0430\u043a \u0443\u0434\u043e\u0431\u043d\u043e \u043a\u0430\u043a \u044f \u0441\u0435\u0431\u0435 \u044d\u0442\u043e \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u043b, \u0438 \u044f \u0441\u0442\u0430\u043b \u0438\u0441\u043a\u0430\u0442\u044c \u043f\u0440\u0438\u0447\u0438\u043d\u044b.<\/p>\n

\u041f\u0440\u0435\u0436\u0434\u0435, \u0447\u0435\u043c \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0438\u0442\u044c, \u043d\u0435\u043c\u043d\u043e\u0433\u043e \u0434\u043e\u0431\u0430\u0432\u043b\u044e \u043f\u0440\u043e \u0441\u0432\u043e\u0439 \u0441\u0442\u0435\u043a: Java, Spring Framework \u0438 \u0432\u0441\u0435-\u0432\u0441\u0435-\u0432\u0441\u0435 \u0438\u0437 \u044d\u0442\u043e\u0439 «\u0438\u0441\u0442\u043e\u0440\u0438\u0438».<\/p>\n

\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044f\u0441\u044c \u043a \u043f\u0435\u0440\u0432\u043e\u043c\u0443 \u043f\u0440\u0438\u0441\u0435\u0434\u0430\u043d\u0438\u044f \u0441 API-first…<\/p>\n

\u0421\u0442\u0430\u0440\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434<\/h2>\n

\u0420\u0430\u043d\u044c\u0448\u0435 \u044f \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043b \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0435\u043d\u043d\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0431\u044b\u043b\u043e 2 \u043c\u043e\u0434\u0443\u043b\u044f — API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0438 \u0441\u0430\u043c\u043e \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435. \u041f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:<\/p>\n

\"crud-service-api<\/p>\n
crud-service-api (API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b), crud-service-app (\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435)<\/figcaption><\/div>\n<\/figure>\n

\u0413\u0434\u0435-\u0442\u043e \u0412 API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0435 (crud-service-api<\/strong> \u0432 \u0434\u0430\u043d\u043d\u043e\u043c \u0441\u043b\u0443\u0447\u0430\u0435) \u043b\u0435\u0436\u0430\u043b \u0444\u0430\u0439\u043b \u0441\u043e \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0435\u0439 (openapi.yaml) \u0438 \u0432 Gradle (\u0443 \u0432\u0430\u0441 \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c Maven<\/em>) \u0431\u044b\u043b \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d OpenAPI generator, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043b \u043a\u043b\u0430\u0441\u0441\u044b \u0434\u043b\u044f \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u0438 jar, \u0437\u0430\u0442\u0435\u043c \u044d\u0442\u043e\u0442 jar \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u043b\u0441\u044f \u0432 maven-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439.<\/p>\n

\n

\u041e\u0442\u043c\u0435\u0447\u0443, \u0447\u0442\u043e \u0434\u043b\u044f \u0434\u0440\u0443\u0433\u0438\u0445 \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432 \u043c\u044b \u043d\u0435 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043b\u0438 API, \u0442\u0430\u043a \u043a\u0430\u043a \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0444\u0440\u043e\u043d\u0442\u043e\u0432 \u0438 \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0445 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0439 \u043d\u0435 \u0431\u044b\u043b\u0438 \u0433\u043e\u0442\u043e\u0432\u044b \u043a \u044d\u0442\u043e\u043c\u0443 \u043f\u043e\u0434\u0445\u043e\u0434\u0443, \u0437\u0430\u0442\u043e \u0443 \u043d\u0430\u0441 \u0431\u044b\u043b\u043e \u043c\u043d\u043e\u0433\u043e \u043c\u0435\u0436\u0441\u0435\u0440\u0432\u0438\u0441\u043d\u044b\u0445 \u043e\u0431\u0449\u0435\u043d\u0438\u0439 \u043f\u043e REST. \u041d\u0443 \u0438 \u043d\u0438\u0447\u0442\u043e \u043d\u0435 \u043c\u0435\u0448\u0430\u043b\u043e \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0438\u0442\u044c \u044d\u0442\u043e\u0442 \u043f\u043e\u0434\u0445\u043e\u0434 \u0438 \u043d\u0430 \u043d\u0430\u0448\u0438\u0445 \u043a\u043e\u043b\u043b\u0435\u0433 (\u0444\u0440\u043e\u043d\u0442\u043e\u0432 \u0438 \u043c\u043e\u0431\u0438\u043b\u044c\u0449\u0438\u043a\u043e\u0432).<\/p>\n<\/blockquote>\n

\u0418 \u0432 \u0447\u0435\u043c \u0442\u0443\u0442 \u0436\u0435 \u043d\u0435\u0443\u0434\u043e\u0431\u0441\u0442\u0432\u043e?<\/strong><\/p>\n

\u0421\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0435\u043c \u0443\u0432\u0435\u043b\u0438\u0447\u0438\u0432\u0430\u043b\u043e\u0441\u044c \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0437\u0430\u0434\u0430\u0447, \u0430 \u0442\u0430\u043a \u0436\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u0438 \u043f\u043e\u0442\u043e\u043a\u043e\u0432 \u0434\u0430\u043d\u043d\u044b\u0445 \u043c\u0435\u0436\u0434\u0443 \u043d\u0438\u043c\u0438. \u0418 \u0442\u0443\u0442 \u044f \u043d\u0430\u0447\u0430\u043b \u043e\u0441\u043e\u0437\u043d\u0430\u0432\u0430\u0442\u044c — \u043d\u0435\u0443\u0434\u043e\u0431\u0441\u0442\u0432\u043e \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u0432 \u043a\u0430\u0436\u0434\u043e\u043c \u0441\u0435\u0440\u0432\u0438\u0441\u0435 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043d\u0443\u0436\u043d\u043e \u0432\u043d\u043e\u0441\u0438\u0442\u044c \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b, \u043f\u0443\u0448\u0438\u0442\u044c \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u0433\u0438\u0442, \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0442\u044c CI, \u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u0442\u044c \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b. \u0410 \u0435\u0449\u0435 \u0443 \u043d\u0430\u0441 \u0431\u044b\u043b\u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u044f\u044e\u0449\u0438\u0435\u0441\u044f \u043c\u043e\u0434\u0435\u043b\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043f\u0440\u043e\u0441\u0442\u043e \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u043b\u043e\u0441\u044c \u0434\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0440\u0430\u0437\u043c\u0430\u0437\u044b\u0432\u0430\u0442\u044c<\/s> \u0432\u043e \u0432\u0441\u0435\u0445 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u0445 (\u0441\u0435\u0440\u0432\u0438\u0441\u0430\u0445). \u041d\u0443 \u0438 \u043d\u0430\u043f\u043e\u0441\u043b\u0435\u0434\u043e\u043a, \u0445\u043e\u0442\u044c \u0438 \u043d\u0435 \u0447\u0430\u0441\u0442\u043e, \u043f\u0440\u0438 \u0432\u043d\u0435\u0441\u0435\u043d\u0438\u0438 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0439 \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0430, \u044d\u0442\u043e \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u0431\u044b\u043b\u043e \u0434\u0435\u043b\u0430\u0442\u044c \u0432\u043e \u0432\u0441\u0435\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445.<\/p>\n

\n

\u0412\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u043c\u0438\u043d\u0443\u0441\u043e\u0432 \u044d\u0442\u043e\u0433\u043e \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u0431\u043e\u043b\u044c\u0448\u0435, \u043f\u043e\u043a\u0430 \u043f\u0438\u0441\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u044e, \u0432\u0441\u043f\u043e\u043c\u043d\u0438\u043b \u0442\u043e\u043b\u044c\u043a\u043e \u044d\u0442\u0438.<\/p>\n<\/blockquote>\n

\u0422\u0430\u043a\u0438\u043c \u043e\u0431\u0440\u0430\u0437\u043e\u043c \u044f \u043d\u0430\u0447\u0430\u043b \u0434\u0443\u043c\u0430\u0442\u044c \u043e\u0431 \u0438\u043d\u043e\u043c \u043f\u043e\u0434\u0445\u043e\u0434\u0435 \u0438 \u043f\u0440\u0438\u0448\u0435\u043b \u043a \u0442\u043e\u043c\u0443, \u043e \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u0440\u0430\u0441\u0441\u043a\u0430\u0436\u0443 \u0432\u0430\u043c \u0434\u0430\u043b\u0435\u0435.<\/p>\n

\u041d\u043e\u0432\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434<\/h2>\n

\u0418\u0434\u0435\u044f \u0441\u0432\u043e\u0434\u0438\u043b\u0430\u0441\u044c \u043a \u043f\u0440\u043e\u0441\u0442\u043e\u043c\u0443: \u0435\u0441\u0442\u044c \u043c\u043e\u043d\u043e-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0432 \u043d\u0435\u043c \u043f\u043e \u043f\u0430\u043f\u043a\u0430\u043c \u0440\u0430\u0437\u043b\u043e\u0436\u0435\u043d\u044b API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0438 \u043e\u0431\u0449\u0438\u0435 \u043c\u043e\u0434\u0435\u043b\u0438, \u0441\u0431\u043e\u0440\u043a\u0430 \u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u044f \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u043e\u0432 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0441\u044f \u043e\u0442\u0442\u0443\u0434\u0430 \u0436\u0435. \u0422\u0430\u043a \u0438 \u0432\u044b\u0448\u043b\u043e.<\/p>\n

\"\"<\/p>\n
\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043c\u043e\u043d\u043e-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f<\/figcaption><\/div>\n<\/figure>\n
\"\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430<\/p>\n
\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043f\u0430\u043f\u043a\u0438 common<\/figcaption><\/div>\n<\/figure>\n

\u0412 \u043f\u0430\u043f\u043a\u0435 common \u043c\u043e\u0433\u0443\u0442 \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u044c\u0441\u044f \u043b\u044e\u0431\u044b\u0435 \u043e\u0431\u0449\u0438\u0435 \u0438 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u044b\u0435 \u043c\u043e\u0434\u0435\u043b\u0438 \u0438 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438. \u0412 \u043c\u043e\u0435\u043c \u043f\u0440\u043e\u0441\u0442\u043e\u043c \u043f\u0440\u0438\u043c\u0435\u0440\u0435, \u044d\u0442\u043e \u0444\u0430\u0439\u043b models.yaml \u0441 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435\u043c Page \u0438 Pageable \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432<\/p>\n

\u0421\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 \u0444\u0430\u0439\u043b\u0430 models.yaml<\/strong>:<\/p>\n

Page:   type: object   description: 'Description'   properties:     size:       type: integer     page:       type: integer     totalElements:       type: integer     totalPages:       type: integer  Pageable:   type: object   description: 'Description'   properties:     size:       type: integer     page:       type: integer     sort:       type: array       items:         type: string <\/code><\/pre>\n
\"\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430<\/p>\n
\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043f\u0430\u043f\u043a\u0438 crud-service-api<\/figcaption><\/div>\n<\/figure>\n
\u0412\u043e\u0442 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a\u0430\u044f \u043f\u0440\u043e\u0441\u0442\u0430\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u0443 \u043c\u0435\u043d\u044f \u043f\u043e\u043b\u0443\u0447\u0438\u043b\u0430\u0441\u044c. \u041f\u0440\u0438\u0432\u043e\u0434\u0438\u0442\u044c \u043f\u0440\u0438\u043c\u0435\u0440 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b notification-service-api<\/strong> \u043d\u0435 \u0441\u0442\u0430\u043b, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043e\u043d\u0430 \u0438\u0434\u0435\u043d\u0442\u0438\u0447\u043d\u0430 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0435 crud-service-api<\/strong>.<\/p>\n
\u0414\u0430\u0432\u0430\u0439\u0442\u0435 \u043d\u0435\u043c\u043d\u043e\u0433\u043e \u043f\u0440\u043e\u0431\u0435\u0436\u0438\u043c\u0441\u044f \u043f\u043e CI \u0444\u0430\u0439\u043b\u0430\u043c.<\/p>\n
1) \u041a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 .gitlab-ci.yml<\/strong>:<\/p>\n
stages:   - trigger  .trigger:   stage: trigger   trigger:     strategy: depend  crud-service-api:   extends: .trigger   trigger:     include: crud-service-api\/.gitlab-ci.yml   rules:     - changes:         - crud-service-api\/*  notification-service-api:   extends: .trigger   trigger:     include: notification-service-api\/.gitlab-ci.yml   rules:     - changes:         - notification-service-api\/*<\/code><\/pre>\n
\u0417\u0434\u0435\u0441\u044c \u043e\u043f\u0438\u0441\u0430\u043d\u044b \u0442\u0440\u0438\u0433\u0433\u0435\u0440\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0431\u0443\u0434\u0443\u0442 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0442\u044c \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u044b \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u0442\u0435\u0445 \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432, \u0432 \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0431\u044b\u043b\u0438 \u0432\u043d\u0435\u0441\u0435\u043d\u044b \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f.<\/p>\n
2) \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0439 .api-first.gitlab-ci.yml<\/strong>:<\/p>\n
stages:   - validate   - prepare   - generate   - publish  variables:   OPENAPI_GENERATOR: registry.gitlab.com\/dmitrii-demchenko\/infrastructure\/custom-docker-images\/openapi-generator-cli:1.0.0   OPENAPI_GENERATOR_CLI: java -jar \/opt\/openapi-generator-cli.jar  # Stage: validate validate:   stage: validate   image: ${OPENAPI_GENERATOR}   script:     - cp ${OPENAPI_SPEC_PATH}\/openapi.yaml openapi.yaml     - ${OPENAPI_GENERATOR_CLI} validate -i openapi.yaml   rules:     - if: $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == \"main\"       when: always     - if: $CI_COMMIT_BRANCH == \"main\"       when: always   artifacts:     paths:       - openapi.yaml   tags:     - docker  # Stage: prepare .prepare:   stage: prepare   before_script:     - mkdir -p configs\/shared     - |       cat > configs\/shared\/common.yaml <<EOF       inputSpec: openapi.yaml       EOF   rules:     - if: $CI_COMMIT_BRANCH == \"main\"       when: on_success   artifacts:     paths:       - openapi.yaml       - configs     expire_in: 1w   needs:     - job: validate   tags:     - docker  prepare:spring-cloud-interface:   extends: .prepare   script:     - |       cat > configs\/shared\/spring-cloud-interface.yaml <<EOF       ${SPRING_CLOUD_INTERFACE_INCLUDE_CONFIG}       EOF     - |       cat > configs\/spring-cloud-interface.yaml <<EOF       '!include': 'shared\/common.yaml'       outputDir: generated\/spring-cloud-interface       generatorName: spring       '!include': 'shared\/spring-cloud-interface.yaml'       additionalProperties:         artifactId                    : ${JAR_ARTIFACT_ID}         groupId                       : ${JAR_GROUP_ID}         apiPackage                    : ${JAR_API_PACKAGE}         modelPackage                  : ${JAR_MODEL_PACKAGE}         library                       : spring-cloud         dateLibrary                   : java8         useSpringBoot3                : true         useTags                       : true         interfaceOnly                 : true         openApiNullable               : false         documentationProvider         : none         hideGenerationTimestamp       : true         additionalModelTypeAnnotations: '@com.fasterxml.jackson.annotation.JsonIgnoreProperties(ignoreUnknown = true) @lombok.Getter @lombok.Setter @lombok.AllArgsConstructor @lombok.NoArgsConstructor'       EOF  # Stage: generate generate:   stage: generate   image: ${OPENAPI_GENERATOR}   script:     # - *script-clone-common     - ${OPENAPI_GENERATOR_CLI} batch configs\/*.yaml   rules:     - if: $CI_COMMIT_BRANCH == \"main\"       when: on_success   artifacts:     paths:       - generated     expire_in: 1w   needs:     - job: prepare:spring-cloud-interface       artifacts: true   tags:     - docker  # Stage: publish .publish:   stage: publish   rules:     - if: $CI_COMMIT_BRANCH == \"main\"       when: manual   allow_failure: true   tags:     - docker  .publish:maven:   extends: .publish   image: maven:3-eclipse-temurin-21-alpine   variables:     MAVEN_OPTS: \"-Dmaven.repo.local=${CI_PROJECT_DIR}\/.m2\/repository\"     MAVEN_CLI_OPTS: \"-Dmaven.test.skip=true -s settings.xml\"   script:     - echo ${MAVEN_SETTINGS_XML} > settings.xml     - mvn deploy ${MAVEN_CLI_OPTS} -DaltDeploymentRepository=${MAVEN_SERVER_ID}::${MAVEN_SANDBOX_URL}   cache:     paths:       - '.m2\/repository'  publish:spring-cloud-interface:   extends: .publish:maven   before_script:     - cd generated\/spring-cloud-interface   needs:     - job: generate       artifacts: true<\/code><\/pre>\n
\u042d\u0442\u043e\u0442 \u0444\u0430\u0439\u043b \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0437\u0432\u0430\u0442\u044c \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u043c, \u0442\u0430\u043a \u043a\u0430\u043a \u0432 \u043d\u0435\u043c \u043e\u043f\u0438\u0441\u0430\u043d\u044b \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u0435 \u0434\u0436\u043e\u0431\u044b.<\/p>\n
3) \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043d\u044b\u0439 (\u043d\u0430 \u043f\u0440\u0438\u043c\u0435\u0440\u0435 crud-service-api\/.gitlab-ci.yml<\/em><\/strong>):<\/p>\n
include:   - local: .api-first.gitlab-ci.yml  variables:   OPENAPI_SPEC_PATH: crud-service-api   JAR_GROUP_ID: com.example   JAR_ARTIFACT_ID: crud-service-api   JAR_API_PACKAGE: com.example.crud.api   JAR_MODEL_PACKAGE: com.example.crud.api.model   SPRING_CLOUD_INTERFACE_INCLUDE_CONFIG: |-     typeMappings:       'OrderPageDto': 'Page<OrderDto>'     importMappings:       'Page': 'org.springframework.data.domain.Page'       'Pageable': 'org.springframework.data.domain.Pageable'       'Page<OrderDto>': 'org.springframework.data.domain.Page'<\/code><\/pre>\n
\u0412 \u044d\u0442\u043e\u043c \u0436\u0435 \u0444\u0430\u0439\u043b\u0435 \u0443\u0436\u0435 \u0438\u0434\u0435\u0442 \u043f\u0435\u0440\u0435\u0434\u0430\u0447\u0430 \u043a\u043e\u043d\u0435\u0447\u043d\u044b\u0445 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u043c, \u043f\u0440\u0435\u0434\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u043d\u044b\u043c \u0432 \u0444\u0430\u0439\u043b\u0435 \u0432\u044b\u0448\u0435.<\/p>\n
\u0414\u0430, \u0447\u0443\u0442\u044c \u043d\u0435 \u0437\u0430\u0431\u044b\u043b…<\/h2>\n
\u0427\u0442\u043e \u0437\u0430 \u043e\u0431\u0440\u0430\u0437 \u0442\u0430\u043a\u043e\u0439 registry.gitlab.com\/dmitrii-demchenko\/infrastructure\/custom-docker-images\/openapi-generator-cli:1.0.0<\/code>?<\/p>\n
\u0414\u043b\u044f \u0443\u0434\u043e\u0431\u0441\u0442\u0432\u0430 \u0441\u0431\u043e\u0440\u043a\u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 \u044f \u0441\u0434\u0435\u043b\u0430\u043b \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u043e\u0431\u0440\u0430\u0437 \u0441 openapi-generator-cli<\/code> \u043d\u0430 \u0431\u043e\u0440\u0442\u0443.<\/p>\n
Dockerfile:<\/p>\n
FROM eclipse-temurin:21-jre-alpine  ARG VERSION=7.10.0 ARG OPENAPI_URL=https:\/\/repo1.maven.org\/maven2\/org\/openapitools\/openapi-generator-cli\/${VERSION}\/openapi-generator-cli-${VERSION}.jar  ADD ${OPENAPI_URL} \/opt\/openapi-generator-cli.jar<\/code><\/pre>\n
\u0418 \u0435\u0449\u0435 \u0443 \u043c\u0435\u043d\u044f \u0435\u0441\u0442\u044c \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0430\u044f MAVEN_SETTINGS_XML<\/code> \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043d\u0438\u0433\u0434\u0435 \u043d\u0435 \u0437\u0430\u0434\u0430\u043d\u043e \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435. \u042d\u0442\u043e \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u0430\u044f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0430\u044f, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0430 \u0432 Gitlab CI\/CI variables \u0432 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430\u0445 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u0438 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u043a\u0440\u0435\u0434\u044b \u043a maven-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e. \u0418 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043e\u043d\u0430 \u0432\u043e\u0442 \u0442\u0430\u043a:<\/p>\n
<settings xmlns=\"http:\/\/maven.apache.org\/SETTINGS\/1.1.0\">     <servers>         <server>             <id>maven-sandbox<\/id>             <username>${env.MAVEN_SANDBOX_USERNAME}<\/username>             <password>${env.MAVEN_SANDBOX_PASSWORD}<\/password>         <\/server>     <\/servers> <\/settings><\/code><\/pre>\n
\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u043c \u043f\u0435\u0440\u0432\u044b\u0439 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d (\u043d\u0430 \u0441\u0430\u043c\u043e\u043c \u0434\u0435\u043b\u0435 \u043d\u0435 \u043f\u0435\u0440\u0432\u044b\u0439, \u043d\u043e \u043f\u0435\u0440\u0432\u044b\u0439 \u0443\u0434\u0430\u0447\u043d\u044b\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043d\u0435 \u0441\u0442\u044b\u0434\u043d\u043e \u043f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0432\u0430\u043c<\/em>):<\/p>\n
<\/figure>\n
\u0418 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c \u0437\u0430\u0433\u0440\u0443\u0436\u0435\u043d\u043d\u044b\u0439 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442 \u0432 \u043b\u044e\u0431\u043e\u0439 \u0443\u0434\u043e\u0431\u043d\u044b\u0439 \u0434\u043b\u044f \u0432\u0430\u0441 maven-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439.<\/p>\n
\"\u0410\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b<\/p>\n
\u0410\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438<\/figcaption><\/div>\n<\/figure>\n
\u041a\u0442\u043e \u0438 \u043a\u0430\u043a \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0441 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438<\/h2>\n
\u0420\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u043c \u043c\u043e\u0436\u0435\u0442 \u043a\u0442\u043e \u0443\u0433\u043e\u0434\u043d\u043e, \u0441\u0438\u0441\u0442\u0435\u043c\u043d\u044b\u0439 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a \u0438\u043b\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a, \u0442\u0443\u0442 \u0432\u0441\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u0442 \u043e\u0442 \u043f\u0440\u0438\u043d\u044f\u0442\u044b\u0445 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u043e\u0432 \u043d\u0430 \u043f\u0440\u043e\u0435\u043a\u0442\u0435. \u0412 \u043d\u0430\u0448\u0435\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435\u043c \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u044b\u0445 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0439 \u0437\u0430\u043d\u0438\u043c\u0430\u044e\u0442\u0441\u044f \u0441\u0430\u043c\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438. \u0412\u0441\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0432\u043d\u043e\u0441\u044f\u0442\u0441\u044f \u043b\u0438\u0431\u043e \u043f\u043e\u0441\u043b\u0435 \u0441\u0438\u0441\u0442\u0435\u043c\u043d\u043e\u0439 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0438, \u043b\u0438\u0431\u043e \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e. \u0410\u043f\u043f\u0440\u0443\u0432\u044f\u0442 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438 \u043f\u043e\u0441\u043b\u0435 \u043f\u0440\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0440\u0435\u0432\u044c\u044e.<\/p>\n
\u0412\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d\u043e \u043f\u043e \u043f\u0440\u043e\u0441\u0442\u043e\u043c\u0443, \u0447\u0435\u0440\u0435\u0437 \u0443\u043a\u0430\u0437\u0430\u043d\u0438\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 \u0432 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u0441\u0435\u0440\u0432\u0438\u0441\u0430.<\/p>\n
\u0411\u044b\u043b\u0430 \u0432\u0435\u0440\u0441\u0438\u044f 1.0.0:<\/p>\n
openapi: 3.0.3  info:   title: CRUD service API   description: CRUD service API   version: 1.0.0<\/code><\/pre>\n
\u0421\u0442\u0430\u043b\u0430 1.1.0:<\/p>\n
openapi: 3.0.3  info:   title: CRUD service API   description: CRUD service API   version: 1.1.0<\/code><\/pre>\n
\u0414\u0430\u043b\u0435\u0435 \u043e\u0431\u044b\u0447\u043d\u0430\u044f \u0441\u0431\u043e\u0440\u043a\u0430 \u0438 \u0434\u0435\u043f\u043b\u043e\u0439 \u0438\u0437 main \u0432\u0435\u0442\u043a\u0438.<\/p>\n
\u0418\u0442\u043e\u0433\u0438<\/h2>\n
\u041a\u0430\u043a \u044f \u0438 \u0445\u043e\u0442\u0435\u043b, \u044f \u043f\u043e\u043b\u0443\u0447\u0438\u043b \u0443\u0434\u043e\u0431\u043d\u044b\u0439 (\u043f\u043e \u043a\u0440\u0430\u0439\u043d\u0435\u0439 \u043c\u0435\u0440\u0435 \u0434\u043b\u044f \u0441\u0435\u0431\u044f \u0438 \u0441\u0432\u043e\u0438\u0445 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432) \u0441\u043f\u043e\u0441\u043e\u0431 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f, \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0438 \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0435\u043d\u0438\u044f API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432. \u041e\u043d \u0442\u0430\u043a \u0436\u0435 \u043e\u0442\u043b\u0438\u0447\u043d\u043e \u043b\u043e\u0436\u0438\u0442\u0441\u044f \u043d\u0430 \u043f\u043e\u0434\u0445\u043e\u0434 API-first.<\/p>\n
\u0423\u0432\u0435\u0440\u0435\u043d, \u0432 \u044d\u0442\u043e\u043c \u043f\u043e\u0434\u0445\u043e\u0434\u0435 \u0435\u0441\u0442\u044c \u0432\u0435\u0449\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043c\u043e\u0436\u043d\u043e \u0443\u043b\u0443\u0447\u0448\u0438\u0442\u044c \u0438 \u044f \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0430\u044e \u0438\u0441\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u0442\u044c \u044d\u0442\u043e\u0442 \u0432\u043e\u043f\u0440\u043e\u0441.<\/p>\n
PS: \u043d\u0435 \u0431\u0443\u0434\u0443 \u0432\u0434\u0430\u0432\u0430\u0442\u044c\u0441\u044f \u0432 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438 CLI \u043a\u043e\u043c\u0430\u043d\u0434 openapi \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0430, \u0441 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 \u044d\u0442\u043e\u0433\u043e \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430 \u0438 \u0442\u0435\u043c, \u043a\u0430\u043a \u044f \u043d\u0430\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u043b \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0434\u043b\u044f \u0441\u0431\u043e\u0440\u043a\u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430, \u043c\u043e\u0436\u043d\u043e \u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u0442\u044c\u0441\u044f \u043f\u043e \u0441\u0441\u044b\u043b\u043a\u0430\u043c:<\/p>\n
https:\/\/openapi-generator.tech\/docs\/usage#batch<\/a><\/p>\n
https:\/\/openapi-generator.tech\/docs\/generators\/spring\/<\/a><\/p>\n
\u0412 \u043f\u043b\u0430\u043d\u0430\u0445 \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u0447\u0442\u043e-\u0442\u043e \u043f\u043e\u0445\u043e\u0436\u0435\u0435 \u0434\u043b\u044f \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0445 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 (Kafka, RabbitMQ, \u0438 \u0442\u0434).<\/p>\n
\u0412\u043e\u043f\u0440\u043e\u0441\u044b, \u043a\u0440\u0438\u0442\u0438\u043a\u0430 \u0438 \u043f\u0440\u0435\u0434\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u0432 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0438.<\/p>\n
\u0421\u043f\u0430\u0441\u0438\u0431\u043e \u0437\u0430 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435. <\/p>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n

 \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438  https:\/\/habr.com\/ru\/articles\/884412\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
<\/div>\n
\n
\n
\n
\n
\u041e\u0434\u043d\u0430\u0436\u0434\u044b \u044f \u0432\u043d\u0435\u0434\u0440\u0438\u043b \u0432 \u0441\u0432\u043e\u0435\u0439 \u043a\u043e\u043c\u0430\u043d\u0434\u0435 \u043f\u043e\u0434\u0445\u043e\u0434 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0447\u0435\u0440\u0435\u0437 API-first. \u0412\u0441\u0435 \u0431\u044b\u043b\u043e \u043a\u043b\u0430\u0441\u0441\u043d\u043e, \u043c\u044b \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u043b\u0438 API \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0432 \u0444\u0430\u0439\u043b\u0435, \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u043b\u0438 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e, \u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u043b\u0438 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u043d\u043e \u043c\u0435\u043d\u044f \u043d\u0435 \u043f\u043e\u043a\u0438\u0434\u0430\u043b\u043e \u0447\u0443\u0432\u0441\u0442\u0432\u043e, \u0447\u0442\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u044d\u0442\u0438\u043c \u043d\u0435 \u0442\u0430\u043a \u0443\u0434\u043e\u0431\u043d\u043e \u043a\u0430\u043a \u044f \u0441\u0435\u0431\u0435 \u044d\u0442\u043e \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u043b, \u0438 \u044f \u0441\u0442\u0430\u043b \u0438\u0441\u043a\u0430\u0442\u044c \u043f\u0440\u0438\u0447\u0438\u043d\u044b.<\/p>\n
\u041f\u0440\u0435\u0436\u0434\u0435, \u0447\u0435\u043c \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0438\u0442\u044c, \u043d\u0435\u043c\u043d\u043e\u0433\u043e \u0434\u043e\u0431\u0430\u0432\u043b\u044e \u043f\u0440\u043e \u0441\u0432\u043e\u0439 \u0441\u0442\u0435\u043a: Java, Spring Framework \u0438 \u0432\u0441\u0435-\u0432\u0441\u0435-\u0432\u0441\u0435 \u0438\u0437 \u044d\u0442\u043e\u0439 «\u0438\u0441\u0442\u043e\u0440\u0438\u0438».<\/p>\n
\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044f\u0441\u044c \u043a \u043f\u0435\u0440\u0432\u043e\u043c\u0443 \u043f\u0440\u0438\u0441\u0435\u0434\u0430\u043d\u0438\u044f \u0441 API-first…<\/p>\n
\u0421\u0442\u0430\u0440\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434<\/h2>\n
\u0420\u0430\u043d\u044c\u0448\u0435 \u044f \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043b \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0435\u043d\u043d\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0431\u044b\u043b\u043e 2 \u043c\u043e\u0434\u0443\u043b\u044f — API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0438 \u0441\u0430\u043c\u043e \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435. \u041f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:<\/p>\n
\n
crud-service-api (API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b), crud-service-app (\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435)<\/figcaption><\/div>\n<\/figure>\n
\u0413\u0434\u0435-\u0442\u043e \u0412 API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0435 (crud-service-api<\/strong> \u0432 \u0434\u0430\u043d\u043d\u043e\u043c \u0441\u043b\u0443\u0447\u0430\u0435) \u043b\u0435\u0436\u0430\u043b \u0444\u0430\u0439\u043b \u0441\u043e \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0435\u0439 (openapi.yaml) \u0438 \u0432 Gradle (\u0443 \u0432\u0430\u0441 \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c Maven<\/em>) \u0431\u044b\u043b \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d OpenAPI generator, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043b \u043a\u043b\u0430\u0441\u0441\u044b \u0434\u043b\u044f \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u0438 jar, \u0437\u0430\u0442\u0435\u043c \u044d\u0442\u043e\u0442 jar \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u043b\u0441\u044f \u0432 maven-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439.<\/p>\n
\n
\u041e\u0442\u043c\u0435\u0447\u0443, \u0447\u0442\u043e \u0434\u043b\u044f \u0434\u0440\u0443\u0433\u0438\u0445 \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432 \u043c\u044b \u043d\u0435 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043b\u0438 API, \u0442\u0430\u043a \u043a\u0430\u043a \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0444\u0440\u043e\u043d\u0442\u043e\u0432 \u0438 \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0445 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0439 \u043d\u0435 \u0431\u044b\u043b\u0438 \u0433\u043e\u0442\u043e\u0432\u044b \u043a \u044d\u0442\u043e\u043c\u0443 \u043f\u043e\u0434\u0445\u043e\u0434\u0443, \u0437\u0430\u0442\u043e \u0443 \u043d\u0430\u0441 \u0431\u044b\u043b\u043e \u043c\u043d\u043e\u0433\u043e \u043c\u0435\u0436\u0441\u0435\u0440\u0432\u0438\u0441\u043d\u044b\u0445 \u043e\u0431\u0449\u0435\u043d\u0438\u0439 \u043f\u043e REST. \u041d\u0443 \u0438 \u043d\u0438\u0447\u0442\u043e \u043d\u0435 \u043c\u0435\u0448\u0430\u043b\u043e \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0438\u0442\u044c \u044d\u0442\u043e\u0442 \u043f\u043e\u0434\u0445\u043e\u0434 \u0438 \u043d\u0430 \u043d\u0430\u0448\u0438\u0445 \u043a\u043e\u043b\u043b\u0435\u0433 (\u0444\u0440\u043e\u043d\u0442\u043e\u0432 \u0438 \u043c\u043e\u0431\u0438\u043b\u044c\u0449\u0438\u043a\u043e\u0432).<\/p>\n<\/blockquote>\n
\u0418 \u0432 \u0447\u0435\u043c \u0442\u0443\u0442 \u0436\u0435 \u043d\u0435\u0443\u0434\u043e\u0431\u0441\u0442\u0432\u043e?<\/strong><\/p>\n
\u0421\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0435\u043c \u0443\u0432\u0435\u043b\u0438\u0447\u0438\u0432\u0430\u043b\u043e\u0441\u044c \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0437\u0430\u0434\u0430\u0447, \u0430 \u0442\u0430\u043a \u0436\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u0438 \u043f\u043e\u0442\u043e\u043a\u043e\u0432 \u0434\u0430\u043d\u043d\u044b\u0445 \u043c\u0435\u0436\u0434\u0443 \u043d\u0438\u043c\u0438. \u0418 \u0442\u0443\u0442 \u044f \u043d\u0430\u0447\u0430\u043b \u043e\u0441\u043e\u0437\u043d\u0430\u0432\u0430\u0442\u044c — \u043d\u0435\u0443\u0434\u043e\u0431\u0441\u0442\u0432\u043e \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u0432 \u043a\u0430\u0436\u0434\u043e\u043c \u0441\u0435\u0440\u0432\u0438\u0441\u0435 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043d\u0443\u0436\u043d\u043e \u0432\u043d\u043e\u0441\u0438\u0442\u044c \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b, \u043f\u0443\u0448\u0438\u0442\u044c \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u0433\u0438\u0442, \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0442\u044c CI, \u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u0442\u044c \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b. \u0410 \u0435\u0449\u0435 \u0443 \u043d\u0430\u0441 \u0431\u044b\u043b\u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u044f\u044e\u0449\u0438\u0435\u0441\u044f \u043c\u043e\u0434\u0435\u043b\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043f\u0440\u043e\u0441\u0442\u043e \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u043b\u043e\u0441\u044c \u0434\u0443\u0431\u043b\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0440\u0430\u0437\u043c\u0430\u0437\u044b\u0432\u0430\u0442\u044c<\/s> \u0432\u043e \u0432\u0441\u0435\u0445 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u0445 (\u0441\u0435\u0440\u0432\u0438\u0441\u0430\u0445). \u041d\u0443 \u0438 \u043d\u0430\u043f\u043e\u0441\u043b\u0435\u0434\u043e\u043a, \u0445\u043e\u0442\u044c \u0438 \u043d\u0435 \u0447\u0430\u0441\u0442\u043e, \u043f\u0440\u0438 \u0432\u043d\u0435\u0441\u0435\u043d\u0438\u0438 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0439 \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0430, \u044d\u0442\u043e \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u0431\u044b\u043b\u043e \u0434\u0435\u043b\u0430\u0442\u044c \u0432\u043e \u0432\u0441\u0435\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445.<\/p>\n
\n
\u0412\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u043c\u0438\u043d\u0443\u0441\u043e\u0432 \u044d\u0442\u043e\u0433\u043e \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u0431\u043e\u043b\u044c\u0448\u0435, \u043f\u043e\u043a\u0430 \u043f\u0438\u0441\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u044e, \u0432\u0441\u043f\u043e\u043c\u043d\u0438\u043b \u0442\u043e\u043b\u044c\u043a\u043e \u044d\u0442\u0438.<\/p>\n<\/blockquote>\n
\u0422\u0430\u043a\u0438\u043c \u043e\u0431\u0440\u0430\u0437\u043e\u043c \u044f \u043d\u0430\u0447\u0430\u043b \u0434\u0443\u043c\u0430\u0442\u044c \u043e\u0431 \u0438\u043d\u043e\u043c \u043f\u043e\u0434\u0445\u043e\u0434\u0435 \u0438 \u043f\u0440\u0438\u0448\u0435\u043b \u043a \u0442\u043e\u043c\u0443, \u043e \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u0440\u0430\u0441\u0441\u043a\u0430\u0436\u0443 \u0432\u0430\u043c \u0434\u0430\u043b\u0435\u0435.<\/p>\n
\u041d\u043e\u0432\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434<\/h2>\n
\u0418\u0434\u0435\u044f \u0441\u0432\u043e\u0434\u0438\u043b\u0430\u0441\u044c \u043a \u043f\u0440\u043e\u0441\u0442\u043e\u043c\u0443: \u0435\u0441\u0442\u044c \u043c\u043e\u043d\u043e-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0432 \u043d\u0435\u043c \u043f\u043e \u043f\u0430\u043f\u043a\u0430\u043c \u0440\u0430\u0437\u043b\u043e\u0436\u0435\u043d\u044b API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0438 \u043e\u0431\u0449\u0438\u0435 \u043c\u043e\u0434\u0435\u043b\u0438, \u0441\u0431\u043e\u0440\u043a\u0430 \u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u044f \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u043e\u0432 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0441\u044f \u043e\u0442\u0442\u0443\u0434\u0430 \u0436\u0435. \u0422\u0430\u043a \u0438 \u0432\u044b\u0448\u043b\u043e.<\/p>\n
\n
\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043c\u043e\u043d\u043e-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f<\/figcaption><\/div>\n<\/figure>\n
\n
\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043f\u0430\u043f\u043a\u0438 common<\/figcaption><\/div>\n<\/figure>\n
\u0412 \u043f\u0430\u043f\u043a\u0435 common \u043c\u043e\u0433\u0443\u0442 \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u044c\u0441\u044f \u043b\u044e\u0431\u044b\u0435 \u043e\u0431\u0449\u0438\u0435 \u0438 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u044b\u0435 \u043c\u043e\u0434\u0435\u043b\u0438 \u0438 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438. \u0412 \u043c\u043e\u0435\u043c \u043f\u0440\u043e\u0441\u0442\u043e\u043c \u043f\u0440\u0438\u043c\u0435\u0440\u0435, \u044d\u0442\u043e \u0444\u0430\u0439\u043b models.yaml \u0441 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435\u043c Page \u0438 Pageable \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432<\/p>\n
\u0421\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 \u0444\u0430\u0439\u043b\u0430 models.yaml<\/strong>:<\/p>\n
Page:   type: object   description: 'Description'   properties:     size:       type: integer     page:       type: integer     totalElements:       type: integer     totalPages:       type: integer  Pageable:   type: object   description: 'Description'   properties:     size:       type: integer     page:       type: integer     sort:       type: array       items:         type: string <\/code><\/pre>\n
\n
\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043f\u0430\u043f\u043a\u0438 crud-service-api<\/figcaption><\/div>\n<\/figure>\n
\u0412\u043e\u0442 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a\u0430\u044f \u043f\u0440\u043e\u0441\u0442\u0430\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u0443 \u043c\u0435\u043d\u044f \u043f\u043e\u043b\u0443\u0447\u0438\u043b\u0430\u0441\u044c. \u041f\u0440\u0438\u0432\u043e\u0434\u0438\u0442\u044c \u043f\u0440\u0438\u043c\u0435\u0440 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b notification-service-api<\/strong> \u043d\u0435 \u0441\u0442\u0430\u043b, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043e\u043d\u0430 \u0438\u0434\u0435\u043d\u0442\u0438\u0447\u043d\u0430 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0435 crud-service-api<\/strong>.<\/p>\n
\u0414\u0430\u0432\u0430\u0439\u0442\u0435 \u043d\u0435\u043c\u043d\u043e\u0433\u043e \u043f\u0440\u043e\u0431\u0435\u0436\u0438\u043c\u0441\u044f \u043f\u043e CI \u0444\u0430\u0439\u043b\u0430\u043c.<\/p>\n
1) \u041a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 .gitlab-ci.yml<\/strong>:<\/p>\n
stages:   - trigger  .trigger:   stage: trigger   trigger:     strategy: depend  crud-service-api:   extends: .trigger   trigger:     include: crud-service-api\/.gitlab-ci.yml   rules:     - changes:         - crud-service-api\/*  notification-service-api:   extends: .trigger   trigger:     include: notification-service-api\/.gitlab-ci.yml   rules:     - changes:         - notification-service-api\/*<\/code><\/pre>\n
\u0417\u0434\u0435\u0441\u044c \u043e\u043f\u0438\u0441\u0430\u043d\u044b \u0442\u0440\u0438\u0433\u0433\u0435\u0440\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0431\u0443\u0434\u0443\u0442 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0442\u044c \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u044b \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u0442\u0435\u0445 \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432, \u0432 \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0431\u044b\u043b\u0438 \u0432\u043d\u0435\u0441\u0435\u043d\u044b \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f.<\/p>\n
2) \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0439 .api-first.gitlab-ci.yml<\/strong>:<\/p>\n
stages:   - validate   - prepare   - generate   - publish  variables:   OPENAPI_GENERATOR: registry.gitlab.com\/dmitrii-demchenko\/infrastructure\/custom-docker-images\/openapi-generator-cli:1.0.0   OPENAPI_GENERATOR_CLI: java -jar \/opt\/openapi-generator-cli.jar  # Stage: validate validate:   stage: validate   image: ${OPENAPI_GENERATOR}   script:     - cp ${OPENAPI_SPEC_PATH}\/openapi.yaml openapi.yaml     - ${OPENAPI_GENERATOR_CLI} validate -i openapi.yaml   rules:     - if: $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == \"main\"       when: always     - if: $CI_COMMIT_BRANCH == \"main\"       when: always   artifacts:     paths:       - openapi.yaml   tags:     - docker  # Stage: prepare .prepare:   stage: prepare   before_script:     - mkdir -p configs\/shared     - |       cat > configs\/shared\/common.yaml <<EOF       inputSpec: openapi.yaml       EOF   rules:     - if: $CI_COMMIT_BRANCH == \"main\"       when: on_success   artifacts:     paths:       - openapi.yaml       - configs     expire_in: 1w   needs:     - job: validate   tags:     - docker  prepare:spring-cloud-interface:   extends: .prepare   script:     - |       cat > configs\/shared\/spring-cloud-interface.yaml <<EOF       ${SPRING_CLOUD_INTERFACE_INCLUDE_CONFIG}       EOF     - |       cat > configs\/spring-cloud-interface.yaml <<EOF       '!include': 'shared\/common.yaml'       outputDir: generated\/spring-cloud-interface       generatorName: spring       '!include': 'shared\/spring-cloud-interface.yaml'       additionalProperties:         artifactId                    : ${JAR_ARTIFACT_ID}         groupId                       : ${JAR_GROUP_ID}         apiPackage                    : ${JAR_API_PACKAGE}         modelPackage                  : ${JAR_MODEL_PACKAGE}         library                       : spring-cloud         dateLibrary                   : java8         useSpringBoot3                : true         useTags                       : true         interfaceOnly                 : true         openApiNullable               : false         documentationProvider         : none         hideGenerationTimestamp       : true         additionalModelTypeAnnotations: '@com.fasterxml.jackson.annotation.JsonIgnoreProperties(ignoreUnknown = true) @lombok.Getter @lombok.Setter @lombok.AllArgsConstructor @lombok.NoArgsConstructor'       EOF  # Stage: generate generate:   stage: generate   image: ${OPENAPI_GENERATOR}   script:     # - *script-clone-common     - ${OPENAPI_GENERATOR_CLI} batch configs\/*.yaml   rules:     - if: $CI_COMMIT_BRANCH == \"main\"       when: on_success   artifacts:     paths:       - generated     expire_in: 1w   needs:     - job: prepare:spring-cloud-interface       artifacts: true   tags:     - docker  # Stage: publish .publish:   stage: publish   rules:     - if: $CI_COMMIT_BRANCH == \"main\"       when: manual   allow_failure: true   tags:     - docker  .publish:maven:   extends: .publish   image: maven:3-eclipse-temurin-21-alpine   variables:     MAVEN_OPTS: \"-Dmaven.repo.local=${CI_PROJECT_DIR}\/.m2\/repository\"     MAVEN_CLI_OPTS: \"-Dmaven.test.skip=true -s settings.xml\"   script:     - echo ${MAVEN_SETTINGS_XML} > settings.xml     - mvn deploy ${MAVEN_CLI_OPTS} -DaltDeploymentRepository=${MAVEN_SERVER_ID}::${MAVEN_SANDBOX_URL}   cache:     paths:       - '.m2\/repository'  publish:spring-cloud-interface:   extends: .publish:maven   before_script:     - cd generated\/spring-cloud-interface   needs:     - job: generate       artifacts: true<\/code><\/pre>\n
\u042d\u0442\u043e\u0442 \u0444\u0430\u0439\u043b \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0437\u0432\u0430\u0442\u044c \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u043c, \u0442\u0430\u043a \u043a\u0430\u043a \u0432 \u043d\u0435\u043c \u043e\u043f\u0438\u0441\u0430\u043d\u044b \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u0435 \u0434\u0436\u043e\u0431\u044b.<\/p>\n
3) \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043d\u044b\u0439 (\u043d\u0430 \u043f\u0440\u0438\u043c\u0435\u0440\u0435 crud-service-api\/.gitlab-ci.yml<\/em><\/strong>):<\/p>\n
include:   - local: .api-first.gitlab-ci.yml  variables:   OPENAPI_SPEC_PATH: crud-service-api   JAR_GROUP_ID: com.example   JAR_ARTIFACT_ID: crud-service-api   JAR_API_PACKAGE: com.example.crud.api   JAR_MODEL_PACKAGE: com.example.crud.api.model   SPRING_CLOUD_INTERFACE_INCLUDE_CONFIG: |-     typeMappings:       'OrderPageDto': 'Page<OrderDto>'     importMappings:       'Page': 'org.springframework.data.domain.Page'       'Pageable': 'org.springframework.data.domain.Pageable'       'Page<OrderDto>': 'org.springframework.data.domain.Page'<\/code><\/pre>\n
\u0412 \u044d\u0442\u043e\u043c \u0436\u0435 \u0444\u0430\u0439\u043b\u0435 \u0443\u0436\u0435 \u0438\u0434\u0435\u0442 \u043f\u0435\u0440\u0435\u0434\u0430\u0447\u0430 \u043a\u043e\u043d\u0435\u0447\u043d\u044b\u0445 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u043c, \u043f\u0440\u0435\u0434\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u043d\u044b\u043c \u0432 \u0444\u0430\u0439\u043b\u0435 \u0432\u044b\u0448\u0435.<\/p>\n
\u0414\u0430, \u0447\u0443\u0442\u044c \u043d\u0435 \u0437\u0430\u0431\u044b\u043b…<\/h2>\n
\u0427\u0442\u043e \u0437\u0430 \u043e\u0431\u0440\u0430\u0437 \u0442\u0430\u043a\u043e\u0439 registry.gitlab.com\/dmitrii-demchenko\/infrastructure\/custom-docker-images\/openapi-generator-cli:1.0.0<\/code>?<\/p>\n
\u0414\u043b\u044f \u0443\u0434\u043e\u0431\u0441\u0442\u0432\u0430 \u0441\u0431\u043e\u0440\u043a\u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 \u044f \u0441\u0434\u0435\u043b\u0430\u043b \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u043e\u0431\u0440\u0430\u0437 \u0441 openapi-generator-cli<\/code> \u043d\u0430 \u0431\u043e\u0440\u0442\u0443.<\/p>\n
Dockerfile:<\/p>\n
FROM eclipse-temurin:21-jre-alpine  ARG VERSION=7.10.0 ARG OPENAPI_URL=https:\/\/repo1.maven.org\/maven2\/org\/openapitools\/openapi-generator-cli\/${VERSION}\/openapi-generator-cli-${VERSION}.jar  ADD ${OPENAPI_URL} \/opt\/openapi-generator-cli.jar<\/code><\/pre>\n
\u0418 \u0435\u0449\u0435 \u0443 \u043c\u0435\u043d\u044f \u0435\u0441\u0442\u044c \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0430\u044f MAVEN_SETTINGS_XML<\/code> \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043d\u0438\u0433\u0434\u0435 \u043d\u0435 \u0437\u0430\u0434\u0430\u043d\u043e \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435. \u042d\u0442\u043e \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u0430\u044f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0430\u044f, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0430 \u0432 Gitlab CI\/CI variables \u0432 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430\u0445 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u0438 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u043a\u0440\u0435\u0434\u044b \u043a maven-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e. \u0418 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043e\u043d\u0430 \u0432\u043e\u0442 \u0442\u0430\u043a:<\/p>\n
<settings xmlns=\"http:\/\/maven.apache.org\/SETTINGS\/1.1.0\">     <servers>         <server>             <id>maven-sandbox<\/id>             <username>${env.MAVEN_SANDBOX_USERNAME}<\/username>             <password>${env.MAVEN_SANDBOX_PASSWORD}<\/password>         <\/server>     <\/servers> <\/settings><\/code><\/pre>\n
\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u043c \u043f\u0435\u0440\u0432\u044b\u0439 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d (\u043d\u0430 \u0441\u0430\u043c\u043e\u043c \u0434\u0435\u043b\u0435 \u043d\u0435 \u043f\u0435\u0440\u0432\u044b\u0439, \u043d\u043e \u043f\u0435\u0440\u0432\u044b\u0439 \u0443\u0434\u0430\u0447\u043d\u044b\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043d\u0435 \u0441\u0442\u044b\u0434\u043d\u043e \u043f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0432\u0430\u043c<\/em>):<\/p>\n
<\/figure>\n
\u0418 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c \u0437\u0430\u0433\u0440\u0443\u0436\u0435\u043d\u043d\u044b\u0439 \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442 \u0432 \u043b\u044e\u0431\u043e\u0439 \u0443\u0434\u043e\u0431\u043d\u044b\u0439 \u0434\u043b\u044f \u0432\u0430\u0441 maven-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439.<\/p>\n
\n
\u0410\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438<\/figcaption><\/div>\n<\/figure>\n
\u041a\u0442\u043e \u0438 \u043a\u0430\u043a \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0441 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438<\/h2>\n
\u0420\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u043c \u043c\u043e\u0436\u0435\u0442 \u043a\u0442\u043e \u0443\u0433\u043e\u0434\u043d\u043e, \u0441\u0438\u0441\u0442\u0435\u043c\u043d\u044b\u0439 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a \u0438\u043b\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a, \u0442\u0443\u0442 \u0432\u0441\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u0442 \u043e\u0442 \u043f\u0440\u0438\u043d\u044f\u0442\u044b\u0445 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u043e\u0432 \u043d\u0430 \u043f\u0440\u043e\u0435\u043a\u0442\u0435. \u0412 \u043d\u0430\u0448\u0435\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435\u043c \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u044b\u0445 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0439 \u0437\u0430\u043d\u0438\u043c\u0430\u044e\u0442\u0441\u044f \u0441\u0430\u043c\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438. \u0412\u0441\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0432\u043d\u043e\u0441\u044f\u0442\u0441\u044f \u043b\u0438\u0431\u043e \u043f\u043e\u0441\u043b\u0435 \u0441\u0438\u0441\u0442\u0435\u043c\u043d\u043e\u0439 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0438, \u043b\u0438\u0431\u043e \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e. \u0410\u043f\u043f\u0440\u0443\u0432\u044f\u0442 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438 \u043f\u043e\u0441\u043b\u0435 \u043f\u0440\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0440\u0435\u0432\u044c\u044e.<\/p>\n
\u0412\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d\u043e \u043f\u043e \u043f\u0440\u043e\u0441\u0442\u043e\u043c\u0443, \u0447\u0435\u0440\u0435\u0437 \u0443\u043a\u0430\u0437\u0430\u043d\u0438\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 \u0432 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u0441\u0435\u0440\u0432\u0438\u0441\u0430.<\/p>\n
\u0411\u044b\u043b\u0430 \u0432\u0435\u0440\u0441\u0438\u044f 1.0.0:<\/p>\n
openapi: 3.0.3  info:   title: CRUD service API   description: CRUD service API   version: 1.0.0<\/code><\/pre>\n
\u0421\u0442\u0430\u043b\u0430 1.1.0:<\/p>\n
openapi: 3.0.3  info:   title: CRUD service API   description: CRUD service API   version: 1.1.0<\/code><\/pre>\n
\u0414\u0430\u043b\u0435\u0435 \u043e\u0431\u044b\u0447\u043d\u0430\u044f \u0441\u0431\u043e\u0440\u043a\u0430 \u0438 \u0434\u0435\u043f\u043b\u043e\u0439 \u0438\u0437 main \u0432\u0435\u0442\u043a\u0438.<\/p>\n
\u0418\u0442\u043e\u0433\u0438<\/h2>\n
\u041a\u0430\u043a \u044f \u0438 \u0445\u043e\u0442\u0435\u043b, \u044f \u043f\u043e\u043b\u0443\u0447\u0438\u043b \u0443\u0434\u043e\u0431\u043d\u044b\u0439 (\u043f\u043e \u043a\u0440\u0430\u0439\u043d\u0435\u0439 \u043c\u0435\u0440\u0435 \u0434\u043b\u044f \u0441\u0435\u0431\u044f \u0438 \u0441\u0432\u043e\u0438\u0445 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432) \u0441\u043f\u043e\u0441\u043e\u0431 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f, \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0438 \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0435\u043d\u0438\u044f API \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432. \u041e\u043d \u0442\u0430\u043a \u0436\u0435 \u043e\u0442\u043b\u0438\u0447\u043d\u043e \u043b\u043e\u0436\u0438\u0442\u0441\u044f \u043d\u0430 \u043f\u043e\u0434\u0445\u043e\u0434 API-first.<\/p>\n
\u0423\u0432\u0435\u0440\u0435\u043d, \u0432 <\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-463189","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/463189","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=463189"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/463189\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=463189"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=463189"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=463189"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}