{"id":482062,"date":"2026-06-02T10:01:25","date_gmt":"2026-06-02T10:01:25","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=482062"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=482062","title":{"rendered":"\u0410\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u0443\u0435\u043c \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e gRPC \u0441\u0442\u0430\u0431\u043e\u0432 \u0434\u043b\u044f Go"},"content":{"rendered":"<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<h2>\u041d\u0430\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u043c \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e gRPC \u0441\u0442\u0430\u0431\u043e\u0432 \u0434\u043b\u044f Go \u0438 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u043c \u043a\u0430\u043a \u043c\u043e\u0434\u0443\u043b\u044c<\/h2>\n<p>\u0414\u0435\u0440\u0436\u0430\u0442\u044c proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0432 \u043e\u0434\u043d\u043e\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0443\u0434\u043e\u0431\u043d\u043e, \u043d\u043e \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0442\u044c \u0438\u0445 \u0446\u0435\u043b\u0438\u043a\u043e\u043c \u0432 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441 \u2014 \u043d\u0435 \u043e\u0447\u0435\u043d\u044c. \u0420\u0430\u0437\u0431\u0435\u0440\u0451\u043c, \u043a\u0430\u043a \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c Go-\u0441\u0442\u0430\u0431\u044b \u0438\u0437 proto-\u0444\u0430\u0439\u043b\u043e\u0432, \u0432\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u0445 \u043a\u0430\u043a \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 Go-\u043c\u043e\u0434\u0443\u043b\u0438 \u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u0442\u044c \u0447\u0435\u0440\u0435\u0437 GitLab CI\/CD. \u0411\u043e\u043d\u0443\u0441\u043e\u043c \u2014 swagger-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0438 GitLab Pages.<\/p>\n<p>\u0412\u0441\u0451 \u043e\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u0435 \u0440\u0430\u0441\u0441\u0447\u0438\u0442\u0430\u043d\u043e \u043d\u0430 \u043f\u0440\u0438\u0432\u0430\u0442\u043d\u044b\u0439 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 GitLab. \u0412 self-hosted \u0438 \u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0432\u0435\u0440\u0441\u0438\u044f\u0445, \u0430 \u0442\u0430\u043a\u0436\u0435 \u0434\u043b\u044f \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0445 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0431\u0443\u0434\u0435\u0442 \u0437\u043d\u0430\u0447\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u043f\u0440\u043e\u0449\u0435 \u2014 \u0442\u0430\u043c \u0447\u0430\u0441\u0442\u044c \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0439 \u043f\u0440\u043e\u0441\u0442\u043e \u0441\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f.<\/p>\n<hr\/>\n<h3>\u041f\u0440\u0438\u043c\u0435\u0447\u0430\u043d\u0438\u044f \u043f\u0435\u0440\u0435\u0434 \u0441\u0442\u0430\u0440\u0442\u043e\u043c<\/h3>\n<p>\u041f\u043e\u0434\u0445\u043e\u0434 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 dev-\u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f: \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u043e\u0433\u043e \u0434\u043e\u0441\u0442\u0443\u043f\u0430 \u043a \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e \u043f\u043e SSH \u0438 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0445 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f \u043d\u0430 \u043a\u0430\u0436\u0434\u043e\u0439 \u043c\u0430\u0448\u0438\u043d\u0435 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430:<\/p>\n<pre><code>GOPRIVATE=gitlab.com\/your-groupGOPROXY=directGONOSUMDB=gitlab.com\/your-group<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:87px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0414\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u0445 \u0441\u0442\u0430\u0431\u044b, \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u0441\u043e\u0431\u0438\u0440\u0430\u0442\u044c vendor-\u043f\u0430\u043f\u043a\u0443 \u2014 \u043a\u0430\u043a \u043f\u0440\u0438 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e\u043c \u0437\u0430\u043f\u0443\u0441\u043a\u0435, \u0442\u0430\u043a \u0438 \u0432 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u0430\u0445 \u043f\u0440\u0438 \u043b\u0438\u043d\u0442\u0438\u043d\u0433\u0435, \u0442\u0435\u0441\u0442\u0430\u0445 \u0438 \u0441\u0431\u043e\u0440\u043a\u0435. \u042d\u0442\u043e \u043e\u0431\u0443\u0441\u043b\u043e\u0432\u043b\u0435\u043d\u043e \u0442\u0435\u043c, \u0447\u0442\u043e Go \u043d\u0435 \u0443\u043c\u0435\u0435\u0442 \u0441\u043a\u0430\u0447\u0438\u0432\u0430\u0442\u044c \u043f\u0440\u0438\u0432\u0430\u0442\u043d\u044b\u0435 \u043c\u043e\u0434\u0443\u043b\u0438 \u0438\u0437 GitLab \u0432 \u043e\u0431\u0445\u043e\u0434 \u043f\u0440\u043e\u043a\u0441\u0438 \u0431\u0435\u0437 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0439 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438.<\/p>\n<p>\u0414\u043e\u0441\u0442\u0443\u043f \u0432 CI-\u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u0438 \u043e\u0441\u0443\u0449\u0435\u0441\u0442\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 <code>CI_JOB_TOKEN<\/code>. \u0422\u0438\u043f\u043e\u0432\u043e\u0439 <code>before_script<\/code> \u0434\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432-\u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u0435\u0439 \u0441\u0442\u0430\u0431\u043e\u0432 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:<\/p>\n<pre><code class=\"yaml\">default:  image: golang:${GO_VERSION}  cache:    key: go-mod    paths:      - go\/pkg\/mod      - .cache\/go-build  before_script:    - go version    - git config --global url.\"https:\/\/gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com\/\".insteadOf \"https:\/\/gitlab.com\/\"    - go env -w GOPRIVATE=gitlab.com\/chichilaki    - go env -w GONOSUMDB=gitlab.com\/chichilaki    - go mod vendor<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<hr\/>\n<h3>\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432<\/h3>\n<p>\u0421\u043e\u0437\u0434\u0430\u0451\u043c \u0433\u0440\u0443\u043f\u043f\u044b \u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438:<\/p>\n<ul>\n<li>\n<p>`group\/proto` \u2014 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b, \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043c\u044b \u0431\u0443\u0434\u0435\u043c \u0440\u0435\u0434\u0430\u043a\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0432\u0440\u0443\u0447\u043d\u0443\u044e.<\/p>\n<\/li>\n<li>\n<p>`group\/proto-stubs` \u2014 \u0433\u0440\u0443\u043f\u043f\u0430 \u0434\u043b\u044f \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 \u0441\u0442\u0430\u0431\u043e\u0432, \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u0451\u043c \u0437\u0430\u0440\u0430\u043d\u0435\u0435 \u043f\u0443\u0441\u0442\u044b\u043c\u0438.<\/p>\n<\/li>\n<li>\n<p>`group\/proto-stubs\/common`, `group\/proto-stubs\/user`, `group\/proto-stubs\/admin` \u0438 \u0442.\u0434. \u2014 \u043f\u043e \u043e\u0434\u043d\u043e\u043c\u0443 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u043c\u043e\u0434\u0443\u043b\u044c.<\/p>\n<\/li>\n<li>\n<p>`group\/service` \u2014 \u043b\u044e\u0431\u043e\u0439 \u0441\u0435\u0440\u0432\u0438\u0441, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u0439 \u0441\u0442\u0430\u0431\u044b.<\/p>\n<\/li>\n<\/ul>\n<hr\/>\n<h3>\u0420\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0441\u0442\u0430\u0431\u043e\u0432<\/h3>\n<p>\u0414\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u0441\u0442\u0430\u0431\u0430 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 Go-\u043c\u043e\u0434\u0443\u043b\u044f. \u0412 \u043c\u043e\u0451\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u0435\u0441\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0434\u043b\u044f \u043e\u0431\u0449\u0438\u0445 \u0441\u0443\u0449\u043d\u043e\u0441\u0442\u0435\u0439 (<code>common<\/code>) \u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0434\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432: <code>user<\/code>, <code>admin<\/code>, <code>runner<\/code>.<\/p>\n<h4>\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0434\u043e\u0441\u0442\u0443\u043f\u0430 \u0434\u043b\u044f CI_JOB_TOKEN<\/h4>\n<p>\u041f\u043e\u0441\u043a\u043e\u043b\u044c\u043a\u0443 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441 \u0432 \u0441\u0432\u043e\u0451\u043c \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 <code>CI_JOB_TOKEN<\/code> \u0434\u043b\u044f \u043e\u0431\u0440\u0430\u0449\u0435\u043d\u0438\u044f \u043a \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f\u043c \u0441\u043e \u0441\u0442\u0430\u0431\u0430\u043c\u0438, \u043d\u0443\u0436\u043d\u043e \u044f\u0432\u043d\u043e \u0440\u0430\u0437\u0440\u0435\u0448\u0438\u0442\u044c \u0442\u0430\u043a\u043e\u0439 \u0434\u043e\u0441\u0442\u0443\u043f.<\/p>\n<p>\u0414\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u0441\u043e \u0441\u0442\u0430\u0431\u0430\u043c\u0438 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u043c <code>Settings -&gt; CI\/CD -&gt; Job token permissions<\/code> \u0438 \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0441 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438 \u0438 \u0433\u0440\u0443\u043f\u043f\u0443 \u0441 \u0441\u0435\u0440\u0432\u0438\u0441\u0430\u043c\u0438, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u043c\u0438 \u0441\u0442\u0430\u0431\u044b.<\/p>\n<p>\u0412\u0430\u0436\u043d\u044b\u0439 \u043c\u043e\u043c\u0435\u043d\u0442: \u0435\u0441\u043b\u0438 \u043e\u0434\u043d\u0438 \u0441\u0442\u0430\u0431\u044b \u0437\u0430\u0432\u0438\u0441\u044f\u0442 \u043e\u0442 \u0434\u0440\u0443\u0433\u0438\u0445 \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, <code>admin<\/code> \u0438\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u0442 <code>common<\/code> \u2014 \u0442\u043e \u0432 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430\u0445 \u0434\u043e\u0441\u0442\u0443\u043f\u0430 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f <code>admin.git<\/code> \u043d\u0443\u0436\u043d\u043e \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0433\u0440\u0443\u043f\u043f\u0443 \u0441\u043e \u0441\u0442\u0430\u0431-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f\u043c\u0438. \u0418\u043d\u0430\u0447\u0435 <code>go get<\/code> \u0432 CI \u0443\u043f\u0430\u0434\u0451\u0442 \u0441 \u043e\u0448\u0438\u0431\u043a\u043e\u0439 \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0438 \u0431\u0443\u0434\u0435\u0442 \u043d\u0435\u043e\u0447\u0435\u0432\u0438\u0434\u043d\u043e \u043f\u043e\u0447\u0435\u043c\u0443.<\/p>\n<blockquote>\n<p>\u0412 \u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0438 self-hosted \u0432\u0435\u0440\u0441\u0438\u044f\u0445 GitLab \u043c\u043e\u0436\u043d\u043e \u0434\u0430\u0432\u0430\u0442\u044c \u0434\u043e\u0441\u0442\u0443\u043f \u0441\u0440\u0430\u0437\u0443 \u043d\u0430 \u0433\u0440\u0443\u043f\u043f\u0443 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432 \u2014 \u0442\u0430\u043c \u044d\u0442\u043e \u043d\u0430\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435.<\/p>\n<\/blockquote>\n<h4>\u041f\u043e\u0447\u0435\u043c\u0443 .git \u0432 \u0438\u043c\u0435\u043d\u0438 \u043c\u043e\u0434\u0443\u043b\u044f<\/h4>\n<p>\u0418\u043c\u044f \u043c\u043e\u0434\u0443\u043b\u044f \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u0441\u0443\u0444\u0444\u0438\u043a\u0441 <code>.git<\/code>:<\/p>\n<pre><code>gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/common.git<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u042d\u0442\u043e \u043d\u0435 \u0441\u043b\u0443\u0447\u0430\u0439\u043d\u043e\u0441\u0442\u044c. Go \u043f\u0440\u0438 \u0440\u0435\u0437\u043e\u043b\u0432\u0435 \u043f\u0443\u0442\u0438 \u043c\u043e\u0434\u0443\u043b\u044f \u0438\u0437 GitLab \u043d\u0435 \u043c\u043e\u0436\u0435\u0442 \u0441\u0430\u043c\u043e\u0441\u0442\u043e\u044f\u0442\u0435\u043b\u044c\u043d\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0438\u0442\u044c, \u0433\u0434\u0435 \u0437\u0430\u043a\u0430\u043d\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u043f\u0443\u0442\u044c \u043a \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e \u0438 \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u043f\u0443\u0442\u044c \u043a \u043f\u0430\u043a\u0435\u0442\u0443 \u0432\u043d\u0443\u0442\u0440\u0438 \u043d\u0435\u0433\u043e. \u0421\u0443\u0444\u0444\u0438\u043a\u0441 <code>.git<\/code> \u0434\u0430\u0451\u0442 \u0435\u043c\u0443 \u044f\u0432\u043d\u0443\u044e \u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0443. \u0411\u0435\u0437 \u043d\u0435\u0433\u043e <code>go get<\/code> \u0431\u0443\u0434\u0435\u0442 \u043f\u044b\u0442\u0430\u0442\u044c\u0441\u044f \u043d\u0430\u0439\u0442\u0438 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 \u043c\u043e\u0434\u0443\u043b\u044f \u043f\u043e \u043d\u0435\u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u043e\u043c\u0443 \u043f\u0443\u0442\u0438 \u0438 \u043f\u0430\u0434\u0430\u0442\u044c.<\/p>\n<hr\/>\n<h3>\u0420\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0441 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438<\/h3>\n<p>\u0418\u043c\u0435\u043d\u043d\u043e \u044d\u0442\u043e\u0442 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d \u0441 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 \u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0435\u0439 \u0441\u0442\u0430\u0431\u043e\u0432.<\/p>\n<h4>\u0412\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435<\/h4>\n<p>\u0414\u0436\u043e\u0431\u0430 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0438 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u0432\u0435\u0442\u043e\u043a \u0441 \u0438\u043c\u0435\u043d\u0435\u043c \u0432\u0438\u0434\u0430 <code>vX.X.X<\/code>. \u041f\u0440\u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0438 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043e\u0434\u043d\u043e\u0438\u043c\u0451\u043d\u043d\u044b\u0439 \u0442\u0435\u0433 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0441\u0442\u0430\u0431\u043e\u0432. \u0422\u0430\u043a\u0438\u043c \u043e\u0431\u0440\u0430\u0437\u043e\u043c, \u0438\u043c\u044f \u0432\u0435\u0442\u043a\u0438 \u0432 proto-\u0440\u0435\u043f\u043e \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0441\u044f \u0432\u0435\u0440\u0441\u0438\u0435\u0439 Go-\u043c\u043e\u0434\u0443\u043b\u044f. \u0425\u043e\u0447\u0435\u0448\u044c \u0432\u044b\u043f\u0443\u0441\u0442\u0438\u0442\u044c <code>v1.2.3<\/code> \u2014 \u0441\u043e\u0437\u0434\u0430\u0451\u0448\u044c \u0432\u0435\u0442\u043a\u0443 <code>v1.2.3<\/code> \u0438 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0448\u044c \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d.<\/p>\n<h4>\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 Personal Access Token<\/h4>\n<blockquote>\n<p>\u0421 \u043d\u0435\u0434\u0430\u0432\u043d\u0438\u0445 \u043f\u043e\u0440 \u0432 GitLab Next \u043f\u043e\u044f\u0432\u0438\u043b\u0430\u0441\u044c \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0434\u043e\u0441\u0442\u0443\u043f <code>CI_JOB_TOKEN<\/code> \u043d\u0430 \u043f\u0443\u0448 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u2014 \u0441\u0442\u043e\u0438\u0442 \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c, \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u044d\u0442\u043e\u0442 \u0448\u0430\u0433 \u0441\u043a\u043e\u0440\u043e \u0441\u0442\u0430\u043d\u0435\u0442 \u043b\u0438\u0448\u043d\u0438\u043c.<\/p>\n<\/blockquote>\n<p>\u0412 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 GitLab \u043d\u0435\u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u0432\u044b\u0434\u0430\u0442\u044c access token \u043d\u0430 \u0433\u0440\u0443\u043f\u043f\u0443 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c Personal Access Token.<\/p>\n<p><code>Profile Settings -&gt; Access Tokens<\/code> \u2014 \u0441\u043e\u0437\u0434\u0430\u0451\u043c \u0442\u043e\u043a\u0435\u043d \u0441 \u043f\u0440\u0430\u0432\u0430\u043c\u0438 <code>api<\/code>, <code>read_api<\/code>, <code>read_repository<\/code>, <code>write_repository<\/code>. \u0422\u043e\u043a\u0435\u043d \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u2014 \u0441\u043e\u0445\u0440\u0430\u043d\u0438\u0442\u0435 \u0435\u0433\u043e \u0441\u0440\u0430\u0437\u0443.<\/p>\n<p>\u0414\u0430\u043b\u0435\u0435 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0441 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438: <code>Settings -&gt; CI\/CD -&gt; Variables<\/code>. \u0421\u043e\u0437\u0434\u0430\u0451\u043c \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e:<\/p>\n<ul>\n<li>\n<p>type: `Variable`<\/p>\n<\/li>\n<li>\n<p>visibility: `Masked and hidden`<\/p>\n<\/li>\n<li>\n<p>flag: `Protected`<\/p>\n<\/li>\n<\/ul>\n<p>\u0415\u0441\u043b\u0438 \u0432 \u043a\u043e\u043c\u0430\u043d\u0434\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432 \u2014 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u043e\u0437\u0434\u0430\u0451\u0442 \u0441\u0432\u043e\u0439 \u0442\u043e\u043a\u0435\u043d \u0438 \u0441\u0432\u043e\u044e \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440 <code>CI_PUSH_TOKEN_USERNAME<\/code>. \u0412 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u0435 \u0432\u044b\u0431\u043e\u0440 \u043d\u0443\u0436\u043d\u043e\u0433\u043e \u0442\u043e\u043a\u0435\u043d\u0430 \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 <code>rules<\/code> \u0441 \u0443\u0441\u043b\u043e\u0432\u0438\u0435\u043c \u043d\u0430 <code>GITLAB_USER_LOGIN<\/code> \u2014 \u043e\u0431 \u044d\u0442\u043e\u043c \u043d\u0438\u0436\u0435.<\/p>\n<h4>\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 Branch Rules<\/h4>\n<p>\u0427\u0442\u043e\u0431\u044b protected-\u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u0431\u044b\u043b\u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0432 \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439 \u0432\u0435\u0442\u043a\u0435: <code>Settings -&gt; Repository -&gt; Branch Rules -&gt; Add rule<\/code>. \u041c\u0430\u0441\u043a\u0430 <code>v*<\/code> \u0434\u0430\u0441\u0442 \u0434\u043e\u0441\u0442\u0443\u043f \u043b\u044e\u0431\u043e\u0439 \u0432\u0435\u0442\u043a\u0435, \u043d\u0430\u0447\u0438\u043d\u0430\u044e\u0449\u0435\u0439\u0441\u044f \u0441 <code>v<\/code>, \u043a \u0437\u0430\u0449\u0438\u0449\u0451\u043d\u043d\u044b\u043c \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u043c \u0438 \u0442\u043e\u043a\u0435\u043d\u0430\u043c. \u0411\u0435\u0437 \u044d\u0442\u043e\u0433\u043e \u0448\u0430\u0433\u0430 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d \u043d\u0430 \u0432\u0435\u0442\u043a\u0435 <code>v1.0.0<\/code> \u043f\u0440\u043e\u0441\u0442\u043e \u043d\u0435 \u0443\u0432\u0438\u0434\u0438\u0442 \u0442\u043e\u043a\u0435\u043d.<\/p>\n<hr\/>\n<h3>\u041a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f buf<\/h3>\n<p><code>buf.yaml<\/code> \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0438 \u043f\u0440\u0430\u0432\u0438\u043b\u0430 \u043b\u0438\u043d\u0442\u0438\u043d\u0433\u0430, <code>buf.gen.yaml<\/code> \u2014 \u043f\u043b\u0430\u0433\u0438\u043d\u044b \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438.<\/p>\n<p>\u0412 <code>buf.gen.yaml<\/code> \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c <code>local<\/code> \u0441 <code>go run<\/code> \u0432\u043c\u0435\u0441\u0442\u043e \u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u043e\u0439 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 <code>protoc<\/code> \u0438 \u043f\u043b\u0430\u0433\u0438\u043d\u043e\u0432 \u2014 Go \u0441\u0430\u043c \u0441\u043a\u0430\u0447\u0430\u0435\u0442 \u043d\u0443\u0436\u043d\u044b\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u0437\u0430\u043f\u0443\u0441\u043a\u0435. \u042d\u0442\u043e \u0438\u0437\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u043e\u0442 \u043f\u0440\u043e\u0431\u043b\u0435\u043c \u0441 \u0440\u0430\u0441\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u0435\u043c \u0432\u0435\u0440\u0441\u0438\u0439 \u043c\u0435\u0436\u0434\u0443 \u043c\u0430\u0448\u0438\u043d\u0430\u043c\u0438 \u0438 CI.<\/p>\n<p>\u041e\u0431\u0430 \u0444\u0430\u0439\u043b\u0430 \u043f\u043e\u043b\u043d\u043e\u0441\u0442\u044c\u044e \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u044b \u0432 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438.<\/p>\n<h4>\u041f\u0440\u0438\u043c\u0435\u0440 proto-\u0444\u0430\u0439\u043b\u043e\u0432<\/h4>\n<p>\u0412 <code>go_package<\/code> \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u0441\u0443\u0444\u0444\u0438\u043a\u0441 <code>.git<\/code> \u2014 \u0438\u043c\u0435\u043d\u043d\u043e \u0442\u0430\u043a Go \u0431\u0443\u0434\u0435\u0442 \u0440\u0430\u0437\u0440\u0435\u0448\u0430\u0442\u044c \u0438\u043c\u043f\u043e\u0440\u0442 \u043c\u043e\u0434\u0443\u043b\u044f:<\/p>\n<pre><code>\/\/ common.protosyntax = \"proto3\";package common.v1;option go_package = \"gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/common.git\/v1\";<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0414\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043d\u044b\u0445 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 \u0441 HTTP-\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f\u043c\u0438 grpc-gateway \u0438 swagger-\u043e\u043f\u0446\u0438\u044f\u043c\u0438 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:<\/p>\n<pre><code>\/\/ admin.protosyntax = \"proto3\";package admin.v1;option go_package = \"gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/admin.git\/v1\";import \"common\/v1\/common.proto\";import \"google\/api\/annotations.proto\";import \"protoc-gen-openapiv2\/options\/annotations.proto\";option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_swagger) = {  info: { title: \"Control Plane ADMIN API\"; version: \"1.0\"; };  security_definitions: {    security: {      key: \"Bearer\";      value: {        type: TYPE_API_KEY;        in: IN_HEADER;        name: \"Authorization\";        description: \"Admin Bearer token\";      };    };  };  security: { security_requirement: { key: \"Bearer\"; } };};service AdminService {  rpc ListRunners(ListRunnersRequest) returns (ListRunnersResponse) {    option (google.api.http) = { get: \"\/v1\/runners\" };  }  rpc GetRunnerStatus(GetRunnerStatusRequest) returns (GetRunnerStatusResponse) {    option (google.api.http) = { get: \"\/v1\/runners\/{runner_id.runner_id}\/status\" };  }  \/\/ ...}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<hr\/>\n<h3>CI\/CD \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d<\/h3>\n<p>\u041f\u0430\u0439\u043f\u043b\u0430\u0439\u043d proto-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u0441\u043e\u0441\u0442\u043e\u0438\u0442 \u0438\u0437 \u0442\u0440\u0451\u0445 \u0441\u0442\u0435\u0439\u0434\u0436\u0435\u0439: <code>lint<\/code>, <code>generate<\/code>, <code>commit<\/code>. \u041f\u043e\u043b\u043d\u0430\u044f \u0432\u0435\u0440\u0441\u0438\u044f \u2014 \u0432 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438.<\/p>\n<h4>\u0414\u0436\u043e\u0431\u0430 generate<\/h4>\n<p>\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442 <code>buf generate<\/code>, \u043f\u043e\u0441\u043b\u0435 \u0447\u0435\u0433\u043e \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043c\u043e\u0434\u0443\u043b\u044f \u0441\u043e\u0437\u0434\u0430\u0451\u0442 <code>go.mod<\/code> \u0441 \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u043c \u0438\u043c\u0435\u043d\u0435\u043c \u043c\u043e\u0434\u0443\u043b\u044f, \u0432\u043a\u043b\u044e\u0447\u0430\u044f <code>.git<\/code>. \u0410\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b \u043f\u0435\u0440\u0435\u0434\u0430\u044e\u0442\u0441\u044f \u0432 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0443\u044e \u0434\u0436\u043e\u0431\u0443 \u0447\u0435\u0440\u0435\u0437 <code>artifacts.paths<\/code>.<\/p>\n<p>\u041a\u043b\u044e\u0447\u0435\u0432\u043e\u0439 \u043c\u043e\u043c\u0435\u043d\u0442: <code>go mod init<\/code> \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0441\u043b\u0438 <code>go.mod<\/code> \u0435\u0449\u0451 \u043d\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442, \u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u043f\u0435\u0440\u0435\u0437\u0430\u0442\u0438\u0440\u0430\u0442\u044c \u0444\u0430\u0439\u043b \u043f\u0440\u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u044b\u0445 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0445. \u0418\u043d\u0430\u0447\u0435 \u043f\u0440\u0438 \u043a\u0430\u0436\u0434\u043e\u043c \u043f\u0440\u043e\u0433\u043e\u043d\u0435 \u043c\u043e\u0434\u0443\u043b\u044c \u0431\u0443\u0434\u0435\u0442 \u0438\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u0437\u0430\u043d\u043e\u0432\u043e \u0438 \u0442\u0435\u0440\u044f\u0442\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438.<\/p>\n<h4>\u0414\u0436\u043e\u0431\u0430 commit-generated<\/h4>\n<p>\u041a\u043b\u043e\u043d\u0438\u0440\u0443\u0435\u0442 \u043a\u0430\u0436\u0434\u044b\u0439 \u0446\u0435\u043b\u0435\u0432\u043e\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0437\u0430\u043c\u0435\u043d\u044f\u0435\u0442 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u043c\u0438 \u0444\u0430\u0439\u043b\u0430\u043c\u0438, \u043a\u043e\u043f\u0438\u0440\u0443\u0435\u0442 <code>swagger.json<\/code>, \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0447\u0435\u0440\u0435\u0437 <code>go mod tidy<\/code>, \u043a\u043e\u043c\u043c\u0438\u0442\u0438\u0442 \u0438 \u0441\u043e\u0437\u0434\u0430\u0451\u0442 \u0442\u0435\u0433 \u0432\u0435\u0440\u0441\u0438\u0438.<\/p>\n<p>\u0412\u044b\u0431\u043e\u0440 \u0442\u043e\u043a\u0435\u043d\u0430 \u043f\u043e\u0434 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 <code>rules<\/code> \u0441 \u0443\u0441\u043b\u043e\u0432\u0438\u0435\u043c \u043d\u0430 <code>GITLAB_USER_LOGIN<\/code> \u2014 \u044d\u0442\u043e \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043a\u0430\u0436\u0434\u043e\u043c\u0443 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0443 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0441\u0432\u043e\u0439 Personal Access Token, \u043d\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u044f \u0435\u0433\u043e \u043a\u043e\u043b\u043b\u0435\u0433\u0430\u043c:<\/p>\n<pre><code class=\"yaml\">rules:  - if: $CI_COMMIT_BRANCH =~ \/^v\\d+\\.\\d+\\.\\d+$\/    variables:      PROTO_VERSION: $CI_COMMIT_BRANCH  - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH    when: never  - if: $GITLAB_USER_LOGIN == \"End1essRage\"    variables:      PUSH_TOKEN: $CI_PUSH_TOKEN  - if: $GITLAB_USER_LOGIN == \"stivvhuys\"    variables:      PUSH_TOKEN: $CI_PUSH_TOKEN_GENGAVSOV  - when: never<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0415\u0441\u043b\u0438 <code>PUSH_TOKEN<\/code> \u0432 \u0438\u0442\u043e\u0433\u0435 \u043f\u0443\u0441\u0442\u043e\u0439 \u2014 \u0434\u0436\u043e\u0431\u0430 \u043f\u0430\u0434\u0430\u0435\u0442 \u0432 <code>before_script<\/code> \u0441 \u044f\u0432\u043d\u043e\u0439 \u043e\u0448\u0438\u0431\u043a\u043e\u0439, \u0430 \u043d\u0435 \u0441 \u043d\u0435\u043f\u043e\u043d\u044f\u0442\u043d\u044b\u043c <code>403<\/code> \u0433\u0434\u0435-\u0442\u043e \u0432 \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0435 \u0441\u043a\u0440\u0438\u043f\u0442\u0430. \u042d\u0442\u043e \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u043d\u0430\u044f \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0430.<\/p>\n<p>\u0414\u043b\u044f \u043c\u043e\u0434\u0443\u043b\u0435\u0439, \u0437\u0430\u0432\u0438\u0441\u044f\u0449\u0438\u0445 \u043e\u0442 <code>common<\/code>, \u0432 \u0441\u043a\u0440\u0438\u043f\u0442\u0435 \u044f\u0432\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f <code>require<\/code> \u0441 \u043d\u0443\u0436\u043d\u043e\u0439 \u0432\u0435\u0440\u0441\u0438\u0435\u0439:<\/p>\n<pre><code class=\"bash\">if [ \"$module\" != \"common\" ]; then  go get gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/common.git@$PROTO_VERSIONfi<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u042d\u0442\u043e \u0432\u0430\u0436\u043d\u043e: \u0431\u0435\u0437 \u044f\u0432\u043d\u043e\u0433\u043e <code>go get<\/code> \u0441 \u0442\u0435\u0433\u043e\u043c <code>go mod tidy<\/code> \u043f\u043e\u0434\u0442\u044f\u043d\u0435\u0442 latest, \u0430 \u043d\u0435 \u0442\u0443 \u0432\u0435\u0440\u0441\u0438\u044e, \u043a\u043e\u0442\u043e\u0440\u0443\u044e \u043c\u044b \u0442\u043e\u043b\u044c\u043a\u043e \u0447\u0442\u043e \u043e\u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u043b\u0438.<\/p>\n<hr\/>\n<h3>\u0421\u0435\u0440\u0432\u0438\u0441, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u0439 \u0441\u0442\u0430\u0431\u044b<\/h3>\n<p>\u0420\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0438\u043c \u0441\u0442\u043e\u0440\u043e\u043d\u0443 \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044f \u2014 \u0441\u0435\u0440\u0432\u0438\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0445\u043e\u0447\u0435\u0442 \u0434\u0435\u0440\u0436\u0430\u0442\u044c swagger-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0443 \u0441\u0435\u0431\u044f, \u043e\u0442\u0434\u0430\u0432\u0430\u0442\u044c \u0435\u0451 \u0447\u0435\u0440\u0435\u0437 HTTP \u0438 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u0441 API \u0447\u0435\u0440\u0435\u0437 Swagger UI.<\/p>\n<h4>\u0412\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u043d\u0438\u0435 swagger.json \u0447\u0435\u0440\u0435\u0437 go:embed<\/h4>\n<p>\u0412 \u043a\u043e\u0440\u043d\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043f\u0430\u043a\u0435\u0442 <code>docs<\/code>:<\/p>\n<pre><code class=\"go\">package docsimport _ \"embed\"\/\/go:embed control-plane-admin.swagger.jsonvar AdminSwaggerJSON []byte\/\/go:embed control-plane-user.swagger.jsonvar UserSwaggerJSON []byte<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0418\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u043c \u0435\u0433\u043e \u0432 <code>main.go<\/code> \u0447\u0435\u0440\u0435\u0437 \u0441\u0430\u0439\u0434-\u044d\u0444\u0444\u0435\u043a\u0442:<\/p>\n<pre><code class=\"go\">import _ \"gitlab.com\/chichilaki\/mgs\/control-plane\/docs\"<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041c\u0430\u0440\u0448\u0440\u0443\u0442\u044b \u0434\u043b\u044f \u0440\u0430\u0437\u0434\u0430\u0447\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438:<\/p>\n<pre><code class=\"go\">mux.HandleFunc(\"\/swagger\/admin\/doc.json\", func(w http.ResponseWriter, r *http.Request) {    w.Header().Set(\"Content-Type\", \"application\/json\")    _, _ = w.Write(docs.AdminSwaggerJSON)})mux.HandleFunc(\"\/swagger\/user\/doc.json\", func(w http.ResponseWriter, r *http.Request) {    w.Header().Set(\"Content-Type\", \"application\/json\")    _, _ = w.Write(docs.UserSwaggerJSON)})<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p><code>go:embed<\/code> \u043a\u043e\u043c\u043f\u0438\u043b\u0438\u0440\u0443\u0435\u0442 \u0444\u0430\u0439\u043b\u044b \u043f\u0440\u044f\u043c\u043e \u0432 \u0431\u0438\u043d\u0430\u0440\u043d\u0438\u043a \u2014 \u043d\u0435 \u043d\u0443\u0436\u043d\u0430 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0440\u0430\u0437\u0434\u0430\u0447\u0430 \u0441\u0442\u0430\u0442\u0438\u043a\u0438 \u0438 \u043d\u0435\u0442 \u0440\u0438\u0441\u043a\u0430 \u0440\u0430\u0441\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0430\u0446\u0438\u0438 \u0432\u0435\u0440\u0441\u0438\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0441 \u043a\u043e\u0434\u043e\u043c.<\/p>\n<h4>\u0421\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0430\u0446\u0438\u044f swagger.json<\/h4>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0438\u0440\u0443\u0435\u043c \u0432 \u0442\u0440\u0451\u0445 \u043c\u0435\u0441\u0442\u0430\u0445: pre-commit \u0445\u0443\u043a, Taskfile \u0438 CI-\u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d \u0441\u0435\u0440\u0432\u0438\u0441\u0430. \u0412\u043e \u0432\u0441\u0435\u0445 \u0442\u0440\u0451\u0445 \u0441\u043b\u0443\u0447\u0430\u044f\u0445 \u043b\u043e\u0433\u0438\u043a\u0430 \u043e\u0434\u043d\u0430: \u043a\u043b\u043e\u043d\u0438\u0440\u0443\u0435\u043c \u0441\u0442\u0430\u0431-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0432\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044e, \u0437\u0430\u0431\u0438\u0440\u0430\u0435\u043c <code>v1\/&lt;service&gt;.swagger.json<\/code> \u0438 \u043a\u043b\u0430\u0434\u0451\u043c \u0432 <code>docs\/<\/code>.<\/p>\n<p>\u041b\u043e\u043a\u0430\u043b\u044c\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c SSH, \u0432 CI \u2014 <code>CI_JOB_TOKEN<\/code>. \u0421\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0435 \u043a\u043e\u043d\u0444\u0438\u0433\u0438 \u0434\u043b\u044f Taskfile \u0438 CI \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u044b \u0432 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438.<\/p>\n<h4>\u041b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u0439 \u0441\u0442\u0435\u043a: Traefik + Swagger UI<\/h4>\n<p>\u041f\u043e\u0434\u043d\u0438\u043c\u0430\u0435\u043c \u0447\u0435\u0440\u0435\u0437 compose. \u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: <code>BASE_URL<\/code> \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 Swagger UI \u0438 <code>PathPrefix<\/code> \u0432 \u043f\u0440\u0430\u0432\u0438\u043b\u0435 Traefik \u0434\u043e\u043b\u0436\u043d\u044b \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0442\u044c \u2014 \u0438\u043d\u0430\u0447\u0435 UI \u0437\u0430\u0433\u0440\u0443\u0437\u0438\u0442\u0441\u044f, \u043d\u043e \u043d\u0435 \u0441\u043c\u043e\u0436\u0435\u0442 \u0440\u0435\u0437\u043e\u043b\u0432\u0438\u0442\u044c \u0441\u0432\u043e\u0438 \u0436\u0435 \u0430\u0441\u0441\u0435\u0442\u044b.<\/p>\n<pre><code class=\"yaml\">swagger-ui:  image: swaggerapi\/swagger-ui:v5.9.0  environment:    BASE_URL: \/swagger    URLS: &gt;      [        { \"url\": \"\/cp-swagger\/swagger\/admin\/doc.json\", \"name\": \"ADMIN control-plane\" },        { \"url\": \"\/cp-swagger\/swagger\/user\/doc.json\", \"name\": \"USER control-plane\" }      ]  labels:    - \"traefik.http.routers.swagger.rule=Host(`localhost`) &amp;&amp; PathPrefix(`\/swagger`)\"    - \"traefik.http.routers.swagger.entrypoints=web\"    - \"traefik.http.services.swagger.loadbalancer.server.port=8080\"<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041c\u0430\u0440\u0448\u0440\u0443\u0442 \u0434\u043b\u044f \u0441\u0430\u043c\u043e\u0433\u043e \u0441\u0435\u0440\u0432\u0438\u0441\u0430 \u0441\u043e \u0441\u0442\u0440\u0438\u043f\u0438\u043d\u0433\u043e\u043c \u043f\u0440\u0435\u0444\u0438\u043a\u0441\u0430 <code>\/cp<\/code>:<\/p>\n<pre><code class=\"yaml\">control-plane:  labels:        # ===== API =====      - \"traefik.http.routers.cp-api.rule=Host(`localhost`) &amp;&amp; PathPrefix(`\/cp`)\"      - \"traefik.http.routers.cp-api.entrypoints=web\"      - \"traefik.http.routers.cp-api.service=cp\"      - \"traefik.http.middlewares.cp-strip.stripprefix.prefixes=\/cp\"      - \"traefik.http.routers.cp-api.middlewares=cp-strip\"      - \"traefik.http.services.cp.loadbalancer.server.port=9100\"      # \u0410\u043a\u0442\u0438\u0432\u0438\u0440\u0443\u0435\u043c \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 \u0437\u0434\u043e\u0440\u043e\u0432\u044c\u044f \u0434\u043b\u044f \u0431\u0430\u043b\u0430\u043d\u0441\u0438\u0440\u043e\u0432\u0449\u0438\u043a\u0430      - \"traefik.http.services.cp.loadbalancer.healthcheck.path=\/health\"      - \"traefik.http.services.cp.loadbalancer.healthcheck.interval=10s\"      - \"traefik.http.services.cp.loadbalancer.healthcheck.timeout=3s\"      - \"traefik.http.services.cp.loadbalancer.healthcheck.scheme=http\"      # \u041f\u0440\u043e\u043a\u0441\u0438 \u0434\u043b\u044f Swagger \u0447\u0435\u0440\u0435\u0437 Traefik      # ===== SWAGGER =====      - \"traefik.http.routers.cp-swagger.rule=Host(`localhost`) &amp;&amp; PathPrefix(`\/cp-swagger`)\"      - \"traefik.http.routers.cp-swagger.entrypoints=web\"      - \"traefik.http.routers.cp-swagger.service=cp-swagger\"      - \"traefik.http.middlewares.cp-swagger-strip.stripprefix.prefixes=\/cp-swagger\"      - \"traefik.http.routers.cp-swagger.middlewares=cp-swagger-strip\"      - \"traefik.http.services.cp-swagger.loadbalancer.server.port=9100\"<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<hr\/>\n<h3>\u0411\u043e\u043d\u0443\u0441: GitLab Pages \u0441\u043e Swagger UI<\/h3>\n<p>\u0423\u0434\u043e\u0431\u043d\u043e \u0438\u043c\u0435\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e, \u043d\u043e \u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u043e\u0439 \u043f\u043e \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u043e\u0439 \u0441\u0441\u044b\u043b\u043a\u0435. GitLab Pages \u0440\u0435\u0448\u0430\u0435\u0442 \u044d\u0442\u043e \u0431\u0435\u0437 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0433\u043e \u0445\u043e\u0441\u0442\u0438\u043d\u0433\u0430 \u2014 \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u044c \u0430\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b \u0432 \u043f\u0430\u043f\u043a\u0443 <code>public<\/code>.<\/p>\n<p>\u0414\u0436\u043e\u0431\u0430 <code>pages<\/code> \u0441\u043e\u0437\u0434\u0430\u0451\u0442 \u043f\u0430\u043f\u043a\u0443 <code>public<\/code>, \u043a\u043b\u0430\u0434\u0451\u0442 \u0442\u0443\u0434\u0430 swagger-\u0444\u0430\u0439\u043b\u044b \u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 <code>index.html<\/code> \u0441 CDN-\u0432\u0435\u0440\u0441\u0438\u0435\u0439 Swagger UI. \u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u0432\u0435\u0442\u043a\u0430\u0445 <code>master<\/code> \u0438 <code>dev<\/code>. \u041f\u043e\u043b\u043d\u0430\u044f \u0432\u0435\u0440\u0441\u0438\u044f \u0434\u0436\u043e\u0431\u044b \u2014 \u0432 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438.<\/p>\n<details class=\"spoiler\">\n<summary>CI: fetch-swagger + pages<\/summary>\n<div class=\"spoiler__content\">\n<pre><code class=\"yaml\">fetch-swagger:  stage: prepare  image: alpine:latest  before_script:    - apk add --no-cache git  script:    - mkdir -p docs    - |      for REPO in admin user; do        git clone --depth 1 \\          \"https:\/\/gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/${REPO}.git\" \\          \"\/tmp\/${REPO}\"        cp \"\/tmp\/${REPO}\/v1\/${REPO}.swagger.json\" \"docs\/control-plane-${REPO}.swagger.json\"        rm -rf \"\/tmp\/${REPO}\"      done  artifacts:    paths:      - docs\/*.swagger.jsonpages:  stage: pages  image: alpine:latest  script:    - mkdir -p public\/docs    - cp docs\/*.swagger.json public\/docs\/ || echo \"No swagger files\"    - |      cat &gt; public\/index.html &lt;&lt; 'EOF'      &lt;!DOCTYPE html&gt;      &lt;html&gt;      &lt;head&gt;        &lt;title&gt;API Documentation&lt;\/title&gt;        &lt;meta charset=\"UTF-8\"&gt;        &lt;link rel=\"stylesheet\" href=\"https:\/\/cdn.jsdelivr.net\/npm\/swagger-ui-dist@5\/swagger-ui.css\"&gt;      &lt;\/head&gt;      &lt;body&gt;        &lt;div id=\"swagger-ui\"&gt;&lt;\/div&gt;        &lt;script src=\"https:\/\/cdn.jsdelivr.net\/npm\/swagger-ui-dist@5\/swagger-ui-bundle.js\"&gt;&lt;\/script&gt;        &lt;script src=\"https:\/\/cdn.jsdelivr.net\/npm\/swagger-ui-dist@5\/swagger-ui-standalone-preset.js\"&gt;&lt;\/script&gt;        &lt;script&gt;          window.onload = function() {            window.ui = SwaggerUIBundle({              urls: [                { url: \".\/docs\/control-plane-admin.swagger.json\", name: \"Admin API\" },                { url: \".\/docs\/control-plane-user.swagger.json\", name: \"User API\" }              ],              dom_id: '#swagger-ui',              deepLinking: true,              presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],              layout: \"StandaloneLayout\"            });          }        &lt;\/script&gt;      &lt;\/body&gt;      &lt;\/html&gt;      EOF  artifacts:    paths:      - public  rules:    - if: $CI_COMMIT_BRANCH == \"master\"    - if: $CI_COMMIT_BRANCH == \"dev\"<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<\/div>\n<\/details>\n<hr\/>\n<h3>\u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435<\/h3>\n<p>\u0418\u0442\u043e\u0433\u043e \u0447\u0442\u043e \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c: proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0432 \u043e\u0434\u043d\u043e\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438, \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0430\u044f \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u044f \u0441\u0442\u0430\u0431\u043e\u0432 \u043f\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0438 \u0432\u0435\u0442\u043a\u0438 \u0432\u0438\u0434\u0430 <code>v1.0.0<\/code>, \u0440\u0430\u0437\u0434\u0435\u043b\u044c\u043d\u044b\u0435 Go-\u043c\u043e\u0434\u0443\u043b\u0438 \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u0441\u0435\u0440\u0432\u0438\u0441\u0430, swagger-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043a\u0430\u043a \u0447\u0430\u0441\u0442\u044c \u0442\u043e\u0433\u043e \u0436\u0435 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u0430 \u0438 Pages \u0441 UI \u0434\u043b\u044f \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u0430.<\/p>\n<p>\u041e\u0441\u043d\u043e\u0432\u043d\u0430\u044f \u0441\u043b\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0432 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u043c GitLab \u2014 \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u0442\u043e\u043a\u0435\u043d\u0430\u043c\u0438. \u0412 \u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 \u0438\u043b\u0438 self-hosted \u0431\u043e\u043b\u044c\u0448\u0430\u044f \u0447\u0430\u0441\u0442\u044c \u044d\u0442\u0438\u0445 \u0442\u0430\u043d\u0446\u0435\u0432 \u0441\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f: \u043c\u043e\u0436\u043d\u043e \u0432\u044b\u0434\u0430\u0442\u044c \u0434\u043e\u0441\u0442\u0443\u043f \u043d\u0430 \u0433\u0440\u0443\u043f\u043f\u0443 \u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0435\u0434\u0438\u043d\u044b\u0439 \u0442\u043e\u043a\u0435\u043d. \u041d\u043e \u0438 \u0432 \u043e\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u043c \u0432\u0438\u0434\u0435 \u0432\u0441\u0451 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u043e.<\/p>\n<hr\/>\n<h3>\u041f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435: \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u043e\u043d\u043d\u044b\u0435 \u0444\u0430\u0439\u043b\u044b<\/h3>\n<details class=\"spoiler\">\n<summary>buf.yaml<\/summary>\n<div class=\"spoiler__content\">\n<pre><code class=\"yaml\">version: v2deps:  - buf.build\/googleapis\/googleapis  - buf.build\/grpc-ecosystem\/grpc-gatewaylint:  use:    - STANDARDbreaking:  use:    - FILE<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<\/div>\n<\/details>\n<details class=\"spoiler\">\n<summary>buf.gen.yaml<\/summary>\n<div class=\"spoiler__content\">\n<pre><code class=\"yaml\">version: v2plugins:  - local: [\"go\", \"run\", \"google.golang.org\/protobuf\/cmd\/protoc-gen-go@v1.36.11\"]    out: gen\/go  - local: [\"go\", \"run\", \"google.golang.org\/grpc\/cmd\/protoc-gen-go-grpc@v1.6.1\"]    out: gen\/go  - local: [\"go\", \"run\", \"github.com\/grpc-ecosystem\/grpc-gateway\/v2\/protoc-gen-grpc-gateway@v2.29.0\"]    out: gen\/go  - local: [\"go\", \"run\", \"github.com\/grpc-ecosystem\/grpc-gateway\/v2\/protoc-gen-openapiv2@v2.29.0\"]    out: gen\/openapiv2    opt:      - output_format=json      - allow_merge=false<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<\/div>\n<\/details>\n<details class=\"spoiler\">\n<summary>\u041f\u043e\u043b\u043d\u044b\u0439 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d proto-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f<\/summary>\n<div class=\"spoiler__content\">\n<pre><code class=\"yaml\">stages:  - lint  - generate  - commitvariables:  GIT_STRATEGY: fetch  GIT_DEPTH: 0  GOPRIVATE: \"gitlab.com\"  GOPROXY: \"direct\"  GONOSUMDB: \"gitlab.com\"  PROTO_MODULE_BASE: \"chichilaki\/mgs\/proto-go-stubs\".setup-buf: &amp;setup-buf  - apk add --no-cache git curl  - curl -sSL \"https:\/\/github.com\/bufbuild\/buf\/releases\/download\/v1.68.4\/buf-$(uname -s)-$(uname -m)\" -o \/usr\/local\/bin\/buf  - chmod +x \/usr\/local\/bin\/buf  - buf --version  - buf dep updatelint:  stage: lint  image: alpine:latest  before_script:    - *setup-buf  script:    - buf lint  allow_failure: falsegenerate:  stage: generate  image: golang:1.26-alpine  needs: [\"lint\"]  before_script:    - *setup-buf  script:    - buf generate --template buf.gen.yaml --timeout 5m    - |      for module in common user runner admin; do        mkdir -p gen\/go\/${module}        cd gen\/go\/${module}        if [ ! -f go.mod ]; then          go mod init gitlab.com\/${PROTO_MODULE_BASE}\/${module}.git        fi        go mod tidy        cd - &gt; \/dev\/null      done  artifacts:    paths:      - gen\/go\/      - gen\/openapiv2\/    expire_in: 1 hourcommit-generated:  stage: commit  image: golang:1.26-alpine  needs: [\"generate\"]  variables:    PUSH_TOKEN: \"\"  rules:    - if: $CI_COMMIT_BRANCH =~ \/^v\\d+\\.\\d+\\.\\d+$\/      variables:        PROTO_VERSION: $CI_COMMIT_BRANCH    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH      when: never    - if: $GITLAB_USER_LOGIN == \"End1essRage\"      variables:        PUSH_TOKEN: $CI_PUSH_TOKEN    - if: $GITLAB_USER_LOGIN == \"stivvhuys\"      variables:        PUSH_TOKEN: $CI_PUSH_TOKEN_GENGAVSOV    - when: never  before_script:    - apk add --no-cache git    - |      if [ -z \"$PUSH_TOKEN\" ]; then        echo \"ERROR: no push token for user '$GITLAB_USER_LOGIN'\"        exit 1      fi    - git config --global user.email \"ci@gitlab.com\"    - git config --global user.name \"GitLab CI\"    - git config --global url.\"https:\/\/gitlab-ci-token:${PUSH_TOKEN}@gitlab.com\/\".insteadOf \"https:\/\/gitlab.com\/\"    - echo \"machine gitlab.com login gitlab-ci-token password ${PUSH_TOKEN}\" &gt; ~\/.netrc    - chmod 600 ~\/.netrc    - go env -w GOPRIVATE=gitlab.com\/chichilaki\/mgs    - go env -w GONOSUMDB=gitlab.com\/chichilaki\/mgs  script:    - |      for module in common user runner admin; do        SOURCE_PATH=\"$CI_PROJECT_DIR\/gen\/go\/gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/$module.git\"        if [ ! -d \"$SOURCE_PATH\" ]; then          echo \"Source path $SOURCE_PATH not found, skipping $module\"          continue        fi        git clone https:\/\/gitlab-ci-token:${PUSH_TOKEN}@gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/$module.git \/tmp\/repo-$module        cd \/tmp\/repo-$module        find . -mindepth 1 -not -path '.\/.git*' -delete        cp -r $SOURCE_PATH\/* .        SWAGGER_SRC=\"$CI_PROJECT_DIR\/gen\/openapiv2\/$module\/v1\/$module.swagger.json\"        if [ -f \"$SWAGGER_SRC\" ]; then          mkdir -p v1          cp \"$SWAGGER_SRC\" v1\/$module.swagger.json        else          echo \"WARN: $SWAGGER_SRC not found\"        fi        if [ ! -f go.mod ]; then          go mod init gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/$module.git        else          go mod edit -module gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/$module.git        fi        if [ \"$module\" != \"common\" ]; then          go get gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/common.git@$PROTO_VERSION        fi        go mod tidy        if git diff --quiet &amp;&amp; git diff --cached --quiet; then          echo \"No changes for $module\"          if ! git rev-parse \"$PROTO_VERSION\" &gt;\/dev\/null 2&gt;&amp;1; then            git tag \"$PROTO_VERSION\"            git push origin \"$PROTO_VERSION\"          fi        else          git add .          git commit -m \"Update stubs from proto repo ${CI_COMMIT_SHA} for version ${PROTO_VERSION} [skip ci]\"          git push origin master          git tag \"$PROTO_VERSION\"          git push origin \"$PROTO_VERSION\"        fi        cd $CI_PROJECT_DIR        rm -rf \/tmp\/repo-$module      done<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<\/div>\n<\/details>\n<details class=\"spoiler\">\n<summary>Taskfile: swagger-pull<\/summary>\n<div class=\"spoiler__content\">\n<pre><code class=\"yaml\">swagger-pull:  desc: \"Fetch swagger.json from stubs repos\"  cmds:    - |      mkdir -p docs      for REPO in admin user; do        TMP_DIR=$(mktemp -d)        git clone --depth 1 \"git@gitlab.com:chichilaki\/mgs\/proto-go-stubs\/$REPO.git\" \"$TMP_DIR\"        cp \"$TMP_DIR\/v1\/${REPO}.swagger.json\" \"docs\/control-plane-${REPO}.swagger.json\"        rm -rf \"$TMP_DIR\"      done<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<\/div>\n<\/details>\n<details class=\"spoiler\">\n<summary>\u041f\u043e\u043b\u043d\u044b\u0439 compose.yaml<\/summary>\n<div class=\"spoiler__content\">\n<pre><code class=\"yaml\">services:  traefik:    image: traefik:v3.6    restart: unless-stopped    command:      - \"--api.dashboard=true\"      - \"--api.insecure=true\"      - \"--providers.docker=true\"      - \"--providers.docker.exposedbydefault=false\"      - \"--providers.docker.network=app-network\"      - \"--entrypoints.web.address=:80\"      - \"--log.level=DEBUG\"      - \"--accesslog=true\"    ports:      - \"80:80\"      - \"8080:8080\"    volumes:      - \/var\/run\/docker.sock:\/var\/run\/docker.sock:ro      - .\/..\/proxy\/traefik:\/etc\/traefik    networks:      - app-network    labels:      - \"traefik.enable=true\"      - \"traefik.http.routers.dashboard.rule=Host(`localhost`) &amp;&amp; PathPrefix(`\/traefik`)\"      - \"traefik.http.routers.dashboard.entrypoints=web\"      - \"traefik.http.routers.dashboard.service=api@internal\"  swagger-ui:    image: swaggerapi\/swagger-ui:v5.9.0    environment:      BASE_URL: \/swagger      WITH_CREDENTIALS: \"true\"      URLS_PRIMARY_NAME: cp      URLS: &gt;        [          { \"url\": \"\/cp\/swagger\/admin\/doc.json\", \"name\": \"ADMIN control-plane\" },          { \"url\": \"\/cp\/swagger\/user\/doc.json\", \"name\": \"USER control-plane\" }        ]    networks:      - app-network    labels:      - \"traefik.enable=true\"      - \"traefik.http.routers.swagger.rule=Host(`localhost`) &amp;&amp; PathPrefix(`\/swagger`)\"      - \"traefik.http.routers.swagger.entrypoints=web\"      - \"traefik.http.routers.swagger.service=swagger\"      - \"traefik.http.services.swagger.loadbalancer.server.port=8080\"  control-plane:    build:      context: ..\/control-plane\/      dockerfile: ..\/control-plane\/Dockerfile    networks:      - app-network    labels:      - \"traefik.enable=true\"      - \"traefik.http.routers.cp-api.rule=Host(`localhost`) &amp;&amp; PathPrefix(`\/cp`)\"      - \"traefik.http.routers.cp-api.entrypoints=web\"      - \"traefik.http.routers.cp-api.service=cp\"      - \"traefik.http.middlewares.cp-strip.stripprefix.prefixes=\/cp\"      - \"traefik.http.routers.cp-api.middlewares=cp-strip\"      - \"traefik.http.services.cp.loadbalancer.server.port=9100\"      - \"traefik.http.services.cp.loadbalancer.healthcheck.path=\/health\"      - \"traefik.http.services.cp.loadbalancer.healthcheck.interval=10s\"      - \"traefik.http.services.cp.loadbalancer.healthcheck.timeout=3s\"      - \"traefik.http.services.cp.loadbalancer.healthcheck.scheme=http\"      - \"traefik.http.routers.cp-swagger.rule=Host(`localhost`) &amp;&amp; PathPrefix(`\/cp-swagger`)\"      - \"traefik.http.routers.cp-swagger.entrypoints=web\"      - \"traefik.http.routers.cp-swagger.service=cp-swagger\"      - \"traefik.http.middlewares.cp-swagger-strip.stripprefix.prefixes=\/cp-swagger\"      - \"traefik.http.routers.cp-swagger.middlewares=cp-swagger-strip\"      - \"traefik.http.services.cp-swagger.loadbalancer.server.port=9100\"networks:  app-network:    driver: bridge<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<\/div>\n<\/details>\n<\/div>\n<p>\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/1042602\/\">https:\/\/habr.com\/ru\/articles\/1042602\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u041d\u0430\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u043c \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e gRPC \u0441\u0442\u0430\u0431\u043e\u0432 \u0434\u043b\u044f Go \u0438 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u043c \u043a\u0430\u043a \u043c\u043e\u0434\u0443\u043b\u044c\u0414\u0435\u0440\u0436\u0430\u0442\u044c proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0432 \u043e\u0434\u043d\u043e\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0443\u0434\u043e\u0431\u043d\u043e, \u043d\u043e \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0442\u044c \u0438\u0445 \u0446\u0435\u043b\u0438\u043a\u043e\u043c \u0432 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441 \u2014 \u043d\u0435 \u043e\u0447\u0435\u043d\u044c. \u0420\u0430\u0437\u0431\u0435\u0440\u0451\u043c, \u043a\u0430\u043a \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c Go-\u0441\u0442\u0430\u0431\u044b \u0438\u0437 proto-\u0444\u0430\u0439\u043b\u043e\u0432, \u0432\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u0445 \u043a\u0430\u043a \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 Go-\u043c\u043e\u0434\u0443\u043b\u0438 \u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u0442\u044c \u0447\u0435\u0440\u0435\u0437 GitLab CI\/CD. \u0411\u043e\u043d\u0443\u0441\u043e\u043c \u2014 swagger-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0438 GitLab Pages.\u0412\u0441\u0451 \u043e\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u0435 \u0440\u0430\u0441\u0441\u0447\u0438\u0442\u0430\u043d\u043e \u043d\u0430 \u043f\u0440\u0438\u0432\u0430\u0442\u043d\u044b\u0439 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 GitLab. \u0412 self-hosted \u0438 \u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0432\u0435\u0440\u0441\u0438\u044f\u0445, \u0430 \u0442\u0430\u043a\u0436\u0435 \u0434\u043b\u044f \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0445 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0431\u0443\u0434\u0435\u0442 \u0437\u043d\u0430\u0447\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u043f\u0440\u043e\u0449\u0435 \u2014 \u0442\u0430\u043c \u0447\u0430\u0441\u0442\u044c \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0439 \u043f\u0440\u043e\u0441\u0442\u043e \u0441\u043d\u0438\u043c\u0430\u0435\u0442\u0441\u044f.\u041f\u0440\u0438\u043c\u0435\u0447\u0430\u043d\u0438\u044f \u043f\u0435\u0440\u0435\u0434 \u0441\u0442\u0430\u0440\u0442\u043e\u043c\u041f\u043e\u0434\u0445\u043e\u0434 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 dev-\u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f: \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u043e\u0433\u043e \u0434\u043e\u0441\u0442\u0443\u043f\u0430 \u043a \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e \u043f\u043e SSH \u0438 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0445 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f \u043d\u0430 \u043a\u0430\u0436\u0434\u043e\u0439 \u043c\u0430\u0448\u0438\u043d\u0435 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430:GOPRIVATE=gitlab.com\/your-groupGOPROXY=directGONOSUMDB=gitlab.com\/your-group\u0414\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u0445 \u0441\u0442\u0430\u0431\u044b, \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u0441\u043e\u0431\u0438\u0440\u0430\u0442\u044c vendor-\u043f\u0430\u043f\u043a\u0443 \u2014 \u043a\u0430\u043a \u043f\u0440\u0438 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e\u043c \u0437\u0430\u043f\u0443\u0441\u043a\u0435, \u0442\u0430\u043a \u0438 \u0432 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u0430\u0445 \u043f\u0440\u0438 \u043b\u0438\u043d\u0442\u0438\u043d\u0433\u0435, \u0442\u0435\u0441\u0442\u0430\u0445 \u0438 \u0441\u0431\u043e\u0440\u043a\u0435. \u042d\u0442\u043e \u043e\u0431\u0443\u0441\u043b\u043e\u0432\u043b\u0435\u043d\u043e \u0442\u0435\u043c, \u0447\u0442\u043e Go \u043d\u0435 \u0443\u043c\u0435\u0435\u0442 \u0441\u043a\u0430\u0447\u0438\u0432\u0430\u0442\u044c \u043f\u0440\u0438\u0432\u0430\u0442\u043d\u044b\u0435 \u043c\u043e\u0434\u0443\u043b\u0438 \u0438\u0437 GitLab \u0432 \u043e\u0431\u0445\u043e\u0434 \u043f\u0440\u043e\u043a\u0441\u0438 \u0431\u0435\u0437 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0439 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438.\u0414\u043e\u0441\u0442\u0443\u043f \u0432 CI-\u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u0438 \u043e\u0441\u0443\u0449\u0435\u0441\u0442\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 CI_JOB_TOKEN. \u0422\u0438\u043f\u043e\u0432\u043e\u0439 before_script \u0434\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432-\u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u0435\u0439 \u0441\u0442\u0430\u0431\u043e\u0432 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:default:  image: golang:${GO_VERSION}  cache:    key: go-mod    paths:      &#8212; go\/pkg\/mod      &#8212; .cache\/go-build  before_script:    &#8212; go version    &#8212; git config &#8212;global url.&#187;https:\/\/gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com\/&#187;.insteadOf &#171;https:\/\/gitlab.com\/&#187;    &#8212; go env -w GOPRIVATE=gitlab.com\/chichilaki    &#8212; go env -w GONOSUMDB=gitlab.com\/chichilaki    &#8212; go mod vendor\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432\u0421\u043e\u0437\u0434\u0430\u0451\u043c \u0433\u0440\u0443\u043f\u043f\u044b \u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438:`group\/proto` \u2014 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b, \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043c\u044b \u0431\u0443\u0434\u0435\u043c \u0440\u0435\u0434\u0430\u043a\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0432\u0440\u0443\u0447\u043d\u0443\u044e.`group\/proto-stubs` \u2014 \u0433\u0440\u0443\u043f\u043f\u0430 \u0434\u043b\u044f \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 \u0441\u0442\u0430\u0431\u043e\u0432, \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u0451\u043c \u0437\u0430\u0440\u0430\u043d\u0435\u0435 \u043f\u0443\u0441\u0442\u044b\u043c\u0438.`group\/proto-stubs\/common`, `group\/proto-stubs\/user`, `group\/proto-stubs\/admin` \u0438 \u0442.\u0434. \u2014 \u043f\u043e \u043e\u0434\u043d\u043e\u043c\u0443 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u043c\u043e\u0434\u0443\u043b\u044c.`group\/service` \u2014 \u043b\u044e\u0431\u043e\u0439 \u0441\u0435\u0440\u0432\u0438\u0441, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u0439 \u0441\u0442\u0430\u0431\u044b.\u0420\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0441\u0442\u0430\u0431\u043e\u0432\u0414\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u0441\u0442\u0430\u0431\u0430 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 Go-\u043c\u043e\u0434\u0443\u043b\u044f. \u0412 \u043c\u043e\u0451\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u0435\u0441\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0434\u043b\u044f \u043e\u0431\u0449\u0438\u0445 \u0441\u0443\u0449\u043d\u043e\u0441\u0442\u0435\u0439 (common) \u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u044b \u0434\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432: user, admin, runner.\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0434\u043e\u0441\u0442\u0443\u043f\u0430 \u0434\u043b\u044f CI_JOB_TOKEN\u041f\u043e\u0441\u043a\u043e\u043b\u044c\u043a\u0443 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441 \u0432 \u0441\u0432\u043e\u0451\u043c \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 CI_JOB_TOKEN \u0434\u043b\u044f \u043e\u0431\u0440\u0430\u0449\u0435\u043d\u0438\u044f \u043a \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f\u043c \u0441\u043e \u0441\u0442\u0430\u0431\u0430\u043c\u0438, \u043d\u0443\u0436\u043d\u043e \u044f\u0432\u043d\u043e \u0440\u0430\u0437\u0440\u0435\u0448\u0438\u0442\u044c \u0442\u0430\u043a\u043e\u0439 \u0434\u043e\u0441\u0442\u0443\u043f.\u0414\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u0441\u043e \u0441\u0442\u0430\u0431\u0430\u043c\u0438 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u043c Settings -&gt; CI\/CD -&gt; Job token permissions \u0438 \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0441 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438 \u0438 \u0433\u0440\u0443\u043f\u043f\u0443 \u0441 \u0441\u0435\u0440\u0432\u0438\u0441\u0430\u043c\u0438, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u043c\u0438 \u0441\u0442\u0430\u0431\u044b.\u0412\u0430\u0436\u043d\u044b\u0439 \u043c\u043e\u043c\u0435\u043d\u0442: \u0435\u0441\u043b\u0438 \u043e\u0434\u043d\u0438 \u0441\u0442\u0430\u0431\u044b \u0437\u0430\u0432\u0438\u0441\u044f\u0442 \u043e\u0442 \u0434\u0440\u0443\u0433\u0438\u0445 \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, admin \u0438\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u0442 common \u2014 \u0442\u043e \u0432 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430\u0445 \u0434\u043e\u0441\u0442\u0443\u043f\u0430 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f admin.git \u043d\u0443\u0436\u043d\u043e \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0433\u0440\u0443\u043f\u043f\u0443 \u0441\u043e \u0441\u0442\u0430\u0431-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f\u043c\u0438. \u0418\u043d\u0430\u0447\u0435 go get \u0432 CI \u0443\u043f\u0430\u0434\u0451\u0442 \u0441 \u043e\u0448\u0438\u0431\u043a\u043e\u0439 \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0438 \u0431\u0443\u0434\u0435\u0442 \u043d\u0435\u043e\u0447\u0435\u0432\u0438\u0434\u043d\u043e \u043f\u043e\u0447\u0435\u043c\u0443.\u0412 \u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0438 self-hosted \u0432\u0435\u0440\u0441\u0438\u044f\u0445 GitLab \u043c\u043e\u0436\u043d\u043e \u0434\u0430\u0432\u0430\u0442\u044c \u0434\u043e\u0441\u0442\u0443\u043f \u0441\u0440\u0430\u0437\u0443 \u043d\u0430 \u0433\u0440\u0443\u043f\u043f\u0443 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432 \u2014 \u0442\u0430\u043c \u044d\u0442\u043e \u043d\u0430\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435.\u041f\u043e\u0447\u0435\u043c\u0443 .git \u0432 \u0438\u043c\u0435\u043d\u0438 \u043c\u043e\u0434\u0443\u043b\u044f\u0418\u043c\u044f \u043c\u043e\u0434\u0443\u043b\u044f \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u0441\u0443\u0444\u0444\u0438\u043a\u0441 .git:gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/common.git\u042d\u0442\u043e \u043d\u0435 \u0441\u043b\u0443\u0447\u0430\u0439\u043d\u043e\u0441\u0442\u044c. Go \u043f\u0440\u0438 \u0440\u0435\u0437\u043e\u043b\u0432\u0435 \u043f\u0443\u0442\u0438 \u043c\u043e\u0434\u0443\u043b\u044f \u0438\u0437 GitLab \u043d\u0435 \u043c\u043e\u0436\u0435\u0442 \u0441\u0430\u043c\u043e\u0441\u0442\u043e\u044f\u0442\u0435\u043b\u044c\u043d\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0438\u0442\u044c, \u0433\u0434\u0435 \u0437\u0430\u043a\u0430\u043d\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u043f\u0443\u0442\u044c \u043a \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044e \u0438 \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u043f\u0443\u0442\u044c \u043a \u043f\u0430\u043a\u0435\u0442\u0443 \u0432\u043d\u0443\u0442\u0440\u0438 \u043d\u0435\u0433\u043e. \u0421\u0443\u0444\u0444\u0438\u043a\u0441 .git \u0434\u0430\u0451\u0442 \u0435\u043c\u0443 \u044f\u0432\u043d\u0443\u044e \u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0443. \u0411\u0435\u0437 \u043d\u0435\u0433\u043e go get \u0431\u0443\u0434\u0435\u0442 \u043f\u044b\u0442\u0430\u0442\u044c\u0441\u044f \u043d\u0430\u0439\u0442\u0438 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 \u043c\u043e\u0434\u0443\u043b\u044f \u043f\u043e \u043d\u0435\u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u043e\u043c\u0443 \u043f\u0443\u0442\u0438 \u0438 \u043f\u0430\u0434\u0430\u0442\u044c.\u0420\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0441 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438\u0418\u043c\u0435\u043d\u043d\u043e \u044d\u0442\u043e\u0442 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d \u0441 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 \u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0435\u0439 \u0441\u0442\u0430\u0431\u043e\u0432.\u0412\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435\u0414\u0436\u043e\u0431\u0430 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0438 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u0432\u0435\u0442\u043e\u043a \u0441 \u0438\u043c\u0435\u043d\u0435\u043c \u0432\u0438\u0434\u0430 vX.X.X. \u041f\u0440\u0438 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0438 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043e\u0434\u043d\u043e\u0438\u043c\u0451\u043d\u043d\u044b\u0439 \u0442\u0435\u0433 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0441\u0442\u0430\u0431\u043e\u0432. \u0422\u0430\u043a\u0438\u043c \u043e\u0431\u0440\u0430\u0437\u043e\u043c, \u0438\u043c\u044f \u0432\u0435\u0442\u043a\u0438 \u0432 proto-\u0440\u0435\u043f\u043e \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0441\u044f \u0432\u0435\u0440\u0441\u0438\u0435\u0439 Go-\u043c\u043e\u0434\u0443\u043b\u044f. \u0425\u043e\u0447\u0435\u0448\u044c \u0432\u044b\u043f\u0443\u0441\u0442\u0438\u0442\u044c v1.2.3 \u2014 \u0441\u043e\u0437\u0434\u0430\u0451\u0448\u044c \u0432\u0435\u0442\u043a\u0443 v1.2.3 \u0438 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0448\u044c \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d.\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 Personal Access Token\u0421 \u043d\u0435\u0434\u0430\u0432\u043d\u0438\u0445 \u043f\u043e\u0440 \u0432 GitLab Next \u043f\u043e\u044f\u0432\u0438\u043b\u0430\u0441\u044c \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0434\u043e\u0441\u0442\u0443\u043f CI_JOB_TOKEN \u043d\u0430 \u043f\u0443\u0448 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u2014 \u0441\u0442\u043e\u0438\u0442 \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c, \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u044d\u0442\u043e\u0442 \u0448\u0430\u0433 \u0441\u043a\u043e\u0440\u043e \u0441\u0442\u0430\u043d\u0435\u0442 \u043b\u0438\u0448\u043d\u0438\u043c.\u0412 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 GitLab \u043d\u0435\u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u0432\u044b\u0434\u0430\u0442\u044c access token \u043d\u0430 \u0433\u0440\u0443\u043f\u043f\u0443 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c Personal Access Token.Profile Settings -&gt; Access Tokens \u2014 \u0441\u043e\u0437\u0434\u0430\u0451\u043c \u0442\u043e\u043a\u0435\u043d \u0441 \u043f\u0440\u0430\u0432\u0430\u043c\u0438 api, read_api, read_repository, write_repository. \u0422\u043e\u043a\u0435\u043d \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u2014 \u0441\u043e\u0445\u0440\u0430\u043d\u0438\u0442\u0435 \u0435\u0433\u043e \u0441\u0440\u0430\u0437\u0443.\u0414\u0430\u043b\u0435\u0435 \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0441 proto-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u043c\u0438: Settings -&gt; CI\/CD -&gt; Variables. \u0421\u043e\u0437\u0434\u0430\u0451\u043c \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e:type: `Variable`visibility: `Masked and hidden`flag: `Protected`\u0415\u0441\u043b\u0438 \u0432 \u043a\u043e\u043c\u0430\u043d\u0434\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432 \u2014 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u043e\u0437\u0434\u0430\u0451\u0442 \u0441\u0432\u043e\u0439 \u0442\u043e\u043a\u0435\u043d \u0438 \u0441\u0432\u043e\u044e \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440 CI_PUSH_TOKEN_USERNAME. \u0412 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u0435 \u0432\u044b\u0431\u043e\u0440 \u043d\u0443\u0436\u043d\u043e\u0433\u043e \u0442\u043e\u043a\u0435\u043d\u0430 \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 rules \u0441 \u0443\u0441\u043b\u043e\u0432\u0438\u0435\u043c \u043d\u0430 GITLAB_USER_LOGIN \u2014 \u043e\u0431 \u044d\u0442\u043e\u043c \u043d\u0438\u0436\u0435.\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 Branch Rules\u0427\u0442\u043e\u0431\u044b protected-\u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u0431\u044b\u043b\u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0432 \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439 \u0432\u0435\u0442\u043a\u0435: Settings -&gt; Repository -&gt; Branch Rules -&gt; Add rule. \u041c\u0430\u0441\u043a\u0430 v* \u0434\u0430\u0441\u0442 \u0434\u043e\u0441\u0442\u0443\u043f \u043b\u044e\u0431\u043e\u0439 \u0432\u0435\u0442\u043a\u0435, \u043d\u0430\u0447\u0438\u043d\u0430\u044e\u0449\u0435\u0439\u0441\u044f \u0441 v, \u043a \u0437\u0430\u0449\u0438\u0449\u0451\u043d\u043d\u044b\u043c \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u043c \u0438 \u0442\u043e\u043a\u0435\u043d\u0430\u043c. \u0411\u0435\u0437 \u044d\u0442\u043e\u0433\u043e \u0448\u0430\u0433\u0430 \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d \u043d\u0430 \u0432\u0435\u0442\u043a\u0435 v1.0.0 \u043f\u0440\u043e\u0441\u0442\u043e \u043d\u0435 \u0443\u0432\u0438\u0434\u0438\u0442 \u0442\u043e\u043a\u0435\u043d.\u041a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f bufbuf.yaml \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0438 \u043f\u0440\u0430\u0432\u0438\u043b\u0430 \u043b\u0438\u043d\u0442\u0438\u043d\u0433\u0430, buf.gen.yaml \u2014 \u043f\u043b\u0430\u0433\u0438\u043d\u044b \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438.\u0412 buf.gen.yaml \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c local \u0441 go run \u0432\u043c\u0435\u0441\u0442\u043e \u0433\u043b\u043e\u0431\u0430\u043b\u044c\u043d\u043e\u0439 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0438 protoc \u0438 \u043f\u043b\u0430\u0433\u0438\u043d\u043e\u0432 \u2014 Go \u0441\u0430\u043c \u0441\u043a\u0430\u0447\u0430\u0435\u0442 \u043d\u0443\u0436\u043d\u044b\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u0437\u0430\u043f\u0443\u0441\u043a\u0435. \u042d\u0442\u043e \u0438\u0437\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u043e\u0442 \u043f\u0440\u043e\u0431\u043b\u0435\u043c \u0441 \u0440\u0430\u0441\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u0435\u043c \u0432\u0435\u0440\u0441\u0438\u0439 \u043c\u0435\u0436\u0434\u0443 \u043c\u0430\u0448\u0438\u043d\u0430\u043c\u0438 \u0438 CI.\u041e\u0431\u0430 \u0444\u0430\u0439\u043b\u0430 \u043f\u043e\u043b\u043d\u043e\u0441\u0442\u044c\u044e \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u044b \u0432 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438.\u041f\u0440\u0438\u043c\u0435\u0440 proto-\u0444\u0430\u0439\u043b\u043e\u0432\u0412 go_package \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u0441\u0443\u0444\u0444\u0438\u043a\u0441 .git \u2014 \u0438\u043c\u0435\u043d\u043d\u043e \u0442\u0430\u043a Go \u0431\u0443\u0434\u0435\u0442 \u0440\u0430\u0437\u0440\u0435\u0448\u0430\u0442\u044c \u0438\u043c\u043f\u043e\u0440\u0442 \u043c\u043e\u0434\u0443\u043b\u044f:\/\/ common.protosyntax = &#171;proto3&#187;;package common.v1;option go_package = &#171;gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/common.git\/v1&#187;;\u0414\u043b\u044f \u0441\u0435\u0440\u0432\u0438\u0441\u043d\u044b\u0445 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 \u0441 HTTP-\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f\u043c\u0438 grpc-gateway \u0438 swagger-\u043e\u043f\u0446\u0438\u044f\u043c\u0438 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:\/\/ admin.protosyntax = &#171;proto3&#187;;package admin.v1;option go_package = &#171;gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/admin.git\/v1&#187;;import &#171;common\/v1\/common.proto&#187;;import &#171;google\/api\/annotations.proto&#187;;import &#171;protoc-gen-openapiv2\/options\/annotations.proto&#187;;option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_swagger) = {  info: { title: &#171;Control Plane ADMIN API&#187;; version: &#171;1.0&#187;; };  security_definitions: {    security: {      key: &#171;Bearer&#187;;      value: {        type: TYPE_API_KEY;        in: IN_HEADER;        name: &#171;Authorization&#187;;        description: &#171;Admin Bearer token&#187;;      };    };  };  security: { security_requirement: { key: &#171;Bearer&#187;; } };};service AdminService {  rpc ListRunners(ListRunnersRequest) returns (ListRunnersResponse) {    option (google.api.http) = { get: &#171;\/v1\/runners&#187; };  }  rpc GetRunnerStatus(GetRunnerStatusRequest) returns (GetRunnerStatusResponse) {    option (google.api.http) = { get: &#171;\/v1\/runners\/{runner_id.runner_id}\/status&#187; };  }  \/\/ &#8230;}CI\/CD \u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d\u041f\u0430\u0439\u043f\u043b\u0430\u0439\u043d proto-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u0441\u043e\u0441\u0442\u043e\u0438\u0442 \u0438\u0437 \u0442\u0440\u0451\u0445 \u0441\u0442\u0435\u0439\u0434\u0436\u0435\u0439: lint, generate, commit. \u041f\u043e\u043b\u043d\u0430\u044f \u0432\u0435\u0440\u0441\u0438\u044f \u2014 \u0432 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438.\u0414\u0436\u043e\u0431\u0430 generate\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442 buf generate, \u043f\u043e\u0441\u043b\u0435 \u0447\u0435\u0433\u043e \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043c\u043e\u0434\u0443\u043b\u044f \u0441\u043e\u0437\u0434\u0430\u0451\u0442 go.mod \u0441 \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u043c \u0438\u043c\u0435\u043d\u0435\u043c \u043c\u043e\u0434\u0443\u043b\u044f, \u0432\u043a\u043b\u044e\u0447\u0430\u044f .git. \u0410\u0440\u0442\u0435\u0444\u0430\u043a\u0442\u044b \u043f\u0435\u0440\u0435\u0434\u0430\u044e\u0442\u0441\u044f \u0432 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0443\u044e \u0434\u0436\u043e\u0431\u0443 \u0447\u0435\u0440\u0435\u0437 artifacts.paths.\u041a\u043b\u044e\u0447\u0435\u0432\u043e\u0439 \u043c\u043e\u043c\u0435\u043d\u0442: go mod init \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0441\u043b\u0438 go.mod \u0435\u0449\u0451 \u043d\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442, \u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u043f\u0435\u0440\u0435\u0437\u0430\u0442\u0438\u0440\u0430\u0442\u044c \u0444\u0430\u0439\u043b \u043f\u0440\u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u044b\u0445 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0445. \u0418\u043d\u0430\u0447\u0435 \u043f\u0440\u0438 \u043a\u0430\u0436\u0434\u043e\u043c \u043f\u0440\u043e\u0433\u043e\u043d\u0435 \u043c\u043e\u0434\u0443\u043b\u044c \u0431\u0443\u0434\u0435\u0442 \u0438\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u0437\u0430\u043d\u043e\u0432\u043e \u0438 \u0442\u0435\u0440\u044f\u0442\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438.\u0414\u0436\u043e\u0431\u0430 commit-generated\u041a\u043b\u043e\u043d\u0438\u0440\u0443\u0435\u0442 \u043a\u0430\u0436\u0434\u044b\u0439 \u0446\u0435\u043b\u0435\u0432\u043e\u0439 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0437\u0430\u043c\u0435\u043d\u044f\u0435\u0442 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u043c\u0438 \u0444\u0430\u0439\u043b\u0430\u043c\u0438, \u043a\u043e\u043f\u0438\u0440\u0443\u0435\u0442 swagger.json, \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0447\u0435\u0440\u0435\u0437 go mod tidy, \u043a\u043e\u043c\u043c\u0438\u0442\u0438\u0442 \u0438 \u0441\u043e\u0437\u0434\u0430\u0451\u0442 \u0442\u0435\u0433 \u0432\u0435\u0440\u0441\u0438\u0438.\u0412\u044b\u0431\u043e\u0440 \u0442\u043e\u043a\u0435\u043d\u0430 \u043f\u043e\u0434 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 rules \u0441 \u0443\u0441\u043b\u043e\u0432\u0438\u0435\u043c \u043d\u0430 GITLAB_USER_LOGIN \u2014 \u044d\u0442\u043e \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043a\u0430\u0436\u0434\u043e\u043c\u0443 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0443 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0441\u0432\u043e\u0439 Personal Access Token, \u043d\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u044f \u0435\u0433\u043e \u043a\u043e\u043b\u043b\u0435\u0433\u0430\u043c:rules:  &#8212; if: $CI_COMMIT_BRANCH =~ \/^v\\d+\\.\\d+\\.\\d+$\/    variables:      PROTO_VERSION: $CI_COMMIT_BRANCH  &#8212; if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH    when: never  &#8212; if: $GITLAB_USER_LOGIN == &#171;End1essRage&#187;    variables:      PUSH_TOKEN: $CI_PUSH_TOKEN  &#8212; if: $GITLAB_USER_LOGIN == &#171;stivvhuys&#187;    variables:      PUSH_TOKEN: $CI_PUSH_TOKEN_GENGAVSOV  &#8212; when: never\u0415\u0441\u043b\u0438 PUSH_TOKEN \u0432 \u0438\u0442\u043e\u0433\u0435 \u043f\u0443\u0441\u0442\u043e\u0439 \u2014 \u0434\u0436\u043e\u0431\u0430 \u043f\u0430\u0434\u0430\u0435\u0442 \u0432 before_script \u0441 \u044f\u0432\u043d\u043e\u0439 \u043e\u0448\u0438\u0431\u043a\u043e\u0439, \u0430 \u043d\u0435 \u0441 \u043d\u0435\u043f\u043e\u043d\u044f\u0442\u043d\u044b\u043c 403 \u0433\u0434\u0435-\u0442\u043e \u0432 \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0435 \u0441\u043a\u0440\u0438\u043f\u0442\u0430. \u042d\u0442\u043e \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u043d\u0430\u044f \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0430.\u0414\u043b\u044f \u043c\u043e\u0434\u0443\u043b\u0435\u0439, \u0437\u0430\u0432\u0438\u0441\u044f\u0449\u0438\u0445 \u043e\u0442 common, \u0432 \u0441\u043a\u0440\u0438\u043f\u0442\u0435 \u044f\u0432\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f require \u0441 \u043d\u0443\u0436\u043d\u043e\u0439 \u0432\u0435\u0440\u0441\u0438\u0435\u0439:if [ &#171;$module&#187; != &#171;common&#187; ]; then  go get gitlab.com\/chichilaki\/mgs\/proto-go-stubs\/common.git@$PROTO_VERSIONfi\u042d\u0442\u043e \u0432\u0430\u0436\u043d\u043e: \u0431\u0435\u0437 \u044f\u0432\u043d\u043e\u0433\u043e go get \u0441 \u0442\u0435\u0433\u043e\u043c go mod tidy \u043f\u043e\u0434\u0442\u044f\u043d\u0435\u0442 latest, \u0430 \u043d\u0435 \u0442\u0443 \u0432\u0435\u0440\u0441\u0438\u044e, \u043a\u043e\u0442\u043e\u0440\u0443\u044e \u043c\u044b \u0442\u043e\u043b\u044c\u043a\u043e \u0447\u0442\u043e \u043e\u043f\u0443\u0431\u043b\u0438\u043a\u043e\u0432\u0430\u043b\u0438.\u0421\u0435\u0440\u0432\u0438\u0441, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0449\u0438\u0439 \u0441\u0442\u0430\u0431\u044b\u0420\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0438\u043c \u0441\u0442\u043e\u0440\u043e\u043d\u0443 \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044f \u2014 \u0441\u0435\u0440\u0432\u0438\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0445\u043e\u0447\u0435\u0442 \u0434\u0435\u0440\u0436\u0430\u0442\u044c swagger-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0443 \u0441\u0435\u0431\u044f, \u043e\u0442\u0434\u0430\u0432\u0430\u0442\u044c \u0435\u0451 \u0447\u0435\u0440\u0435\u0437 HTTP \u0438 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u0441 API \u0447\u0435\u0440\u0435\u0437 Swagger UI.\u0412\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u043d\u0438\u0435 swagger.json \u0447\u0435\u0440\u0435\u0437 go:embed\u0412 \u043a\u043e\u0440\u043d\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043f\u0430\u043a\u0435\u0442 docs:package docsimport _ &#171;embed&#187;\/\/go:embed control-plane-admin.swagger.jsonvar AdminSwaggerJSON []byte\/\/go:embed control-plane-user.swagger.jsonvar UserSwaggerJSON []byte\u0418\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u043c \u0435\u0433\u043e \u0432 main.go \u0447\u0435\u0440\u0435\u0437 \u0441\u0430\u0439\u0434-\u044d\u0444\u0444\u0435\u043a\u0442:import _ &#171;gitlab.com\/chichilaki\/mgs\/control-plane\/docs&#187;\u041c\u0430\u0440\u0448\u0440\u0443\u0442\u044b \u0434\u043b\u044f \u0440\u0430\u0437\u0434\u0430\u0447\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438:mux.HandleFunc(&#171;\/swagger\/admin\/doc.json&#187;, func(w http.ResponseWriter, r *http.Request) {    w.Header().Set(&#171;Content-Type&#187;, &#171;application\/json&#187;)    _, _ = w.Write(docs.AdminSwaggerJSON)})mux.HandleFunc(&#171;\/swagger\/user\/doc.json&#187;, func(w http.ResponseWriter, r *http.Request) {    w.Header().Set(&#171;Content-Type&#187;, &#171;application\/json&#187;)    _, _ = w.Write(docs.UserSwaggerJSON)})go:embed \u043a\u043e\u043c\u043f\u0438\u043b\u0438\u0440\u0443\u0435\u0442 \u0444\u0430\u0439\u043b\u044b \u043f\u0440\u044f\u043c\u043e \u0432 \u0431\u0438\u043d\u0430\u0440\u043d\u0438\u043a \u2014 \u043d\u0435 \u043d\u0443\u0436\u043d\u0430 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0440\u0430\u0437\u0434\u0430\u0447\u0430 \u0441\u0442\u0430\u0442\u0438\u043a\u0438 \u0438 \u043d\u0435\u0442 \u0440\u0438\u0441\u043a\u0430 \u0440\u0430\u0441\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0430\u0446\u0438\u0438 \u0432\u0435\u0440\u0441\u0438\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0441 \u043a\u043e\u0434\u043e\u043c.\u0421\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0430\u0446\u0438\u044f swagger.json\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0438\u0440\u0443\u0435\u043c \u0432 \u0442\u0440\u0451\u0445 \u043c\u0435\u0441\u0442\u0430\u0445: pre-commit \u0445\u0443\u043a, Taskfile \u0438 CI-\u043f\u0430\u0439\u043f\u043b\u0430\u0439\u043d \u0441\u0435\u0440\u0432\u0438\u0441\u0430. \u0412\u043e \u0432\u0441\u0435\u0445 \u0442\u0440\u0451\u0445 \u0441\u043b\u0443\u0447\u0430\u044f\u0445 \u043b\u043e\u0433\u0438\u043a\u0430 \u043e\u0434\u043d\u0430: \u043a\u043b\u043e\u043d\u0438\u0440\u0443\u0435\u043c \u0441\u0442\u0430\u0431-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0432\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u0443\u044e \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044e, \u0437\u0430\u0431\u0438\u0440\u0430\u0435\u043c v1\/&lt;service&gt;.swagger.json \u0438 \u043a\u043b\u0430\u0434\u0451\u043c \u0432 docs\/.\u041b\u043e\u043a\u0430\u043b\u044c\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c SSH, \u0432 CI \u2014 CI_JOB_TOKEN. \u0421\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0435 \u043a\u043e\u043d\u0444\u0438\u0433\u0438 \u0434\u043b\u044f Taskfile \u0438 CI \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u044b \u0432 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438.\u041b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u0439 \u0441\u0442\u0435\u043a: Traefik + Swagger UI\u041f\u043e\u0434\u043d\u0438\u043c\u0430\u0435\u043c \u0447\u0435\u0440\u0435\u0437 compose. \u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: BASE_URL \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 Swagger UI \u0438 PathPrefix \u0432 \u043f\u0440\u0430\u0432\u0438\u043b\u0435 Traefik \u0434\u043e\u043b\u0436\u043d\u044b \u0441\u043e\u0432\u043f\u0430\u0434\u0430\u0442\u044c \u2014 \u0438\u043d\u0430\u0447\u0435 UI \u0437\u0430\u0433\u0440\u0443\u0437\u0438\u0442\u0441\u044f, \u043d\u043e \u043d\u0435 \u0441\u043c\u043e\u0436\u0435\u0442 \u0440\u0435\u0437\u043e\u043b\u0432\u0438\u0442\u044c \u0441\u0432\u043e\u0438 \u0436\u0435 \u0430\u0441\u0441\u0435\u0442\u044b.swagger-ui:&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-482062","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/482062","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=482062"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/482062\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=482062"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=482062"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=482062"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}