docker构建与运行grpc-gateway项目

最新推荐文章于 2024-07-25 15:13:51 发布

dounineli

最新推荐文章于 2024-07-25 15:13:51 发布

阅读量1.2k

点赞数 1

分类专栏：应用与开发文章标签： docker

本文链接：https://blog.csdn.net/CQL_sure/article/details/113354556

版权

应用与开发专栏收录该内容

10 篇文章 1 订阅

订阅专栏

title: docker构建与运行grpc-gateway项目
date: 2020-08-10 17:05:01

文章目录

0. 前言

趁着实习摸鱼（啊不是）之际，简单学习一下曾经很想入门的 docker 。

在上一篇有关 DevOps 的博客中，曾提到：docker 容器的出现，推动了 DevOps 的发展。而 docker 的功劳不仅如此，它的出现可以说是：具有划时代的意义。

很早之前，我就想学习 docker 。但，那时 docker 还未完全支持 Windows 平台，奈何电脑又太差，不敢给 Linux 虚拟机分配太高配置，导致 docker 学习一直被搁置。

如今，docker 已经推出了完美的 Windows 桌面版，而公司电脑配置也完全足够。天时地利人和，此时不学，更待何时。

同时，作为实践，我将用 docker 构建和运行 grpc-gateway 项目。

环境如下：

Docker 版本：v19.03
Go 版本：v1.14

1. 简单介绍 Docker

1.1. Docker 三大组成部分

镜像（image）：用虚拟机安装过操作系统的同学，应该都知道镜像是什么了，它相当于一个只读的光盘，记录着一个简单的Linux，或者一个配置好MySQL环境的操作系统等。拷贝忍者卡卡西用写轮眼看到的忍术，就是一个镜像。
容器（container）：可以看作一个操作系统，它基于镜像启动。卡卡西施展拷贝的忍术，就相当于根据镜像启动一个容器，并且你可以做进一步的改进。
仓库（repository）：用于存放镜像的地方，类似于GitHub，你可以push自己制作的镜像，也可以pull别人的镜像。

1.2. docker 命令

常用的命令示例：

镜像操作：
- docker image ls：显示所有镜像
- docker rmi <image_id>：删除镜像
容器操作：
- docker container run -d --name my-nginx -p 8080:80 nginx:latest：根据 nginx 镜像，启动一个容器（内部包含 docker create、docker start 两步），并后台运行，容器端口80对应本地端口 8080。
  - -d：后台运行容器
  - --name my-nginx：为容器命名，方便后续操作
  - -p 8080:80：指定本地端口与容器端口对应关系
  - nginx:latest：latest 版本的 nginx 镜像
- docker run --rm -it centos:latest bash：根据 centos 镜像，启动一个容器，并执行 bash 程序，同时使用户与容器进行交互，退出容器后删除容器。
  - --rm：退出容器后删除容器
  - -i：开放容器的标准输入
  - -t：为容器分配一个虚拟终端，以便于我们操作
  - bash：进入容器时，执行的程序
- docker ps -a：列出所有容器。
  - -a：包括已停止的容器。
- docker exec -it my-nginx bash：进入 my-nginx 容器，并执行 bash 命令。
Dockerfile 操作：
- docker build --target <stage_name> -t <image_name> .：根据当前目录下的 Dockerfile 构建一个镜像。
  - --target <stage_name>：指定阶段，用于多阶段构建
  - -t <image_name>：构建的镜像名称
  - .：指示当前目录

docker 中很多命令是有相同效果的，比如：docker images == docker image ls、docker rmi == docker image rm、docker ps -a == docker container ls -a等，可自行尝试。

1.3. Dockerfile

Dockerfile 用于构建镜像。镜像既可以通过容器 commit 构建，也可以通过 Dockerfile 构建，但更推荐后者（前者黑盒）。

Dockerfile 常用命令如下：

Dockerfile 编写指南：一般性的指南和建议

2. 用 docker 构建和运行 grpc-gateway 项目

项目地址：https://gitee.com/dounineli/grpcDemo.git

2.1. 编写 Dockerfile

Dockerfile 如下：

FROM golang:1.14 as builder

MAINTAINER dounine

WORKDIR /go/grpcDemo

COPY . /go/grpcDemo

RUN go env -w GO111MODULE=on \
    && go env -w GOPROXY=https://goproxy.cn \
    && echo export PATH="$PATH:$(go env GOPATH)/bin" >> ~/.bashrc

RUN apt-get update\
    && apt install -y protobuf-compiler \
    && go get -u github.com/golang/protobuf/protoc-gen-go \
    && go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway

RUN protoc -I. -I third_party/googleapis/ --go_out=plugins=grpc:. api/helloworld.proto \
    && protoc -I. -I third_party/googleapis/ --grpc-gateway_out=logtostderr=true:. api/helloworld.proto

RUN go build -o Server server/server.go \
    && go build -o Gateway gateway/gateway.go


FROM centos as server

WORKDIR /root

COPY --from=builder /go/grpcDemo/Server .

CMD ["./Server"]

EXPOSE 8081


FROM centos as gateway

WORKDIR /root

COPY --from=builder /go/grpcDemo/Gateway .

CMD ["./Gateway", "--server_addr", "server:8081"]

EXPOSE 8080

利用 Dockerfile 的多阶段构建，减少镜像体积（编译型语言，运行环境不需要复杂的编译环境）。

总共分为三个阶段：

builder 编译阶段，主要用于编译、构建项目，生成 grpc 服务端 Server 和 grpc-gateway 网关 Gateway 两个可执行文件；
server 运行阶段，主要用于运行 builder 阶段生成的 Server 可执行文件；
gateway 运行阶段，主要用于运行 builder 阶段生成的 Gateway 可执行文件。

2.2. 根据 Dockerfile 生成镜像

生成镜像时，我们只需构建 server 和 gateway 两个运行阶段即可，两个阶段依赖的 builder 阶段镜像会自动构建，并在构建完成后自动删除。分别得到 grpc 服务端和 grpc-gateway 网关镜像：

docker build --target server -t <server_image_name> .
docker build --target gateway -t <gateway_image_name> .

2.3. 容器运行

由于 grpc-gateway 网关需要访问 grpc 服务端，因此：

本地运行时，可以创建容器网络，并将两个容器接入网络，则相互之间可通过容器名访问：

docker network create my-net
docker run -d --name server --network my-net -p 8081:8081 <server_image_name>
docker run -d --name gateway --network my-net -p 8080:8080 <gateway_image_name> /root/Gateway --server_addr server:8081

分布式运行时，则需要提供 server 的 IP 地址：

docker run -d --name server -p 8081:8081 <server_image_name>
docker run -d --name gateway -p 8080:8080 <gateway_image_name> /root/Gateway --server_addr <server_ip>:8081