Docker（三）实战：-Docker部署Golang项目并关联Mysql容器

前言

友情提示
本文学习需要了解一些Linux简单命令和Docker的一些命令
使用的项目我已经上传到github：https://github.com/Gopherlinzy/gin-gorm-example
个人博客：https://linzyblog.netlify.app/

一、获取一个可执行的项目

我自己写了一个简单的gin-gorm项目，github下载地址：https://github.com/Gopherlinzy/gin-gorm-example

1、拉取项目

打开Windows终端，输入命令：

go get github.com/Gopherlinzy/gin-gorm-example

2、配置

只需要拉取下来，修改 conf/app.ini 配置文件

[database]
Type = mysql
User = 数据库名称
Password = 数据库密码
//数据库的IP地址
Host = 127.0.0.1:3306
//数据库名称 
Name = blog
TablePrefix = blog_

二、编写Dockerfile文件

Dockerfile文件就是单纯的文件并没有文件后缀，我们来了解一下，Dockerfile的作用。

FROM golang:latest

ENV GOPROXY https://goproxy.cn,direct
WORKDIR $GOPATH/github.com/Gopherlinzy/go-gorm-example
COPY . $GOPATH/github.com/Gopherlinzy/go-gorm-example
RUN go build .

EXPOSE 8080
ENTRYPOINT ["./gin-gorm-example"]

1、作用

1. golang:latest 镜像为基础镜像，将工作目录设置为 $GOPATH/src/gin-gorm-example ，并将当前上下文目录的内容复制到 $GOPATH/src/gin-gorm-example 中。
2. 在进行 go build 编译完毕后，将容器启动程序设置为 ./gin-gorm-example，也就是我们所编译的可执行文件。
3. 注意：gin-gorm-example 在 docker 容器里编译，并没有在宿主机现场编译

2、说明

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

1）FROM

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

2）WORKDIR

使用 WORKDIR 指令可以来指定工作目录（或者称为当前目录），以后各层的当前目录就被改为指定的目录，如果目录不存在，WORKDIR 会帮你建立目录

格式： WORKDIR <工作目录路径>

3）COPY

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

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

4）RUN

用于执行命令行命令

格式：RUN <命令>

5）EXPOSE

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

格式： EXPOSE <端口 1> [<端口 2>…]

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

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

6）ENTRYPOINT

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

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

• exec 格式：

 ""

• shell 格式：

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

三、构建Docker镜像

gin-gorm-example 的项目根目录下执行 docker build -t gin-gorm-docker .
该命令作用是创建/构建镜像，-t 指定名称为 gin-gorm-docker，. 构建内容为当前上下文目录

四、验证镜像

查看所有的镜像，确定刚刚构建的 gin-gorm-docker 镜像是否存在

五、创建并运行一个新容器

执行命令 docker run -p 8080:8080 gin-gorm-docker

测试我们项目的API文档网址：http://localhost:8080/swagger/index.html

运行成功了么？

我们再测试一下用户登录这块，我在用户表自动创建这块自动插入了一条用户信息用户：admin和密码:123456，用我们的postman测试一下，测试网址：http://localhost:8080/auth?username=admin&password=123456。

我们仔细看看控制台的输出了一条错误

我们可以发现问题是在访问MySQL数据库的时候，连接数据库超时了！

这就是我们接下来要解决的问题

六、MySQL

1、拉取镜像

从 Docker 的公共仓库 Dockerhub 下载 MySQL 镜像（国内建议配个镜像），用pull指令拉取镜像，格式指令 docker pull 镜像名:版本号，不写版本号默认拉取最新版。

我们这里就用5.7版本的MySQL数据库就好了。

docker pull mysql:5.7

2、创建并运行一个MySQL容器

用run指令创建并运行容器

docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 -d mysql

说明：
–name mysql：指定容器名称为mysql，方便查找和使用
-p xxxx:yyyy：宿主机上xxxx端口对应容器中yyyy端口，在外部访问时用的是宿主机上的端口
-e MYSQL_ROOT_PASSWORD=123456：给root用户设置默认密码为123456
-d：容器后台运行
mysql：镜像名称

3、连接数据库

我用的是Navicat连接MySQL。

初始化的 Mysql 应该如图

创建我们的blog数据库，后续测试需要

七、关联Golang项目和MySQL

1、删除原来的项目镜像

