乐趣区

关于go:基于GoGrpckubernetesIstio开发微服务的最佳实践尝试-23

jiezi

基于 Go/Grpc/kubernetes/Istio 开发微服务的最佳实际尝试 – 1/3

基于 Go/Grpc/kubernetes/Istio 开发微服务的最佳实际尝试 – 2/3

基于 Go/Grpc/kubernetes/Istio 开发微服务的最佳实际尝试 – 3/3

我的项目地址：https://github.com/janrs-io/Jgrpc

转载请注明起源：https://janrs.com/ugj7

在上一部分中，咱们创立了微服务的目录构造并实现了微服务pongservice。

这部分咱们持续实现一个名为 pingservice 的微服务，拜访上一节曾经部署好的 pongservice 微服务。

创立一个新的微服务非常简单，只需复制之前创立的 pongservice 微服务，而后做一些小改变。

我的项目构造

这部分最终的目录构造如下：

pingservice
├── buf.gen.yaml
├── cmd
│   ├── main.go
│   └── server
│       ├── grpc.go
│       ├── http.go
│       ├── run.go
│       ├── wire.go
│       └── wire_gen.go
├── config
│   ├── client.go
│   ├── config.go
│   └── config.yaml
├── genproto
│   └── v1
│       ├── gw
│       │   └── pingservice.pb.gw.go
│       ├── pingservice.pb.go
│       └── pingservice_grpc.pb.go
├── go.mod
├── go.sum
├── proto
│   ├── buf.lock
│   ├── buf.yaml
│   └── v1
│       ├── pingservice.proto
│       └── pingservice.yaml
└── service
    ├── client.go
    └── server.go

9 directories, 21 files

开始

复制

在 src 目录下执行如下复制命令：

cp -R pongservice pingservice

删除 wire_gen.go

删除 pingservice/cmd/server 目录中的 wire_gen.go 文件。

批改 go.mod module

批改 go.mod 文件的模块，如下代码所示：

module github.com/janrs-io/Jgrpc/src/pingservice

生成 proto

删除 pingservice/proto/v1 目录下的 pongservice.proto 和pongservice.yaml文件以及整个 genproto 文件夹。

而后从新创立 pingservice.proto 和pingservice.yaml文件，代码如下：

pingservice.proto code:

syntax = "proto3";

package proto.v1;

option go_package = "github.com/janrs-io/Jgrpc/src/pingservice/genproto/v1";

service PingService {rpc Ping(PingRequest) returns(PingResponse){}}

message PingRequest {string msg = 1 ;}

message PingResponse {string msg = 1;}

pingservice.yaml code:

type: google.api.Service
config_version: 3

http:
  rules:
    - selector: proto.v1.PingService.Ping
      get: /ping.v1.ping

批改 pingservice 目录下的 buf.gen.yaml 文件。批改后的残缺代码如下：

version: v1
plugins:
  - plugin: go
    out: genproto/v1
    opt:
      - paths=source_relative
  - plugin: go-grpc
    out: genproto/v1
    opt:
      - paths=source_relative
  - plugin: grpc-gateway
    out: genproto/v1/gw
    opt:
      - paths=source_relative
      - grpc_api_configuration=proto/v1/pingservice.yaml
      - standalone=true

在 pingservice 目录下执行以下命令生成 proto 文件：

buf generate proto/v1

执行命令后，将从新生成 genproto 目录，并主动创立 *pb.go 文件。

批改 import 门路和所有代码

查看 所有文件 的导入，将导入门路的 pongservice 批改为pingservice。

将所有代码的 Pong/pong 改为Ping/ping，直到没有谬误为止。

批改 config.yaml

批改 config 目录下的 config.yaml 文件。
将 grpc 的服务器端口更改为 50052，将 http 的服务器端口更改为 9002。
将 grpc 的服务名改为ping-grpc，将 http 的服务名改为ping-http。

批改后的残缺代码如下：

# grpc config
grpc:
  host: ""port:":50052"name:"ping-grpc"

# http config
http:
  host: ""port:":9002"name:"ping-http"

