Docker深入浅出系列 | 单节点Nginx+Springboot实战

约定不等于承诺〃 2023-07-10 08:06 44阅读 0赞

> Docker已经上市很多年，不是什么新鲜事物了，很多企业或者开发同学以前也不多不少有所接触，但是有实操经验的人不多，本系列教程主要偏重实战，尽量讲干货，会根据本人理解去做阐述，具体官方概念可以查阅官方教程，因为本系列教程对前一章节有一定依赖，建议先学习前面章节内容。

本系列教程导航:  
[Docker深入浅出系列 | 容器初体验][Docker_ _]  
[Docker深入浅出系列 | Image初体验][Docker_ _ Image]  
[Docker深入浅出系列 | 单节点多容器网络通信][Docker_ _ 1]  
[Docker深入浅出系列 | 容器数据持久化][Docker_ _ 2]

教程目的：

*  了解nginx容器搭建
 *  了解springboot镜像制作与dockerfile配置
 *  了解docker容器网络配置
 *  了解容器volume配置
 *  了解nginx对容器名称做反向代理
 *  了解springboot额度服务项目搭建

--------------------

# **前期准备** #

1.下载mysql

docker pull mysql

2.下载nginx

docker pull nginx

3.克隆`credit-facility-service`作为后面部署演示使用，使用`docker`分支

git clone https://github.com/EvanLeung08/credit-facility-service.git

4.虚拟机、centos和docker环境安装请查看第一章，本章默认已经安装好centos和docker  
[Docker深入浅出系列 | 容器初体验][Docker_ _]

--------------------

# **实战目标** #

*  创建docker网络，设置静态子网ip`168.18.0.0/24`
 *  搭建额度服务集群
    
     *  \[额度服务\]credit-facility01 - 168.18.0.10
     *  \[额度服务\]credit-facility02 - 168.18.0.11
     *  \[额度服务\]credit-facility03 - 168.18.0.12
 *  搭建Mysql数据库，并创建额度服务相关表
    
     *  \[Mysql服务\]credit-facility-db - 168.18.0.4
 *  搭建Nginx服务，并配置负载均衡规则
    
     *  \[Nginx服务\]credit-facility-nginx - 168.18.0.5
 *  利用docker内置DNS服务器的特点，docker网络内容器之间通过容器名称进行通信
 *  通过浏览器访问swagger进行业务操作

**整体架构**  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70][]  
**最终效果图**  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 1][]

--------------------

# **实战步骤** #

## **创建Docker网络** ##

这里先创建一个属于这个项目的私有网络，后面对容器分别分配一个静态子网IP，方便维护

1.通过`docker network`创建网络

[root@localhost ~]# docker network create --subnet=168.18.0.0/24 credit-facility-net
    fab1ac021f2f0d6acabd1fdfba10959fdd6797a5adc3fb15ebef85da922dc4b9

这里创建了一个网络，命名为`credit-facility-net`，并且指定了一个子网IP网段 `168.18.0.0/24`

2.查看宿主机器Centos系统外网IP，用于后面在本机访问虚拟机应用使用

[root@localhost credit-facility]# ip add
    3: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
        link/ether 08:00:27:ba:0a:28 brd ff:ff:ff:ff:ff:ff
        inet 192.168.101.23/24 brd 192.168.101.255 scope global noprefixroute dynamic eth1
           valid_lft 76364sec preferred_lft 76364sec
        inet6 fe80::a00:27ff:feba:a28/64 scope link 
           valid_lft forever preferred_lft forever

这里Centos系统ip是`192.168.101.23`，需要记住你的宿主机器ip，后面进行测试需要频繁用到

## **搭建Mysql容器** ##

为了方便后面重复使用，这里会先创建一个volume用于Mysql数据持久化

1.创建docker volume，命名为`credit-facility-volume`

docker volume create credit-facility-volume

2.创建Mysql容器

[root@localhost ~]# docker run -d --name credit-facility-db -v credit-facility-volume:/var/lib/mysql -p 3301:3306 -e MYSQL_ROOT_PASSWORD=evan123 --net=credit-facility-net --ip 168.18.0.4 mysql
    9502bd3d4823cb61559647f60f20a5f7ce153b743701129544f1208b66d59d6a

