微服务第一部分发布：https://studygolang.com/articles/12060

reviewed/tech/Microservices in Golang/Golang中的微服务-第一章.md → published/tech/Microservices in Golang/Golang中的微服务-第一章.md

@@ -1,8 +1,10 @@
-# Golang中的微服务 - 第一章
+已发布：https://studygolang.com/articles/12060
+
+# Golang 中的微服务 - 第一部分
 
 ## 介绍
 
-Golang中的微服务系列总计十章，预计每周更新。本系列的解决方案采用了 protobuf 和 gRPC 作为底层传输协议。为什么采用这两个技术呢？我花了相当长的时间，才想出并决定采用这个方案。这个方案对开发者来说，非常清晰而简明。我也很乐意把自己在搭建、测试和部署端到端的微服务过程中的心得，分享给想接触这块的朋友们。
+Golang 中的微服务系列总计十部分，预计每周更新。本系列的解决方案采用了 protobuf 和 gRPC 作为底层传输协议。为什么采用这两个技术呢？我花了相当长的时间，才想出并决定采用这个方案。这个方案对开发者来说，非常清晰而简明。我也很乐意把自己在搭建、测试和部署端到端的微服务过程中的心得，分享给想接触这块的朋友们。
 
 在这个教程中，我们将先接触几个基础的概念和术语，然后开始搭建第一个简单的微服务模型。
 
@@ -15,9 +17,9 @@ Golang中的微服务系列总计十章，预计每周更新。本系列的解
 - 角色
 - 容器
 
-整个技术堆从底至顶主要可划分为：golang、mongodb、grpc、docker、Google Cloud、Kubernetes、NATS、CircleCI、Terraform 和 go-micro。
+整个技术栈从底至顶主要可划分为：golang、mongodb、grpc、docker、Google Cloud、Kubernetes、NATS、CircleCI、Terraform 和 go-micro。
 