生成 generate inject

在 pingservice 目录中执行以下 wire 命令以从新生成依赖注入文件：

wire ./...

引入 pongservier 服务的 go.mod

咱们要在 pingservice 这个微服务中拜访 pongservice 的 grpc 服务，所以须要导入 pongservice 的 go.mod。

批改 pingservice 目录下的 go.mod 文件，增加导入 pongservice 的代码，如下：

module github.com/janrs-io/Jgrpc/src/pingservice

go 1.19

replace (pongservice => ../pongservice)

require (
    pongservice v0.0.0
    github.com/google/wire v0.5.0
    github.com/grpc-ecosystem/grpc-gateway/v2 v2.15.2
    github.com/spf13/viper v1.15.0
    google.golang.org/grpc v1.54.0
    google.golang.org/protobuf v1.30.0
)

// the other required package...

批改 config.yaml

批改 pingservice/config 目录下的 config.yaml 文件，增加如下代码：

# service client
client:
  pong: ":50051"

批改后的残缺代码如下：

# grpc config
grpc:
  host: ""port:":50052"name:"ping-grpc"

# http config
http:
  host: ""port:":9002"name:"ping-http"

# service client
client:
  pong: ":50051"

生成 client.go

在 pingservice/config 目录下生成 client.go 文件，增加如下代码：

package config

// Client Client service config
type Client struct {Pong string `json:"pong" yaml:"pong"`}

批改 config.go

在 Config 构造体中增加一个 Client 字段，代码如下：

Client Client `json:"client" yaml:"client"`

批改后的残缺代码如下：

package config

import (
    "net/http"

    "github.com/spf13/viper"
    "google.golang.org/grpc"
)

// Config Service config
type Config struct {
    Grpc   Grpc   `json:"grpc" yaml:"grpc"`
    Http   Http   `json:"http" yaml:"http"`
    Client Client `json:"client" yaml:"client"`
}

// NewConfig Initial service's config
func NewConfig(cfg string) *Config {

    if cfg == "" {panic("load config file failed.config file can not be empty.")
    }

    viper.SetConfigFile(cfg)

    // Read config file
    if err := viper.ReadInConfig(); err != nil {panic("read config failed.[ERROR]=>" + err.Error())
    }
    conf := &Config{}
    // Assign the overloaded configuration to the global
    if err := viper.Unmarshal(conf); err != nil {panic("assign config failed.[ERROR]=>" + err.Error())
    }

    return conf

}

// Grpc Grpc server config
type Grpc struct {
    Host   string `json:"host" yaml:"host"`
    Port   string `json:"port" yaml:"port"`
    Name   string `json:"name" yaml:"name"`
    Server *grpc.Server
}

// Http Http server config
type Http struct {
    Host   string `json:"host" yaml:"host"`
    Port   string `json:"port" yaml:"port"`
    Name   string `json:"name" yaml:"name"`
    Server *http.Server
}

批改 client.go

批改 pingservice/service 目录下的 client.go 文件，增加如下代码：

// NewPongClient New pong service client
func NewPongClient(conf *config.Config) (pongclientv1.PongServiceClient, error) {ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()

    conn, err := grpc.DialContext(ctx, conf.Client.Pong, grpc.WithTransportCredentials(insecure.NewCredentials()))
    if err != nil {fmt.Println("dial auth server failed.[ERROR]=>" + err.Error())
        return nil, err
    }
    client := pongclientv1.NewPongServiceClient(conn)
    return client, nil

}

批改后的残缺代码如下：

package service

import (
    "context"
    "fmt"
    "time"

    "google.golang.org/grpc"
    "google.golang.org/grpc/credentials/insecure"

    "github.com/janrs-io/Jgrpc/src/pingservice/config"
    v1 "github.com/janrs-io/Jgrpc/src/pingservice/genproto/v1"
    pongclientv1 "github.com/janrs-io/Jgrpc/src/pongservice/genproto/v1"
)