这里创建了一个`credit-facility-db`容器，把Mysql的数据存储路径指定了宿主机`credit-facility-volume`目录，把3306端口映射到宿主机3301端口，把容器网络加入到`credit-facility-net`，并且分配一个静态ip `168.18.0.4`

3.进入Mysql容器并创建数据库实例

[root@localhost /]# docker exec -it credit-facility-db bash
    root@9502bd3d4823:/# mysql -uroot -pevan123
    mysql> create schema db_credit_facility collate utf8mb4_0900_ai_ci;
    Query OK, 1 row affected (0.00 sec)
    
    mysql> use db_credit_facility;
    Database changed
    mysql> exit
    Bye

这里创建了一个数据库实例，命名为`db_credit_facility`

4.创建应用关联的表  
相关表存放在credit-facility-service-infrastructure/resources/db/schema.sql，请按照**前期准备**指示从github下载`credit-facility-service`项目

5.通过`docker inspect`查看下容器信息

docker inspect credit-facility-db

"Mounts": [
                { 
                    "Type": "volume",
                    "Name": "credit-facility-volume",
                    "Source": "/var/lib/docker/volumes/credit-facility-volume/_data",
                    "Destination": "/var/lib/mysql",
                    "Driver": "local",
                    "Mode": "z",
                    "RW": true,
                    "Propagation": ""
                }
            ]
    
          "NetworkSettings": { 
                "Bridge": "",
                "SandboxID": "1ef5e3b28a7cb2c715aca8a122ce2caa50c41b29c53e04006885dd2114f34e8f",
                "HairpinMode": false,
                "LinkLocalIPv6Address": "",
                "LinkLocalIPv6PrefixLen": 0,
                "Ports": { 
                    "3306/tcp": [
                        { 
                            "HostIp": "0.0.0.0",
                            "HostPort": "3301"
                        }
                    ],
                    "33060/tcp": null
                },
                "SandboxKey": "/var/run/docker/netns/1ef5e3b28a7c",
                "SecondaryIPAddresses": null,
                "SecondaryIPv6Addresses": null,
                "EndpointID": "",
                "Gateway": "",
                "GlobalIPv6Address": "",
                "GlobalIPv6PrefixLen": 0,
                "IPAddress": "",
                "IPPrefixLen": 0,
                "IPv6Gateway": "",
                "MacAddress": "",
                "Networks": { 
                    "credit-facility-net": { 
                        "IPAMConfig": { 
                            "IPv4Address": "168.18.0.4"
                        },
                        "Links": null,
                        "Aliases": [
                            "9502bd3d4823"
                        ],
                        "NetworkID": "fab1ac021f2f0d6acabd1fdfba10959fdd6797a5adc3fb15ebef85da922dc4b9",
                        "EndpointID": "af76ebce29de84dfb2e48d44e3baa8b42923e698714b7774407915b02e55e1b4",
                        "Gateway": "168.18.0.1",
                        "IPAddress": "168.18.0.4",
                        "IPPrefixLen": 24,
                        "IPv6Gateway": "",
                        "GlobalIPv6Address": "",
                        "GlobalIPv6PrefixLen": 0,
                        "MacAddress": "02:42:a8:12:00:04",
                        "DriverOpts": null
                    }
                }

从上面输出结果可以看出，容器的存储路径已经成功挂载到宿主机目录`/var/lib/docker/volumes/credit-facility-volume/_data`，容器ip也成功设置成`168.18.0.4`

## **搭建额度服务集群** ##

额度服务是一个Springboot项目，其搭建过程跟普通Springboot项目一样

1.搭建前，请先通过`mvn clean -U install`对项目构建一次，确保可以构建成功，注意要切换到项目的`docker分支`

2.修改数据库配置`application.properties`，默认情况下，大家不需要修改，因为我这里的数据库host是通过容器名称进行访问，配置文件路径存放在`start/resources`下

spring.datasource.url = jdbc:mysql://credit-facility-db:3306/db_credit_facility?useUnicode=true&characterEncoding=utf8

如果需要在本地运行，可以把数据库host修改成`<Centos ip>:3301`如：

spring.datasource.url = jdbc:mysql://192.168.101.23:3301/db_credit_facility?useUnicode=true&characterEncoding=utf8

3.在docker宿主机器Centos上创建一个名字为`credit-facility`的文件夹

我的文件夹创建路径如下:

[root@localhost credit-facility]# pwd
    /usr/local/credit-facility

4.在`credit-facility`的文件夹下创建一个Dockerfile文件，用于后面额度服务镜像创建使用

在`credit-facility-sevice`项目里有一个`dockerfile`文件夹，只需要把里面的`Dockerfile`文件复制到Centos系统`credit-facility`的文件夹下即可

FROM openjdk:8-jre-alpine
    MAINTAINER evan
    LABEL name="credit-facility" version="1.0" author="evan"
    COPY start-1.0.0-SNAPSHOT.jar credit-facility-service.jar
    CMD ["java","-jar","credit-facility-service.jar"]

在我本机是通过sftp上传到Centos系统指定目录下，大家可以用一些工具直接上传即可

evans-MacBook-Pro:target evan$ sftp root@192.168.101.23
    root@192.168.101.23's password: 
    Connected to root@192.168.101.23.
    sftp> put Dockerfile /usr/local/credit-facility
    Uploading Dockerfile to /usr/local/credit-facility/Dockerfile

5.对额度服务打成jar包，并且上传

*  通过`mvn clean package -Dmaven.test.skip=true`命令对项目进行打包，可以在start/target下找到start-1.0.0-SNAPSHOT.jar  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 2][]
 *  上传到Centos上的`credit-facility`的文件夹下

