Gin实践连载九将Golang应用部署到Docker

时间 2019-11-06

标签 gin 实践连载 golang 应用部署 docker 栏目 Go 繁體版

原文原文链接

项目地址：https://github.com/EDDYCJY/go... （快上车，支持一波）
原文地址：将Golang应用部署到Dockerhtml

注：mysql

开始前你须要安装好 docker，配好镜像源
本章节源码在 f-20180324-docker 分支上
从本章节开始项目目录都以 go-gin-example 为基准（请配合本身本地项目灵活变更）

介绍

在这里简单介绍下Docker，建议深刻学习linux

Docker 是一个开源的轻量级容器技术，让开发者能够打包他们的应用以及应用运行的上下文环境到一个可移植的镜像中，而后发布到任何支持Docker的系统上运行。经过容器技术，在几乎没有性能开销的状况下，Docker 为应用提供了一个隔离运行环境git

简化配置
代码流水线管理
提升开发效率
隔离应用
快速、持续部署

接下来咱们正式开始对项目进行 docker 的所需处理和编写，每个大标题为步骤大纲github

Golang

1、编写Dockerfile

在 go-gin-example 项目根目录建立 Dockerfile 文件，写入内容golang

FROM golang:latest

WORKDIR $GOPATH/src/github.com/EDDYCJY/go-gin-example
COPY . $GOPATH/src/github.com/EDDYCJY/go-gin-example
RUN go build .

EXPOSE 8000
ENTRYPOINT ["./go-gin-example"]

做用

golang:latest 镜像为基础镜像，将工做目录设置为 $GOPATH/src/go-gin-example，并将当前上下文目录的内容复制到 $GOPATH/src/go-gin-example 中sql

在进行 go build 编译完毕后，将容器启动程序设置为 ./go-gin-example，也就是咱们所编译的可执行文件 docker

注意 go-gin-example 在 docker 容器里编译，并无在宿主机现场编译shell

说明

Dockerfile 文件是用于定义 Docker 镜像生成流程的配置文件，文件内容是一条条指令，每一条指令构建一层，所以每一条指令的内容，就是描述该层应当如何构建；这些指令应用于基础镜像并最终建立一个新的镜像数据库

你能够认为用于快速建立自定义的 Docker 镜像

一、 FROM

指定基础镜像（必须有的指令，而且必须是第一条指令）

二、 WORKDIR

格式为 WORKDIR <工做目录路径>

使用 WORKDIR 指令能够来指定工做目录（或者称为当前目录），之后各层的当前目录就被改成指定的目录，若是目录不存在，WORKDIR 会帮你创建目录

三、COPY

格式：

COPY <源路径>... <目标路径>
COPY ["<源路径1>",... "<目标路径>"]

COPY 指令将从构建上下文目录中 <源路径> 的文件/目录复制到新的一层的镜像内的 <目标路径> 位置

四、RUN

用于执行命令行命令

格式：RUN <命令>

五、EXPOSE

格式为 EXPOSE <端口1> [<端口2>...]

EXPOSE 指令是声明运行时容器提供服务端口，这只是一个声明，在运行时并不会由于这个声明应用就会开启这个端口的服务

在 Dockerfile 中写入这样的声明有两个好处

帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射
运行时使用随机端口映射时，也就是 docker run -P 时，会自动随机映射 EXPOSE 的端口

六、ENTRYPOINT

ENTRYPOINT 的格式和 RUN 指令格式同样，分为两种格式

exec 格式：

<ENTRYPOINT> "<CMD>"

shell 格式：

ENTRYPOINT [ "curl", "-s", "http://ip.cn" ]

ENTRYPOINT 指令是指定容器启动程序及参数

2、构建镜像

go-gin-example 的项目根目录下执行 docker build -t gin-blog-docker .

该命令做用是建立/构建镜像，-t 指定名称为 gin-blog-docker，. 构建内容为当前上下文目录

$ docker build -t gin-blog-docker .
Sending build context to Docker daemon 96.39 MB
Step 1/6 : FROM golang:latest
 ---> d632bbfe5767
Step 2/6 : WORKDIR $GOPATH/src/github.com/EDDYCJY/go-gin-example
 ---> 56294f978c5d
Removing intermediate container e112997b995d
Step 3/6 : COPY . $GOPATH/src/github.com/EDDYCJY/go-gin-example
 ---> 3b60960120cf
Removing intermediate container 63e310b3f60c
Step 4/6 : RUN go build .
 ---> Running in 52648a431450

 ---> 7bfbeb301fea
Removing intermediate container 52648a431450
Step 5/6 : EXPOSE 8000
 ---> Running in 98f5b387d1bb
 ---> b65bd4076c65
Removing intermediate container 98f5b387d1bb
Step 6/6 : ENTRYPOINT ./go-gin-example
 ---> Running in c4f6cdeb667b
 ---> d8a109c7697c
Removing intermediate container c4f6cdeb667b
Successfully built d8a109c7697c

3、验证镜像

