首页手记基于Go/Grpc/kubernetes/Istio开...

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

标签：

Go 架构 Kubernetes

在上一部分中，我们创建了微服务的目录结构并实现了微服务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

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

码仔janrs_com

软件工程师

手记
篇

粉丝

0

获赞与收藏

0

关注作者，订阅最新文章

阅读免费教程

Go 入门教程

47个小节 69313 657

Django 入门教程

37个小节 31504 332

MySQL 进阶教程

32个小节 52994 996

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空

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

项目结构

开始

复制

删除 wire_gen.go

修改 go.mod module

生成 proto

修改 import 路径和所有代码

修改 config.yaml

生成 generate inject

引入 pongservier 服务的 go.mod

修改 config.yaml

生成 client.go

修改 config.go

修改 client.go

修改 server.go

修改 wire.go

启动 service

总结

阅读免费教程