同上，我这里也是通过sftp从本地上传到服务器上

evans-MacBook-Pro:target evan$ sftp root@192.168.101.23
    root@192.168.101.23's password: 
    Connected to root@192.168.101.23.
    sftp> put start-1.0.0-SNAPSHOT.jar /usr/local/credit-facility
    Uploading start-1.0.0-SNAPSHOT.jar to /usr/local/credit-facility/start-1.0.0-SNAPSHOT.jar
    start-1.0.0-SNAPSHOT.jar                                                          100%   43MB 168.1MB/s   00:00    
    sftp>

*  此时，Centos系统上`credit-facility`的文件夹下应该存在两个文件

[root@localhost credit-facility]# ls
    Dockerfile  start-1.0.0-SNAPSHOT.jar

6.基于之前创建的Dockfile创建一个image

[root@localhost credit-facility]# docker build -t credit-facility-image .

7.查看现有的镜像

[root@localhost credit-facility]# docker images
    REPOSITORY                TAG                 IMAGE ID            CREATED             SIZE
    credit-facility-image     latest              d0536e7c7e78        3 hours ago         130MB
    nginx                     latest              a1523e859360        3 days ago          127MB

8.创建3个额度服务容器实例

[root@localhost credit-facility]# docker run -d --name credit-facility01 -p 8081:8080 --net=credit-facility-net --ip 168.18.0.10 credit-facility-image
    4ffc98a8c73a4a7afe3737a8ace18d4d053cf8573ab61179963942f3b01104cb
    [root@localhost credit-facility]# docker run -d --name credit-facility02 -p 8082:8080 --net=credit-facility-net --ip 168.18.0.11 credit-facility-image
    a01e3613ac2a9e995fad644c29a5fd991e762008ff0dc8a3e5b1ab2e86d52924
    [root@localhost credit-facility]# docker run -d --name credit-facility03 -p 8083:8080 --net=credit-facility-net --ip 168.18.0.12 credit-facility-image
    9dc0ba15542ed29501a0d8540f0f226814e29ffb93c9ab9e06461c01b9f7c049

上面分别创建了3个实例credit-facility01、credit-facility02、credit-facility03，加入`credit-facility-net`网络，并且把ip分别指定为168.18.0.10、168.18.0.11和168.18.0.12

9.通过`docker logs credit-facility01`查看容器启动日志