-接下来，你可以根据我的 [git路径](https://github.com/EwanValentine/shippy) （每篇文章都有自己的分支）中的指导逐步操作，不过必须注意把根据你的开发环境调整 GOPATH 。
+接下来，你可以根据我的 [git 仓库](https://github.com/EwanValentine/shippy)（每篇文章都有自己的分支）中的指导逐步操作，不过必须注意把根据你的开发环境调整 GOPATH 。
 
 同时你需要注意，我是在 Macbook 上开发的，你或许会需要替换 Makefiles 中的 `$(GOPATH)` 为 `$GOPATH` 。操作系统不一致带来的问题可能不止这一个，但这里就不一一列举了。
 
@@ -59,7 +61,7 @@ go get -u github.com/golang/protobuf/protoc-gen-go
 
 几乎所有的语言都支持微服务。微服务不是一个具体的框架或工具，而是一个概念。这就意味着，在选择构建微服务的语言中，总有一些更为合适、或者说支持性更好。Golang 就是其中的佼佼者。
 
-Golang 是一个轻量级、运行速度快、对高并发支持性极好的语言，很有力地支持了多核、多设备运行的场景。
+Golang 是一个轻量级、运行速度快、对高并发支持极好的语言，很有力地支持了多核、多设备运行的场景。
 
 Golang 在网络服务上，也具有强大的标准库。
 
@@ -69,15 +71,15 @@ Golang 在网络服务上，也具有强大的标准库。
 
 微服务被分割成多个独立的代码库，这就带来了一个重要的问题 —— 通信。在单体应用的系统中，你可以在代码库的任何地方调用想要的代码，所以不存在通信的问题。而微服务分布在不同的代码库中，不具备直接调用的能力。所以，你需要找到一个途径，使得不同服务之间可以尽可能低延迟地进行数据交互。
 
-这里，我们可以采用传统的 REST 架构，例如通过 http 传输 JSON 或者 XML 。但这种方案会带来了一个问题：服务 A 把原始数据编码成 JSON/XML 格式，发送一长串字符给服务 B，B通过解码还原成原始数据。不过，当原始数据量很大时，这可能对通信造成严重影响。当我们和网络浏览器的通信时，只要约定了服务间的通信方式、固定了编码和解码方法，那么格式可以任意。
+这里，我们可以采用传统的 REST 架构，例如通过 http 传输 JSON 或者 XML 。但这种方案会带来了一个问题：服务 A 把原始数据编码成 JSON/XML 格式，发送一长串字符给服务 B，B 通过解码还原成原始数据。不过，当原始数据量很大时，这可能对通信造成严重影响。当我们和网络浏览器的通信时，只要约定了服务间的通信方式、固定了编码和解码方法，那么格式可以任意。
 
-[gRPC](https://grpc.io/)就应运而生。gRPC 是一个由 Google 开发、基于 RPC 通信、轻量级的二进制传输协议。这个定义有点复杂，下面请由我细细道来。gRPC 核心数据格式采用的是二进制，而在上面 RESTful 的例子中，我们用的是 JSON 格式，也就是通过 http 发送一串字符串。字符串包括了它的编码格式、长度和其它占用字节的信息，所以总体数据量很大。基于客户端的字符串数据，服务器可以通知传统的浏览器，解析得到预期的数据。但在两个微服务的通信间，我们不需要字符串中的所有数据，所以我们采用难理解但更加轻量的二进制数据的二进制数据进行交互。gRPC 采用的是支持二进制数据的 HTTP 2.0 规范，这个规范还能支持双向的通信流，相当炫酷！HTTP 2 是 gRPC 工作的基础。如果你想进一步了解 HTTP 2，可以点击这个[Google链接](https://developers.google.com/web/fundamentals/performance/http2/)。
+[gRPC](https://grpc.io/) 就应运而生。gRPC 是一个由 Google 开发、基于 RPC 通信、轻量级的二进制传输协议。这个定义有点复杂，下面请由我细细道来。gRPC 核心数据格式采用的是二进制，而在上面 RESTful 的例子中，我们用的是 JSON 格式，也就是通过 http 发送一串字符串。字符串包括了它的编码格式、长度和其它占用字节的信息，所以总体数据量很大。基于客户端的字符串数据，服务器可以通知传统的浏览器，解析得到预期的数据。但在两个微服务的通信间，我们不需要字符串中的所有数据，所以我们采用难理解但更加轻量的二进制数据进行交互。gRPC 采用的是支持二进制数据的 HTTP 2.0 规范，这个规范还能支持双向的通信流，相当炫酷！HTTP 2 是 gRPC 工作的基础。如果你想进一步了解 HTTP 2，可以点击这个[Google 链接](https://developers.google.com/web/fundamentals/performance/http2/)。
 
 接下来的问题是，二进制数据该如何处理呢？不用担心，gRPC 有一个内部的数字模拟语言，叫 protobuf。Protobuf 支持自定义接口格式，对开发者很友好。
 
 了解 gRPC 和 protobuf，我们准备实战，开始创建第一个服务的定义。首先，在代码库的根目录下创建如下文件 `consignment-service/proto/consignment/consignment.proto`。目前，为了让这个教程阅读起来更容易，我采用的是单一仓，就是把所有的服务都存放在一个代码库中。对使用单一仓很多争论和反对意见，这边我暂不深入探讨。当然，你在开发中最好把不同的服务和部件存放在分离的代码仓中，这种方式普遍受欢迎，但比较复杂。
 
-在刚才创建的`consignment.proto`文件中，添加如下内容：
+在刚才创建的 `consignment.proto` 文件中，添加如下内容：
 
 ```protobuf
 // consignment-service/proto/consignment/consignment.proto
@@ -110,23 +112,23 @@ message Response {
 }
 ```
 
-这是个非常基础的定义的例子，不过还是有几点需要我们掌握。首先，你定义了服务内容，它应该包括你希望暴露给其他服务的方法。接着，你需要定义消息类型，这些数据结构体都非常简洁。正如上面的`Container`结构体，Protobuf 是一种可以自定义的静态类型。每个消息体都是他们自定义的类型。
+这是个非常基础的定义的例子，不过还是有几点需要我们掌握。首先，你定义了服务内容，它应该包括你希望暴露给其他服务的方法。接着，你需要定义消息类型，这些数据结构体都非常简洁。正如上面的 `Container` 结构体，Protobuf 是一种可以自定义的静态类型。每个消息体都是他们自定义的类型。
 
-现在已经使用到了两个库：消息通过 protobuf 处理；服务通过 gRPC 的 protobuf 插件处理，把消息编译成代码，从而进行交互，正如 proto 文件中的`service`部分。
+现在已经使用到了两个库：消息通过 protobuf 处理；服务通过 gRPC 的 protobuf 插件处理，把消息编译成代码，从而进行交互，正如 proto 文件中的 `service` 部分。
 
 protobuf 定义的结构，可以通过客户端接口，自动生成相应语言的二进制数据和功能。
 
-说到这，我们就来一起给我们的服务创建一个 Makefile，路径如下`$ touch consignment-service/Makefile`。
+说到这，我们就来一起给我们的服务创建一个 Makefile，路径如下 `$ touch consignment-service/Makefile`。
 
 ```makefile
-build:  
+build:
     protoc -I. --go_out=plugins=grpc:$(GOPATH)/src/github.com/ewanvalentine/shipper/consignment-service \
       proto/consignment/consignment.proto
 ```
 
 这个 Makefile 会调用 protoc 库，将你的 protobuf 编译成对应的代码。同时，我们也指定了 gRPC 插件、编译目录和输出目录。
 
-生成 Makefile 文件后，进入服务所在的文件夹，运行`$ make build`指令，然后你就能在`proto/consignment/`下看到一个名为`consignment.pb.go`的新 Go 文件。这里使用了 gRPC/protobuf 库，把自定义的 protobuf 结构自动转换成你想要的代码。
+生成 Makefile 文件后，进入服务所在的文件夹，运行 `$ make build` 指令，然后你就能在 `proto/consignment/` 下看到一个名为 `consignment.pb.go` 的新 Go 文件。这里使用了 gRPC/protobuf 库，把自定义的 protobuf 结构自动转换成你想要的代码。
 
 接下来，我们就可以正式搭建服务了。进入项目的根目录，创建一个文件 main.go `$ touch consignment-service/main.go`。
 
@@ -138,7 +140,7 @@ import (
     "log"
     "net"
 
-        // 导入生成的 protobuf 代码
+    // 导入生成的 protobuf 代码
     pb "github.com/ewanvalentine/shipper/consignment-service/proto/consignment"
     "golang.org/x/net/context"
     "google.golang.org/grpc"
@@ -187,14 +189,14 @@ func main() {
 
     repo := &Repository{}
 
-        // 启动 gRPC 服务器。
+    // 启动 gRPC 服务器。
     lis, err := net.Listen("tcp", port)
     if err != nil {
         log.Fatalf("failed to listen: %v", err)
     }
     s := grpc.NewServer()
 
-	//注册服务到 gRPC 服务器，会把已定义的 protobuf 与自动生成的代码接口进行绑定。
+    // 注册服务到 gRPC 服务器，会把已定义的 protobuf 与自动生成的代码接口进行绑定。
     pb.RegisterShippingServiceServer(s, &service{repo})
 
     // 在 gRPC 服务器上注册 reflection 服务。
@@ -205,11 +207,11 @@ func main() {
 }
 ```
 
-请仔细阅读代码中的注释，有助于你对这个服务的理解。简单来说，这些代码实现的功能是：在 50051 端口创建一个的 gRPC 服务器，通过 protobuf 生成的消息格式，实现 gRPC 接口交互的逻辑。就这样，你完成了一个完整功能的 gRPC 服务！你可以输入指令`$ go run main.go`来运行这个程序，不过，目前，从界面上你还看不到任何东西。那如何能直观看到这个 gRPC 服务器正常工作了呢？我们来一起创建个与它对接的客户端吧！
+请仔细阅读代码中的注释，有助于你对这个服务的理解。简单来说，这些代码实现的功能是：在 50051 端口创建一个的 gRPC 服务器，通过 protobuf 生成的消息格式，实现 gRPC 接口交互的逻辑。就这样，你完成了一个完整功能的 gRPC 服务！你可以输入指令 `$ go run main.go` 来运行这个程序，不过，目前，从界面上你还看不到任何东西。那如何能直观看到这个 gRPC 服务器正常工作了呢？我们来一起创建个与它对接的客户端吧！
 
 下面，我们来写一个命令行交互的程序，用来读取一个包含委托信息的 JSON 文件，和我们已创建的 gRPC 服务器交互。
 
-进入根目录，输入命令行创建一个新的子文件夹`$ mkdir consignment-cli`。在文件夹中，创建一个新文件`cli.go`，代码如下：
+进入根目录，输入命令行创建一个新的子文件夹 `$ mkdir consignment-cli`。在文件夹中，创建一个新文件 `cli.go`，代码如下：
 
 ```go
 // consignment-cli/cli.go
@@ -283,9 +285,9 @@ func main() {
 }
 ```
 
-完成以上步骤后，在`consignment-service`下运行`$ go run main.go`，然后打开一个新的终端界面，运行`$ go run cli.go`，这时你就能看到一条消息`Created: true`。不过，如何我们才能确认，这个委托真正地生成了？让我们继续更新我们的服务，添加一个`GetConsignments`方法，能够看到所有已创建的委托。
+完成以上步骤后，在 `consignment-service` 下运行 `$ go run main.go`，然后打开一个新的终端界面，运行 `$ go run cli.go`，这时你就能看到一条消息 `Created: true`。不过，如何我们才能确认，这个委托真正地生成了？让我们继续更新我们的服务，添加一个 `GetConsignments` 方法，能够看到所有已创建的委托。
 
-首先需要更新我们的 proto 定义(我在修改部分添加了备注)
+首先需要更新我们的 proto 定义（我在修改部分添加了备注）
 
 ```protobuf
 // consignment-service/proto/consignment/consignment.proto
@@ -327,13 +329,13 @@ message Response {
 }
 ```
 
-我们成功地在服务上创建了一个叫`GetConsignments`和`GetRequest`的新方法，后者目前不含任何内容。我们也在回复的消息中，添加了`consignments`参数。你可能会注意到，该参数的类型前有个关键词：`repeated`。顾名思义，这代表该参数是以数组的方式保存的。
+我们成功地在服务上创建了一个叫 `GetConsignments` 和 `GetRequest` 的新方法，后者目前不含任何内容。我们也在回复的消息中，添加了 `consignments` 参数。你可能会注意到，该参数的类型前有个关键词：`repeated`。顾名思义，这代表该参数是以数组的方式保存的。
 
-现在，让我们再次运行`$ make build`指令，并启动你的服务，你会看到一个类似`*service does not implement go_micro_srv_consignment.ShippingServiceServer (missing GetConsignments method)`的错误信息。
+现在，让我们再次运行 `$ make build` 指令，并启动你的服务，你会看到一个类似 `*service does not implement go_micro_srv_consignment.ShippingServiceServer (missing GetConsignments method)` 的错误信息。
 
 protobuf 库产生的接口在通信两端必须完全匹配，这是实现 gRPC 的基础。所以，我们需要确认 proto 的定义是否一致。
 
-让我们更新下`consignment-service/main.go`文件：
+让我们更新下 `consignment-service/main.go` 文件：
 
 ```go
 package main
@@ -419,12 +421,12 @@ func main() {
 }
 ```
 
-现在，我们引用了新的`GetConsignments`方法、更新了库和接口，也就满足了两边的 proto 定义一致。再次运行` go run main.go`后，服务能正常工作了。
+现在，我们引用了新的 `GetConsignments` 方法、更新了库和接口，也就满足了两边的 proto 定义一致。再次运行 `go run main.go` 后，服务能正常工作了。
 
-再回到我们的客户端工具，我们通过调用`GetConsignments`这个方法，列出所有的委托：
+再回到我们的客户端工具，我们通过调用 `GetConsignments` 这个方法，列出所有的委托：
 
 ```go
-func main() {  
+func main() {
     ... 
     // ·...`表示和之前代码一致，这里不再重复
 
@@ -438,17 +440,17 @@ func main() {
 }
 ```
 
-在原先 main 函数中，找到打印`Created: success`日志的位置，在这之后添加上述代码，然后运行`$ go run cli.go`。程序就会创建一个委托，紧接着调用`GetConsignments`。当你运行次数越多，委托列表就会越来越长。
+在原先 main 函数中，找到打印 `Created: success` 日志的位置，在这之后添加上述代码，然后运行 `$ go run cli.go`。程序就会创建一个委托，紧接着调用 `GetConsignments`。当你运行次数越多，委托列表就会越来越长。
 
-*注意：为了看起来简洁，我有时会用`...`来表示和之前的代码完全一致。之后几行新增的代码，需要手动添加到原代码中*
+*注意：为了看起来简洁，我有时会用 `...` 来表示和之前的代码完全一致。之后几行新增的代码，需要手动添加到原代码中*
 
 到这里，我们通过 protobuf 和 gRPC，完整地创建了一个微服务，以及一个与之交互的客户端。
 
-本系列的下一章节将围绕着集成[go-micro](https://github.com/micro/go-micro)展开。go-micro 是一个基于微服务的、创建 gRPC 的强大框架。我们也会在下章创建第二个微服务 —— 容器服务。光说“容器”二字也许会令你困惑，这里具体指的是 Docker 中的“容器”概念。我们会在下一章探索微服务在 Docker 容器中的运行情况。
+本系列的下一章节将围绕着集成 [go-micro](https://github.com/micro/go-micro) 展开。go-micro 是一个基于微服务的、创建 gRPC 的强大框架。我们也会在下章创建第二个微服务 —— 容器服务。光说“容器”二字也许会令你困惑，这里具体指的是 Docker 中的“容器”概念。我们会在下一章探索微服务在 Docker 容器中的运行情况。
 
-如果对此文有任何 bug、错误或者反馈，请直接联系[我的邮箱]([email protected])。
+如果对此文有任何 bug、错误或者反馈，请直接邮箱[联系我]([email protected])。
 
-本教程所包含的代码库[链接](https://github.com/ewanvalentine/shippy)，用 `git`工具 checkout 分支`tutorial-1`第一章。第二章也将在近期更新。
+本教程所包含的代码库[链接](https://github.com/ewanvalentine/shippy)，用 `git` 工具 checkout 分支`tutorial-1` 第一章。第二章也将在近期更新。
 
 编写本文花了我很长的时间以及大量的精力。如果你觉得这个系列有帮助，请考虑顺手打赏我(完全取决于你的意愿)。十分感谢！[https://monzo.me/ewanvalentine](https://monzo.me/ewanvalentine)