由于原本的镜像存在问题，我们需要修改Dockerfile文件里的数据库的地址，我们需要删除它，此处有几种做法

• 删除原本有问题的镜像，重新构建一个新镜像
• 重新构建一个不同 name、tag 的新镜像

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

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

docker rmi -f gin-gorm-docker

2、修改配置文件

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

#debug or release
RUN_MODE = debug

[app]
PAGE_SIZE = 10
JWT_SECRET = 233

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

[database]
TYPE = mysql
USER = root
PASSWORD = 123456
//IP地址为 容器名称：端口号
HOST = mysql:3306
NAME = blog
TABLE_PREFIX = blog_

3、重新构建镜像

重复先前的步骤，回到 gin-gorm 的项目根目录下执行

docker build -t gin-gorm-docker .

4、创建关联并运行一个新容器

我们如何将项目容器和MySQL容器创建关联？

在run指令内增加命令 –link mysql:mysql 让 Golang 容器与 Mysql 容器互联；通过 –link，可以在容器内直接使用其关联的容器别名进行访问，而不通过 IP，但是–link只能解决单机容器间的关联，在分布式多机的情况下，需要通过别的方式进行连接。

执行命令

docker run --link mysql:mysql -p 8080:8080 gin-gorm-docker

MySQL容器的数据库也成功自动创建了三个数据表。

我们测试一下数据库是否已经关联，用户登录测试网址：http://localhost:8080/auth?username=admin&password=123456

大功告成！

八、持久化数据库

我们在每次启动一个 Mysql 容器时，数据库都是空的。另外容器删除之后，数据就丢失了。
我们学习了Docker Volume卷技术，了解了如何将数据生命周期独立于容器的生命周期之外，来更新一下我们的Mysql容器吧！

Docker Volume文章：https://blog.csdn.net/weixin_46618592/article/details/126591142?spm=1001.2014.3001.5501

1、数据卷

数据卷 是被设计用来持久化数据的，数据卷的生命周期独立于容器的生命周期，Docker 不会在容器被删除后自动删除 数据卷，并且也不存在垃圾回收这样的机制来处理没有任何容器引用的 数据卷。

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

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

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

2、如何挂载？

1. 首先创建一个目录用于存放数据卷；示例目录 E:/home/docker-mysql。

docker run --name mysql -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 -v E:/home/docker-mysql:/var/lib/mysql mysql:5.7

2. 检查目录 E:/home/docker-mysql，多了很多数据库文件。

3、验证

1. 新建一个blog数据库，并启动我们的gin-gorm-docker容器

2. 登录验证一下：http://localhost:8080/auth?username=admin&password=123456

3. 用我们的token，去新增tags数据表的记录
   http://localhost:8080/api/v1/tags?token=(登录后拿到的token)&name=linzy&state=1&created_by=linzy

4. 删除MySQL容器，在重新用镜像启动

# 查看容器列表
E:\goWorkspace\github.com\Gopherlinzy\gin-gorm-example>docker ps
CONTAINER ID   IMAGE             COMMAND                  CREATED          STATUS          PORTS                               NAMES
e57733001baa   gin-gorm-docker   "./go-gin-example"       7 minutes ago    Up 7 minutes    0.0.0.0:8080->8080/tcp              beautiful_curran
c44788bd68d4   mysql:5.7         "docker-entrypoint.s…"   35 minutes ago   Up 21 minutes   0.0.0.0:3306->3306/tcp, 33060/tcp   mysql

# 停止正在运行的MySQL容器
E:\goWorkspace\github.com\Gopherlinzy\gin-gorm-example>docker stop c44788bd68d4
c44788bd68d4

# 删除MySQL容器
E:\goWorkspace\github.com\Gopherlinzy\gin-gorm-example>docker rm c44788bd68d4
c44788bd68d4

# 重新将容器挂载到原来的目录
E:\goWorkspace\github.com\Gopherlinzy\gin-gorm-example>docker run --name mysql -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 -v E:/home/docker-mysql:/var/lib/mysql mysql:5.7
2de27acad62b21693c79cc0687453ae2c7cb3d0f8f1f478c8715303afcdf497a

验证完毕，你也可以操作一下：创建一些测试表和数据，然后删除当前容器，重新创建的容器，数据库数据也依然存在（当然了数据卷指向要一致）