服务与API分离

在开篇前头，我们已经明确过，用户服务与用户API的用途与关系，用户服务是基于内网调用不对外暴露的，用户API是暴露到外网提供给外部访问的，用户API的实际用途可以归结为以下几点。

  • 作为用户服务的客户端，提供对外访问路由，提高系统安全性
  • 作为中间层，对web客户端提交信息进行验证过滤。
  • 作为中间层，基于限流熔断等机制，控制访问流量。

    初始化项目

    1. mkdir user-api
    2. cd user-api
    3. go mod init github.com/869413421/micro-service/user-api
    4. go get -u github.com/gin-gonic/gin

    编写web服务注册代码

    1. touch main.go
    ``` package main

import ( “github.com/micro/go-micro/v2/web” “log” “time” )

func main() { var serviceName = “micro.api.user” service := web.NewService( web.Name(serviceName), web.Address(“:81”), // 指定服务注册信息在注册中心的有效期。 默认为一分种 web.RegisterTTL(time.Minute2), // 指定服务主动向注册中心报告健康状态的时间间隔,默认为 30 秒。 web.RegisterInterval(time.Minute1), )

  1. err := service.Init()
  2. if err != nil {
  3.     log.Fatal("Init api error:", err)
  4. }
  5. err = service.Run()
  6. if err != nil {
  7.     log.Fatal("start api error:", err)
  8.     return
  9. }

}

  1. 执行`go mod tidy` 下载相关依赖
  2. <a name="mmRqd"></a>
  3. ## 编写dockerfile
  4. :::warning
  5. 因为gin依赖的包和低版本golang有冲突，修改为1.16
  6. :::

touch Dockerfile

  1. ```
  2. # user-api/Dockerfile
  4. # 使用golang官方镜像，并命名为builder
  5. FROM golang:1.16-alpine as builder
  7. # 启用go Modules
  8. ENV GO111MODULE on
  10. # 设置工作目录
  11. WORKDIR /app/micro-user-api
  13. # 将目录中代码拷贝到镜像中
  14. COPY . .
  16. # 下载依赖，
  17. RUN  go env -w GOPROXY=https://mirrors.aliyun.com/goproxy,direct && go mod tidy
  19. # 构建二进制文件，添加一些额外参数方便在alpin中运行它
  20. RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o micro-user-api
  22. # 第二阶段构造
  23. FROM alpine:latest
  25. # 更新依赖软件
  26. RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories && \
  27.     apk update && \
  28.     apk add --no-cache bash ca-certificates &&\
  29.     apk add curl
  31. # 和上个阶段一样设置工作目录
  32. RUN mkdir /app
  33. WORKDIR /app
  35. # 这一步不再从宿主机拷贝二进制文件，而是从上一个阶段构建的 builder 容器中拉取
  36. COPY --from=builder /app/micro-user-api/micro-user-api .
  38. # 启动用户API服务
  39. CMD ["./micro-user-api"]

编写makefile

  1. touch Makefile
  2. GOPATH:=$(shell go env GOPATH)
  4. .PHONY: build
  5. build:
  6.      CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -ldflags '-w' -i -o micro-user-api ./main.go
  8. .PHONY: test
  9. test:
  10.     go test -v ./... -cover
  12. .PHONY: docker
  13. docker:
  14.     docker build . -t micro-user-api:latest

执行make build编译二进制文件，方便测试

修改docker-compose.yaml

  1. ...
  3.   micro-user-api:
  4.     build: ./user-api
  5.     depends_on:
  6.       - micro-user-service
  7.     volumes:
  8.       - ./user-api:/app
  9.     ports:
  10.       - 81:81
  11.     environment:
  12.       MICRO_REGISTRY: "etcd"
  13.       MICRO_REGISTRY_ADDRESS: "etcd1:2379,etcd2:2379,etcd3:2379"
  14.     networks:
  15.       - micro-network
  17.  ...

到项目主目录下执行docker-compose up micro-user-api启动容器

检查服务是否正常启动

image.png
打开http://127.0.0.1:8082/services
image.png
可以看到看到api服务已经注册