10.通过在本机通过浏览器进行测试，可以看到如下swagger界面

*  http://192.168.101.23:8081/swagger-ui.html
 *  http://192.168.101.23:8082/swagger-ui.html
 *  http://192.168.101.23:8083/swagger-ui.html

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 3][]

## 搭建Nginx服务 ##

跟前面一样，我通过容器名称进行反向代理而不是容器ip地址，因为docker对于自定义网络默认开启内置DNS服务，通过容器名称进行通信，可以更加灵活，不需要绑定具体ip

1.在Contos系统`credit-facility`的文件夹下，创建一个新文件夹，命名`nginx`

[root@localhost credit-facility]# mkdir nginx
    [root@localhost credit-facility]# ls
    Dockerfile  nginx  start-1.0.0-SNAPSHOT.jar

2.进入nginx文件夹，创建一个`nginx.conf`文件，内容如下

user nginx;
    worker_processes  1;
    events { 
        worker_connections  1024;
    }
    http { 
        include       /etc/nginx/mime.types;
        default_type  application/octet-stream;
        sendfile        on;
        keepalive_timeout  65;
    
    
        server { 
            listen 80;
            location / { 
             proxy_pass http://balance;
            }
        }
    
        upstream balance{ 
           server credit-facility01:8080;
           server credit-facility02:8080 ;
           server credit-facility03:8080;
        }
        include /etc/nginx/conf.d/*.conf;
    }

这里路由规则配置三个额度服务的容器名称代替了IP地址

3.创建nginx容器

[root@localhost nginx]# docker run -d --name credit-facility-nginx -p 80:80 -v /usr/local/credit-facility/nginx/nginx.conf:/etc/nginx/ningx.conf --network=credit-facility-net --ip 168.18.0.5 nginx
    60fc13c1a8d425263d6a90eb34a309ad5e5d3d5517598b8026d7326e9925b9f7

这里创建了一个名为`credit-facility-nginx`的nginx容器，指定了系统映射端口为80，这里比较重要的是复制`/usr/local/credit-facility/nginx/nginx.conf`到`/etc/nginx/nginx.conf`，并且分配ip`168.18.0.5`

4.在浏览器验证nginx服务，输入`192.168.101.23`  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 4][]  
这时候nginx已经搭建成功了

## **验证额度服务** ##

1.在浏览器输入`http://192.168.101.23/swagger-ui.html`，可以看到如下界面  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 5][]

2.选用第一个接口测试，输入如下请求数据

{ 
    	"registrationLimitCO": { 
    		"applicationId": "1111",
    		"userId": 1111,
    		"quotaLimit": 10000,
    		"productCode": "tb",
    		"expirationTime": "2030-01-01",
    		"accountType": 1
    	}
    
    }

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 6][]

3.执行后查看执行结果，看是否入库成功  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 7][]  
从上面执行结果可以看出，额度服务已经成功处理请求，并且入库成功，此时可以到数据库去查看下数据库记录

--------------------

# **附录** #

*  测试项目Github地址：[额度服务][Link 1]
 *  Docker官方文档：[Docker教程][Docker]

--------------------

更多详细内容，可以关注我个人Gitchat，一起交流  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 8]

[Docker_ _]: https://blog.csdn.net/Evan_Leung/article/details/104097170
[Docker_ _ Image]: https://blog.csdn.net/Evan_Leung/article/details/104103615
[Docker_ _ 1]: https://blog.csdn.net/Evan_Leung/article/details/104203848
[Docker_ _ 2]: https://blog.csdn.net/Evan_Leung/article/details/104272808
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200301123010377.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200301122809973.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200301144300542.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20200301150454118.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20200301154325397.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20200301154811693.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20200301155146587.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/20200301155332945.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70
[Link 1]: https://github.com/EvanLeung08/credit-facility-service.git
[Docker]: https://docs.docker.com
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc_size_16_color_FFFFFF_t_70 8]: https://img-blog.csdnimg.cn/20200304105058395.jpeg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V2YW5fTGV1bmc=,size_16,color_FFFFFF,t_70