【预览目录】go-zero必知必会

go-zero必知必会

服务注册发现

一、服务注册发现分类

【说明】:其他服务发现方式看https://github.com/zeromicro/...官方demo，其中yaml中，etcd、IP直连、k8s三种配置文件也不是统一的

默认方式etcd

1. api配置文件

#gateway-api.yaml
#api服务发现配置模块
AdminRpc:
  Timeout: 10000
  Etcd:
    Hosts:
      - 127.0.0.1:2379
    Key: admin.rpc

2. rpc配置文件

#admin.yaml
Name: admin.rpc
ListenOn: 127.0.0.1:8080
#rpc服务发现配置模块
Etcd:
  Hosts:
  - 127.0.0.1:2379
  Key: admin.rpc

kubernetes

【说明】:推荐使用k8s方式部署对应应用，这样可以减少维护一套etcd集群。

1.api配置文件

#gateway-api.yaml
#api服务发现配置模块
AdminRpc:
  Timeout: 10000
  Endpoints:
    - 127.0.0.1:39511

2.rpc配置文件

#admin.yaml
Name: admin.rpc
ListenOn: 127.0.0.1:8080
#rpc服务发现配置模块,不需要配置

IP直连

1.api配置文件

#gateway-api.yaml
#api服务发现配置模块
AdminRpc:
  Timeout: 10000
  Endpoints:
    - 127.0.0.1:39511

2.rpc配置文件

#admin.yaml
Name: admin.rpc
ListenOn: 127.0.0.1:8080
#rpc服务发现配置模块,不需要配置

consul

nacos

polaris

二、框架组件

(一)、Api定义

(二)、项目配置

1. rest.RestConf配置

   配置结构体

   RestConf struct {
       service.ServiceConf
       Host     string `json:",default=0.0.0.0"`
       Port     int
       CertFile string `json:",optional"`
       KeyFile  string `json:",optional"`
       Verbose  bool   `json:",optional"`
       MaxConns int    `json:",default=10000"`
       MaxBytes int64  `json:",default=1048576"`
       // milliseconds
       Timeout      int64         `json:",default=3000"`
       CpuThreshold int64         `json:",default=900,range=[0:1000]"`
       Signature    SignatureConf `json:",optional"`
   }
   //成员service.ServiceConf
   type ServiceConf struct {
       Name       string
       Log        logx.LogConf
       Mode       string            `json:",default=pro,options=dev|test|rt|pre|pro"`
       MetricsUrl string            `json:",optional"`
       Prometheus prometheus.Config `json:",optional"`
       Telemetry  trace.Config      `json:",optional"`
   }
   
   //成员Signature
   SignatureConf struct {
       Strict      bool          `json:",default=false"`
       Expiry      time.Duration `json:",default=1h"`
       PrivateKeys []PrivateKeyConf
   }
   

   第1步:在internal/config/config.go新增配置文件

   【说明】:当前配置理论上只会存在于api模块中。

   package config
   
   import (
       "github.com/zeromicro/go-zero/rest"
   )
   
   type Config struct {
       rest.RestConf  
   }

   第2步:在YAML文件配置完整版本:

   Name: gateway-api   #ServiceConf.Name
   Host: 0.0.0.0        #RestConf.Host
   Port: 9510            #RestConf.Port
   Mysql:
     Datasource: root:123456@tcp(127.0.0.1:3306)/admin?charset=utf8mb4&parseTime=true&loc=Asia%2FShanghai
   AdminRpc:
     Timeout: 10000
     Etcd:
       Hosts:
         - 127.0.0.1:2379
       Key: admin.rpc

2. zrpc.RpcClientConf配置

3. zrpc.RpcServerConf配置

4. 数据源Mysql配置

5. Auth权限配置

6. Redis缓存cache.CacheConf配置

7. Redis数据库配置

8. 其他自定义扩展配置

(三)、序列化.

• form
• json
• protobuf
• xml
• yaml

(四)、错误处理.

(五)、日志.

(六)、元信息传递.

(七)、head请求头信息传递.

(八)、路由负载均衡.

(九)、中间件.

(十)、传输协议.

(十一)、model不定参数查询、中间件context传值、配置文件详解、SSL证书、ETCD证书、参数验证

(十二)、传输协议

(十三)、分布式事务

(十四)、接口限流和超时设置、协程方式使用

(十五)、生产环境选择方案

1. Docker模式+ETCD集群/单体【注释:vpc+slb】
2. 守护进程+ETCD集群/单体
3. k8s集群