// NewClient New service's client
func NewClient(conf *config.Config) (v1.PingServiceClient, error) {

    serverAddress := conf.Grpc.Host + conf.Grpc.Port
    ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()

    conn, err := grpc.DialContext(ctx, serverAddress, grpc.WithTransportCredentials(insecure.NewCredentials()))
    if err != nil {return nil, err}
    client := v1.NewPingServiceClient(conn)
    return client, nil

}

// NewPongClient New pong service client
func NewPongClient(conf *config.Config) (pongclientv1.PongServiceClient, error) {ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()

    conn, err := grpc.DialContext(ctx, conf.Client.Pong, grpc.WithTransportCredentials(insecure.NewCredentials()))
    if err != nil {fmt.Println("dial auth server failed.[ERROR]=>" + err.Error())
        return nil, err
    }
    client := pongclientv1.NewPongServiceClient(conn)
    return client, nil

}

批改 server.go

批改 pingservice/service 目录下的 server.go 文件，批改后的残缺代码如下：

package service

import (
    "context"
    "google.golang.org/grpc/grpclog"

    "github.com/janrs-io/Jgrpc/src/pingservice/config"
    v1 "github.com/janrs-io/Jgrpc/src/pingservice/genproto/v1"
    pongclientv1 "github.com/janrs-io/Jgrpc/src/pongservice/genproto/v1"
)

// Server Server struct
type Server struct {
    v1.UnimplementedPingServiceServer
    pingClient v1.PingServiceClient
    pongClient pongclientv1.PongServiceClient
    conf       *config.Config
}

// NewServer New service grpc server
func NewServer(
    conf *config.Config,
    pingClient v1.PingServiceClient,
    pongClient pongclientv1.PongServiceClient,
) v1.PingServiceServer {
    return &Server{
        pingClient: pingClient,
        pongClient: pongClient,
        conf:       conf,
    }
}

func (s *Server) Ping(ctx context.Context, req *v1.PingRequest) (*v1.PingResponse, error) {pongReq := &pongclientv1.PongRequest{Msg: "request from ping service"}
    pongResp, err := s.pongClient.Pong(ctx, pongReq)
    if err != nil {grpclog.Error("connect pong failed.[ERROR]=>" + err.Error())
        return nil, err
    }

    return &v1.PingResponse{Msg: "response ping msg:" + req.Msg + "and msg from pong service is:" + pongResp.Msg,}, nil
}

批改 wire.go

批改 pingservice/cmd/server 的wire.go文件，增加 service.NewPongClient 依赖注入。代码如下：

service.NewPongClient

批改后的残缺代码如下：

//go:build wireinject
// +build wireinject

package server

import (
    "github.com/google/wire"

    "github.com/janrs-io/Jgrpc/src/pingservice/config"
    v1 "github.com/janrs-io/Jgrpc/src/pingservice/genproto/v1"
    "github.com/janrs-io/Jgrpc/src/pingservice/service"
)

// InitServer Inject service's component
func InitServer(conf *config.Config) (v1.PingServiceServer, error) {

    wire.Build(
        service.NewPongClient,
        service.NewClient,
        service.NewServer,
    )

    return &service.Server{}, nil}

在 pingservice 目录下执行以下 wire 命令从新生成依赖注入文件：

如果呈现 go.mod 引入谬误，只需在 pingservice 目录中再次运行 go mod tidy。

wire ./...

启动 service

别离在 pongservice 目录和 pingservice 目录下执行 go run 命令。

go run cmd/main.go

在浏览器中输出以下申请地址：

127.0.01:9002/ping.v1.ping?msg=best practice

所有正确的状况下返回以下 json 数据：

{"msg": "response ping msg:best practice and msg from pong service is: response pong msg:request from ping service"}

总结

这部分咱们新建一个 pingservice 微服务，实现拜访 pongservice 的 grpc 服务。

置信通过这两次创立微服务的简略尝试，你肯定感觉基于 Go 和Grpc开发微服务并不难。

在下一部分中，咱们将利用 Jenkins/Gitlab/Harbor 和 Kubernets/Istio 进行 devops 的 CICD 部署。

转载请注明起源：https://janrs.com/ugj7

退出移动版