[feat]openapiv3

Author: piupuer

Diff for: .gitignore

@@ -35,4 +35,5 @@ bin/
 .idea/
 *.swp
 
-docs/
+docs/*/*
+!docs/game-proto/game.openapi.yaml

Diff for: Dockerfile

@@ -1,29 +1,26 @@
-FROM golang:1.20.5 AS builder
+FROM golang:1.20-alpine3.18 AS builder
 
 #ENV GOPROXY=https://goproxy.cn
 # CGO_ENABLED=1, need check `ldd --version` is same as builder
 ENV CGO_ENABLED=0
 
-# install cinch tool
-RUN go install github.com/go-cinch/cinch/cmd/cinch@latest
+RUN apk update && apk add --no-cache git make
 
+COPY . /src
 WORKDIR /src
 # download first can use docker build cache if go.mod not change
 COPY go.mod go.sum ./
 RUN go mod download
+RUN go mod verify
+
 COPY . .
 RUN make build
 
-FROM ubuntu:22.04
+FROM alpine:3.18
 
-RUN apt-get update && \
-    apt-get install -y --no-install-recommends ca-certificates netbase && \
-    rm -rf /var/lib/apt/lists/ && \
-    apt-get autoremove -y && \
-    apt-get autoclean -y
+RUN apk update && apk add --no-cache bash
 
 COPY --from=builder /src/bin /app
-COPY --from=builder /go/bin/cinch /go/bin
 
 WORKDIR /app
 

Diff for: Makefile

@@ -17,15 +17,14 @@ endif
 .PHONY: init
 # init env
 init:
-	go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-	go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
+	go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.32.0
+	go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.3.0
 	go install github.com/go-kratos/kratos/cmd/kratos/v2@latest
 	go install github.com/go-kratos/kratos/cmd/protoc-gen-go-errors/v2@latest
 	go install github.com/go-kratos/kratos/cmd/protoc-gen-go-http/v2@latest
-	go install github.com/google/gnostic/cmd/protoc-gen-openapi@latest
-	go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
-	go install github.com/envoyproxy/protoc-gen-validate@latest
-	curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(GOPATH)/bin
+	go install github.com/google/gnostic/cmd/[email protected]
+	go install github.com/envoyproxy/[email protected]
+	curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(GOPATH)/bin v1.55.2
 
 .PHONY: config
 # generate internal proto
@@ -55,9 +54,7 @@ api:
         	--go-http_out=. \
         	--go-grpc_out=. \
         	--validate_out=lang=go:. \
-        	--openapiv2_out docs \
-        	--openapiv2_opt logtostderr=true \
-        	--openapiv2_opt json_names_for_fields=false \
+        	--openapi_out=fq_schema_naming=true,default_response=false,output_mode=source_relative:docs \
         	$$NAME; \
 	done
 	@echo 'You can import *.json into https://editor.swagger.io/'

Diff for: api/auth/auth.pb.go

@@ -1,4 +1,5 @@
 server:
+  prod: false
   machineId: ''
   http:
     addr: 0.0.0.0:8080

Diff for: api/auth/auth_grpc.pb.go

@@ -2,6 +2,7 @@ package biz
 
 import (
 	"context"
+
 	"github.com/go-cinch/common/constant"
 	"github.com/go-cinch/common/middleware/i18n"
 	"github.com/go-cinch/layout/api/reason"

Diff for: api/auth/auth_http.pb.go

@@ -26,14 +26,15 @@ message Server {
     string addr = 2;
     google.protobuf.Duration timeout = 3;
   }
-  string machineId = 1;
-  HTTP http = 2;
-  GRPC grpc = 3;
-  string language = 4;
-  bool idempotent = 5;
-  bool validate = 6;
-  bool nocache = 7;
-  string logLevel = 8;
+  bool prod = 1;
+  string machineId = 2;
+  HTTP http = 3;
+  GRPC grpc = 4;
+  string language = 5;
+  bool idempotent = 6;
+  bool validate = 7;
+  bool nocache = 8;
+  string logLevel = 9;
 }
 
 message Data {

Diff for: api/game/game.pb.go

@@ -8,6 +8,7 @@ import (
 	"github.com/go-cinch/common/log"
 	"github.com/go-cinch/layout/api/auth"
 	"github.com/go-cinch/layout/internal/conf"
+	"github.com/go-kratos/kratos/v2/middleware/circuitbreaker"
 	"github.com/go-kratos/kratos/v2/middleware/metadata"
 	"github.com/go-kratos/kratos/v2/middleware/recovery"
 	"github.com/go-kratos/kratos/v2/middleware/tracing"
@@ -33,6 +34,7 @@ func NewClient[T any](name, endpoint string, health bool, timeout time.Duration,
 		grpc.WithMiddleware(
 			tracing.Client(),
 			metadata.Client(),
+			circuitbreaker.Client(),
 			recovery.Recovery(),
 		),
 		grpc.WithOptions(g.WithDisableHealthCheck()),

Diff for: api/game/game_grpc.pb.go

@@ -669,4 +669,3 @@ message Xml {
   bool wrapped = 5;
   repeated NamedAny specification_extension = 6;
 }
-