文章目录
前言原文章1. Spring Boot 案例1.1 配置信息1.2 核心代码1.2.1 entity1.2.2 repository1.2.3 controller2. Docker 化改造2.1 docker-compose.yml 文件详解2.2 nginx 文件解读2.3 Spring Boot 项目改造3. 部署3.1 docker-compose 顺序4. 总结爬坑总结问题一:启动项目mysql server时区报错问题二:注意数据库密码问题三:Docker Compose ERROR network has active endpoints奇思妙想想法一:随时观察启动日志,少怀疑人生前言
此文章是苯宝宝,参考
纯洁的微笑
的学习总结,大体内容是转载自原文章+
符合当前版本的代码改造+
自己实践过程中的一些小理解精华在于,最后的
爬坑总结
和奇思妙想
我的源码地址==>请戳这里
原文章
原文链接==>请戳这里
Spring Boot + Nginx + Mysql 是实际工作中最常用的一个组合,最前端使用 Nginx 代理请求转发到后端 Spring Boot 内嵌的 Tomcat 服务,Mysql 负责业务中数据相关的交互,那么在没有 docker 之前,我们是如何来搞定这些环境的呢?
1、安装 Nginx,配置 Nginx 相关信息,重启2、安装 Mysql ,配置字符集时区等信息,重启,最后初始化脚本3、启动 Spring Boot 项目,整体进行联调测试
大家看我只写了三行,但其实搭建这些环境的时候还挺费事的,但这还不是结局,在用了一段时间时候需要迁移到另外一个环境,怎么办又需要重新搞一次?正常情况下,测试环境
、SIT(系统集成测试)环境
、UAT(用户验收测试)环境
、生产环境
!我们需要重复搭建四次。有人说不就是搭建四次吗?也没什么大不了的,那么我想告诉你,Too yong ,Too Simple
让我们看看以下几个因素:
第一,这只是一个最简单的案例,如果项目涉及到 MongoDB、Redis、ES … 一些列的环境呢? 第二,如果你经常搭建环境或者调试程序,你就会知道什么是环境问题?有的时候明明是一模一样的配置,但是到了另外一个环境就是跑不起来。于是你花费很多时间来查找,最后才发现是少了一个参数或者逗号的问题,或者是系统内核版本不一致、或者你最后也没搞懂是为什么!只能再换另外一台服务器,那么使用 Docker 呢就可以完美的避开这些坑。
好了,废话不多说我们就开始吧!
1. Spring Boot 案例
首先我们先准备一个 Spring Boot 使用 Mysql 的小场景,我们做这样一个示例,使用 Spring Boot 做一个 Web 应用,提供一个按照 IP 地址统计访问次数的方法,每次请求时将统计数据存入 Mysql 并展示到页面中。
1.1 配置信息
依赖包主要添加了 Spring Boot Web 支持,使用 Jpa 操作数据库、添加 Myql 驱动包等
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-jpa</artifactId></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies>
配置文件配置了数据库的链接信息,以及 Jpa 更新表模式、方言和是否显示Sql
spring.datasource.url=jdbc:mysql://localhost:3306/dockercompose-springboot-mysql-nginxspring.datasource.username=rootspring.datasource.password=rootspring.datasource.driver-class-name=com.mysql.jdbc.Driver# 加载hibernate时根据实体类创建数据库表,表名的依据是@Entity注解的值或者@Table注解的值,且下一次启动会根据实体更新表结构或者有新的实体类会创建新的表spring.jpa.properties.hibernate.hbm2ddl.auto=updatespring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialectspring.jpa.show-sql=true
1.2 核心代码
核心代码很简单,每过来一个请求,判断是否已经统计过,如果没有统计新增数据,如果有统计数据更新数据
1.2.1 entity
package top.tan.entity;import javax.persistence.Column;import javax.persistence.Entity;import javax.persistence.GeneratedValue;import javax.persistence.Id;@Entitypublic class Visitor {@Id@GeneratedValueprivate long id;@Column(nullable = false)private long times;@Column(nullable = false)private String ip;public long getId() {return id;}public void setId(long id) {this.id = id;}public long getTimes() {return times;}public void setTimes(long times) {this.times = times;}public String getIp() {return ip;}public void setIp(String ip) {this.ip = ip;}}
1.2.2 repository
package top.tan.repository;import org.springframework.data.jpa.repository.JpaRepository;import top.tan.entity.Visitor;public interface VisitorRepository extends JpaRepository<Visitor, Long> {Visitor findByIp(String ip);}
1.2.3 controller
package top.tan.controller;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import top.tan.entity.Visitor;import top.tan.repository.VisitorRepository;import javax.servlet.http.HttpServletRequest;@RestControllerpublic class VisitorController {@Autowiredprivate VisitorRepository repository;@RequestMapping("/")public String index(HttpServletRequest request) {String ip = request.getRemoteAddr();Visitor visitor = repository.findByIp(ip);if (visitor == null) {visitor = new Visitor();visitor.setIp(ip);visitor.setTimes(1);} else {visitor.setTimes(visitor.getTimes() + 1);}repository.save(visitor);return "I have been seen ip " + visitor.getIp() + " " + visitor.getTimes() + " times.";}}
以上内容都完成后,启动项目,访问:http://localhost:8080
我们就可以看到这样的返回结果:
I have been seen ip 0:0:0:0:0:0:0:1 1 times.
再访问一次会变成
I have been seen ip 0:0:0:0:0:0:0:1 2 times.
多次访问一直叠加,说明演示项目开发完成
2. Docker 化改造
首先我们将目录改造成这样一个结构
我们先从最外层说起:
docker-compose.yml
:docker-compose 的核心文件,描述如何构建整个服务nginx
:有关 nginx 的配置app
:Spring Boot 项目地址
如果我们需要对 Mysql 有特殊的定制,也可以在最外层创建 mysql 文件夹,在此目录下进行配置
2.1 docker-compose.yml 文件详解
version: '3'services:nginx:container_name: v-nginximage: nginx:1.13restart: alwaysports:- 80:80- 443:443volumes:- ./nginx/conf.d:/etc/nginx/conf.dmysql:container_name: v-mysqlimage: mysql/mysql-server:5.7restart: alwaysenvironment:TZ: Asia/ShanghaiMYSQL_DATABASE: dockercompose-springboot-mysql-nginxMYSQL_ROOT_PASSWORD: rootMYSQL_ROOT_HOST: '%'ports:- 3306:3306app:restart: alwaysbuild: ./appworking_dir: /appvolumes:- ./app:/app- ~/.m2:/root/.m2expose:- "8080"depends_on:- nginx- mysqlcommand: mvn clean spring-boot:run -Dspring-boot.run.profiles=docker
version
: ‘3’: 表示使用第三代语法来构建docker-compose.yaml
文件。services
: 用来表示 compose 需要启动的服务,我们可以看出此文件中有三个服务分别为:nginx、mysql、app。container_name
: 容器名称environment
: 此节点下的信息会当作环境变量传入容器,此示例中 mysql 服务配置了数据库、密码和权限信息。ports
: 表示对外开放的端口restart
: always 表示如果服务启动不成功会一直尝试。volumes
: 加载本地目录下的配置文件到容器目标地址下depends_on
:可以配置依赖服务,表示需要先启动depends_on
下面的服务后,再启动本服务。command
:mvn clean spring-boot:run -Dspring-boot.run.profiles=docker
表示以这个命令来启动项目,
-Dspring- boot.run.profiles=docker
表示使用application-docker.properties
文件配置信息进行启动。
2.2 nginx 文件解读
nginx 在目录下有一个文件app.conf
,主要配置了服务转发信息
server {listen 80;charset utf-8;access_log off;location / {proxy_pass http://app:8080;proxy_set_header Host $host:$server_port;proxy_set_header X-Forwarded-Host $server_name;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;}location /static {access_log off;expires30d;alias /app/static;}}
这块内容比较简单,配置请求转发,将80端口的请求转发到服务 app 的8080端口。其中proxy_pass http://app:8080
这块的配置信息需要解释一下,这里使用是app
而不是localhost
,是因为他们没有在一个容器中,在同一台机器的docker容器
中的服务通讯只需要使用service的名称
即可进行访问
2.3 Spring Boot 项目改造
在app目录下也就是和pom.xm
文件同级添加Dockerfile
文件,文件内容如下:
FROM maven:3.5-jdk-8
只有一句,依赖于基础镜像maven3.5和jdk 1.8。因为在docker-compose.yml
文件设置了项目启动命令,这里不需要再添加启动命令
在项目的resources
目录下创建application-dev.properties
和application-docker.properties
文件
application-dev.properties
中的配置信息和上面一致application-docker.properties
中的配置信息做稍微的改造,将数据库的连接信息由jdbc:mysql://localhost:3306/dockercompose-springboot-mysql-nginx
改为jdbc:mysql://mysql:3306/dockercompose-springboot-mysql-nginx
这样我们所有的配置都已经完成
3. 部署
我们将项目拷贝到服务器中进行测试,服务器需要先安装 Docker 和 Docker Compos 环境,如果不了解的朋友可以查看我前面的两篇文章:
Docker(一):Docker入门教程Docker(四):Docker 三剑客之 Docker Compose
将项目拷贝到服务器中,进入目录
cd dockercompose-springboot-mysql-nginx
启动服务docker-compose up
[root@VM_73_217_centos dockercompose-springboot-mysql-nginx]# docker-compose upCreating network "dockercomposespringbootmysqlnginx_default" with the default driverCreating v-nginx ... doneCreating v-mysql ... doneCreating dockercomposespringbootmysqlnginx_app_1 ... doneAttaching to v-nginx, v-mysql, dockercomposespringbootmysqlnginx_app_1v-mysql | [Entrypoint] MySQL Docker Image 5.7.21-1.1.4v-mysql | [Entrypoint] Initializing databaseapp_1 | [INFO] Scanning for projects...... app_1 | -03-26 02:54:55.658 INFO 1 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''app_1 | -03-26 02:54:55.660 INFO 1 --- [ main] poseApplication: Started ComposeApplication in 14.869 seconds (JVM running for 30.202)
看到信息Tomcat started on port(s): 8080
表示服务启动成功。也可以使用docker-compose up -d
后台启动
访问服务器地址:http://58.87.69.230/
,返回:I have been seen ip 172.19.0.2 1 times.
表示整体服务启动成功
使用docker-compose ps
查看项目中目前的所有容器
[root@VM_73_217_centos dockercompose-springboot-mysql-nginx]# docker-compose psName Command State Ports ----------------------------------------------------------------------------------------------------------------------------------dockercomposespringbootmysqlnginx_app_1 /usr/local/bin/mvn-entrypo ... Up 8080/tcp v-mysql/entrypoint.sh mysqld Up (healthy) 0.0.0.0:3306->3306/tcp, 33060/tcp v-nginxnginx -g daemon off; Up 0.0.0.0:443->443/tcp, 0.0.0.0:80->80/tcp
可以看到项目中服务的状态、命令、端口等信息。
关闭服务docker-compose down
3.1 docker-compose 顺序
在使用docker-compose
启动的时候经常会出现项目报 Mysql 连接异常,跟踪了一天终于发现了问题。docker-compose
虽然可以通过depends_on
来定义服务启动的顺序,但是无法确定服务是否启动完成,因此会出现这样一个现象,Mysql 服务启动比较慢,当 Spring Boot 项目已经启动起来,但是 Mysql 还没有初始化好,这样当项目连接 Mysql 数据库的时候,就会出现连接数据库的异常。
针对这样的问题,有两种解决方案:
1、足够的容错和重试机制,比如连接数据库,在初次连接不上的时候,服务消费者可以不断重试,直到连接上服务。也就是在服务中定义:restart: always
2、同步等待,使用wait-for-it.sh
或者其他shell
脚本将当前服务启动阻塞,直到被依赖的服务加载完毕。这种方案后期可以尝试使用
4. 总结
没有对比就没有伤害,在没有使用 Docker 之前,我们需要搭建这样一个环境的话,需要安装 Nginx、Mysql ,再进行一系列的配置调试,还要担心各种环境问题;使用 Docker 之后简单两个命令就完成服务的上线、下线。
docker-compose updocker-compose down
其实容器技术对部署运维的优化还有很多,这只是刚刚开始,后面使用了Docker Swarm
才会真正感受到它的便利和强大
爬坑总结
问题一:启动项目mysql server时区报错
报错如下:
The server time zone value ‘D1ú±ê×ê±’ is unrecognized or represents more than one time zone
解决方案:在application.properties
的spring.datasource.url
添加参数指定时区
# 添加serverTimezone=UTC解决时区问题spring.datasource.url=jdbc:mysql://localhost:3306/dockercompose-springboot-mysql-nginx?serverTimezone=UTC
问题二:注意数据库密码
童子们在服务器上启动时,一定要注意数据库密码是否和自己的数据库密码一致很可能你服务器上的数据库密码和本地的数据库密码不一致,导致项目没有启动成功
问题三:Docker Compose ERROR network has active endpoints
突然发现自己的数据库STATUS
为unhealthy
,导致访问网站为502
,所以想重启服务
[root@iz2ze2ixdy0e67ek1wyt4pz ~]# docker psCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMESb9b35c8473a5 dockercompose-springboot-mysql-nginx_app "/usr/local/bin/mv..." 4 weeks ago Up 4 weeks8080/tcpapp10a7ab286d75 nginx:1.13 "nginx -g 'daemon ..." 4 weeks ago Up 4 weeks0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp v-nginx05665464ec4a mysql/mysql-server:5.7 "/entrypoint.sh --..." 4 weeks ago Up 4 weeks (unhealthy) 0.0.0.0:3306->3306/tcp, 33060/tcpv-mysql
使用docker-compose down
命令关闭时,报错如下:
[root@iz2ze2ixdy0e67ek1wyt4pz dockercompose-springboot-mysql-nginx]# docker-compose downStopping app... errorStopping v-nginx ... errorStopping v-mysql ... errorERROR: for app Cannot stop container b9b35c8473a5a91e628977142a1757173503917479194734ca1b2ab62de47c76: Cannot kill container b9b35c8473a5a91e628977142a1757173503917479194734ca1b2ab62de47c76: rpc error: code = 14 desc = grpc: the connection is unavailableRemoving network dockercompose-springboot-mysql-nginx_defaultERROR: network dockercompose-springboot-mysql-nginx_default has active endpoints[root@iz2ze2ixdy0e67ek1wyt4pz dockercompose-springboot-mysql-nginx]# docker-compose downStopping app... errorStopping v-nginx ... errorStopping v-mysql ... errorERROR: for app Cannot stop container b9b35c8473a5a91e628977142a1757173503917479194734ca1b2ab62de47c76: Cannot kill container b9b35c8473a5a91e628977142a1757173503917479194734ca1b2ab62de47c76: rpc error: code = 14 desc = grpc: the connection is unavailableRemoving network dockercompose-springboot-mysql-nginx_defaultERROR: network dockercompose-springboot-mysql-nginx_default has active endpoints
解决方案:
第一种:
# docker network disconnect -f {network} {endpoint-name},其中的 {endpoint-name} 可以使用命令 docker network inspect {network} 获得然后再做你想做的操作。
第二种:
重启 Docker service# service docker restart。然后再做你想做的操作。
奇思妙想
想法一:随时观察启动日志,少怀疑人生
docker-compose
一键上线,固然很爽
但是当你爽完,发现浏览器不能正常访问,就开始怀疑人生了,所以请随时观察日志
docker logs [容器名称/容器id]docker logs v-mysqldocker logs app