查看全部的镜像，肯定刚刚构建的 gin-blog-docker 镜像是否存在

$ docker images
REPOSITORY              TAG                 IMAGE ID            CREATED              SIZE
gin-blog-docker         latest              d8a109c7697c        About a minute ago   946 MB
docker.io/golang        latest              d632bbfe5767        8 days ago           779 MB
...

4、建立并运行一个新容器

执行命令 docker run -p 8000:8000 gin-blog-docker

$ docker run -p 8000:8000 gin-blog-docker
dial tcp 127.0.0.1:3306: connect: connection refused
[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:    export GIN_MODE=release
 - using code:    gin.SetMode(gin.ReleaseMode)

...
Actual pid is 1

运行成功，你觉得大功告成了吗？

你想太多了，仔细看看控制台的输出了一条错误 dial tcp 127.0.0.1:3306: connect: connection refused

咱们研判一下，发现是 Mysql 的问题，接下来第二项咱们将解决这个问题

Mysql

1、拉取镜像

从 Docker 的公共仓库 Dockerhub 下载 MySQL 镜像（国内建议配个镜像）

$ docker pull mysql

2、建立并运行一个新容器

运行 Mysql 容器，并设置执行成功后返回容器ID

$ docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=rootroot -d mysql
8c86ac986da4922492934b6fe074254c9165b8ee3e184d29865921b0fef29e64

链接 Mysql

初始化的 Mysql 应该如图

Golang + Mysql

1、删除镜像

因为本来的镜像存在问题，咱们须要删除它，此处有几种作法

删除本来有问题的镜像，从新构建一个新镜像
从新构建一个不一样 name、tag 的新镜像

删除本来的有问题的镜像，-f 是强制删除及其关联状态

若不执行 -f，你须要执行 docker ps -a 查到所关联的容器，将其 rm 解除二者依赖关系

$ docker rmi -f gin-blog-docker
Untagged: gin-blog-docker:latest
Deleted: sha256:d8a109c7697c3c2d9b4de7dbb49669d10106902122817b6467a031706bc52ab4
Deleted: sha256:b65bd4076c65a3c24029ca4def3b3f37001ff7c9eca09e2590c4d29e1e23dce5
Deleted: sha256:7bfbeb301fea9d8912a4b7c43e4bb8b69bdc57f0b416b372bfb6510e476a7dee
Deleted: sha256:3b60960120cf619181c1762cdc1b8ce318b8c815e056659809252dd321bcb642
Deleted: sha256:56294f978c5dfcfa4afa8ad033fd76b755b7ecb5237c6829550741a4d2ce10bc

2、修改配置文件

将项目的配置文件 conf/app.ini，内容修改成

#debug or release
RUN_MODE = debug

[app]
PAGE_SIZE = 10
JWT_SECRET = 233

[server]
HTTP_PORT = 8000
READ_TIMEOUT = 60
WRITE_TIMEOUT = 60

[database]
TYPE = mysql
USER = root
PASSWORD = rootroot
HOST = mysql:3306
NAME = blog
TABLE_PREFIX = blog_

3、从新构建镜像

重复先前的步骤，回到 gin-blog 的项目根目录下执行 docker build -t gin-blog-docker .

4、建立并运行一个新容器

关联

Q：咱们须要将 Golang 容器和 Mysql 容器关联起来，那么咱们须要怎么作呢？

A：增长命令 --link mysql:mysql 让 Golang 容器与 Mysql 容器互联；经过 --link，能够在容器内直接使用其关联的容器别名进行访问，而不经过IP，可是--link只能解决单机容器间的关联，在分布式多机的状况下，须要经过别的方式进行链接

运行

执行命令 docker run --link mysql:mysql -p 8000:8000 gin-blog-docker

$ docker run --link mysql:mysql -p 8000:8000 gin-blog-docker
[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:    export GIN_MODE=release
 - using code:    gin.SetMode(gin.ReleaseMode)
...
Actual pid is 1

结果

检查启动输出、接口测试、数据库内数据，均正常；咱们的 Golang 容器和 Mysql 容器成功关联运行，大功告成 :)

Review

思考

虽然应用已经可以跑起来了

但若是对 Golang 和 Docker 有必定的了解，我但愿你可以想到至少2个问题

为何 gin-blog-docker 占用空间这么大？（可用 docker ps -as | grep gin-blog-docker 查看）
Mysql 容器直接这么使用，数据存储到哪里去了？

建立超小的Golang镜像

Q：第一个问题，为何这么镜像体积这么大？

A：FROM golang:latest 拉取的是官方 golang 镜像，包含Golang的编译和运行环境，外加一堆GCC、build工具，至关齐全

这是有问题的，咱们能够不在Golang容器中现场编译的，压根用不到那些东西，咱们只须要一个可以运行可执行文件的环境便可

构建Scratch镜像

Scratch镜像，简洁、小巧，基本是个空镜像

1、修改Dockerfile

FROM scratch

WORKDIR $GOPATH/src/github.com/EDDYCJY/go-gin-example
COPY . $GOPATH/src/github.com/EDDYCJY/go-gin-example

EXPOSE 8000
CMD ["./go-gin-example"]

2、编译可执行文件

CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o go-gin-example .

编译所生成的可执行文件会依赖一些库，而且是动态连接。在这里由于使用的是 scratch 镜像，它是空镜像，所以咱们须要将生成的可执行文件静态连接所依赖的库

3、构建镜像

$ docker build -t gin-blog-docker-scratch .
Sending build context to Docker daemon 133.1 MB
Step 1/5 : FROM scratch
 ---> 
Step 2/5 : WORKDIR $GOPATH/src/github.com/EDDYCJY/go-gin-example
 ---> Using cache
 ---> ee07e166a638
Step 3/5 : COPY . $GOPATH/src/github.com/EDDYCJY/go-gin-example
 ---> 1489a0693d51
Removing intermediate container e3e9efc0fe4d
Step 4/5 : EXPOSE 8000
 ---> Running in b5630de5544a
 ---> 6993e9f8c944
Removing intermediate container b5630de5544a
Step 5/5 : CMD ./go-gin-example
 ---> Running in eebc0d8628ae
 ---> 5310bebeb86a
Removing intermediate container eebc0d8628ae
Successfully built 5310bebeb86a

注意，假设你的Golang应用没有依赖任何的配置等文件，是能够直接把可执行文件给拷贝进去便可，其余都没必要关心

这里能够有好几种解决方案

依赖文件统一管理挂载
go-bindata 一下

...

所以这里若是解决了文件依赖的问题后，就不须要把目录给 COPY 进去了

4、运行

$ docker run --link mysql:mysql -p 8000:8000 gin-blog-docker-scratch
[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:    export GIN_MODE=release
 - using code:    gin.SetMode(gin.ReleaseMode)

[GIN-debug] GET    /auth                     --> github.com/EDDYCJY/go-gin-example/routers/api.GetAuth (3 handlers)
...

成功运行，程序也正常接收请求

接下来咱们再看看占用大小，执行 docker ps -as 命令

$ docker ps -as
CONTAINER ID        IMAGE                     COMMAND                  ...         SIZE
9ebdba5a8445        gin-blog-docker-scratch   "./go-gin-example"       ...     0 B (virtual 132 MB)
427ee79e6857        gin-blog-docker           "./go-gin-example"       ...     0 B (virtual 946 MB)

从结果而言，占用大小以Scratch镜像为基础的容器完胜，完成目标

Mysql挂载数据卷

假若不作任何干涉，在每次启动一个 Mysql 容器时，数据库都是空的。另外容器删除以后，数据就丢失了（还有各种意外状况），很是糟糕！

数据卷

数据卷是被设计用来持久化数据的，它的生命周期独立于容器，Docker 不会在容器被删除后自动删除数据卷，而且也不存在垃圾回收这样的机制来处理没有任何容器引用的数据卷。若是须要在删除容器的同时移除数据卷。能够在删除容器的时候使用 docker rm -v 这个命令

数据卷是一个可供一个或多个容器使用的特殊目录，它绕过 UFS，能够提供不少有用的特性：

数据卷能够在容器之间共享和重用
对数据卷的修改会立马生效
对数据卷的更新，不会影响镜像
数据卷默认会一直存在，即便容器被删除

注意：数据卷的使用，相似于 Linux 下对目录或文件进行 mount，镜像中的被指定为挂载点的目录中的文件会隐藏掉，能显示看的是挂载的数据卷。

如何挂载

首先建立一个目录用于存放数据卷；示例目录 /data/docker-mysql，注意 --name 本来名称为 mysql 的容器，须要将其删除 docker rm

$ docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=rootroot -v /data/docker-mysql:/var/lib/mysql -d mysql
54611dbcd62eca33fb320f3f624c7941f15697d998f40b24ee535a1acf93ae72

建立成功，检查目录 /data/docker-mysql，下面多了很多数据库文件

验证

接下来交由你进行验证，目标是建立一些测试表和数据，而后删除当前容器，从新建立的容器，数据库数据也依然存在（固然了数据卷指向要一致）

我已验证完毕，你呢？

参考

本系列示例代码

go-gin-example

本系列目录

书籍

Docker —— 从入门到实践

Gin实践 连载九 将Golang应用部署到Docker

介绍

Golang

1、编写Dockerfile

做用

说明

2、构建镜像

3、验证镜像

4、建立并运行一个新容器

Mysql

1、拉取镜像

2、建立并运行一个新容器

链接 Mysql

Golang + Mysql

1、删除镜像

2、修改配置文件

3、从新构建镜像

4、建立并运行一个新容器

关联

运行

结果

Review

思考

建立超小的Golang镜像

构建Scratch镜像

1、修改Dockerfile

2、编译可执行文件

3、构建镜像

4、运行

Mysql挂载数据卷

数据卷

如何挂载

验证

参考

本系列示例代码

本系列目录

书籍

Gin实践连载九将Golang应用部署到Docker