本文学习前提:Java, Spring Boot, Docker, Spring Cloud
一、准备工作
1.1 安装Docker环境
这一部分请参考我的另一篇文章《ASP.NET Core on Docker》,本文不再赘述。需要注意的是,如果你是Windows想要安装Docker,Docker for Windows需要64bit Windows 10 Pro,且需要开启Hyper-V。如果你不想开启Hyper-V,而又事先安装了VMware Workstation,可以参考晓晨的《Docker for Windows 使用VMware Station》。
1.2 准备Java镜像
(1)拉取java镜像
# docker pull java => 默认为最新版本的镜像
# docker pull java:8 => 标签为8的java镜像版本
(2)查看java镜像
# docker images java
_PS:_java镜像有点大啊,643MB
二、部署Spring Boot微服务到Docker
2.1 Spring Boot示例准备
这里以一个spring boot应用程序:eureka-service来介绍,它是基于spring cloud eureka的一个服务注册与发现的微服务应用程序,你可以从这里获取其源码。
2.2 快速借助Dockerfile部署到Docker
(1)使用Maven打包项目:执行下面的命令,将其构建成jar包
MVN> mvn clean package
(2)在jar包所在目录,创建Dockerfile文件,并添加以下内容
代码语言:javascript复制# 基于Java8镜像
FROM java:8
# 将本地文件夹挂在到当前容器
VOLUME /tmp
# 复制文件到容器
ADD eureka-service-sn-0.0.1-SNAPSHOT.jar app.jar
RUN bash -c 'touch /app.jar'
# 声明需要暴露的端口
EXPOSE 9000
# 配置容器启动后执行的命令
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
(3)通过FTP工具将jar包和Dockerfile文件一起传送到服务器端,然后通过Shell工具登录并跳转到这个目录下,执行以下命令打包镜像:
# docker build -t edc/discovery-service-eureka:0.0.1 . => 不要忘记这里有个 .
# docker images => 可以看到在Java8的镜像基础之上,针对eureka-service的镜像已准备好
(4)启动镜像:
# docker run --name eureka-service -d -p 8761:8761 edc/service-discovery-eureka:0.0.1
(5)验证是否已成功启动:访问http://docker宿主机IP:8761/,可以正常显示Eureka Server首页。
三、使用Docker Compose编排微服务
3.1 Docker Compose简介
在实际的微服务架构中,一般包含很多个微服务,而且每个微服务都会部署多个实例,如果每个微服务都需要手动启停,那么效率会很低下,维护量也会很大。
Compose是一个用于定义和运行多容器的Docker应用程序的工具,非常适合在开发、测试、构建CI工作流等场景。
Compose的安装请参考:https://docs.docker.com/compose/install/#install-compose
安装后验证如下:# docker-compose --version
PS__:我这里使用的Compose版本是1.22.0
3.2 Docker Compose快速入门示例
首先,我们来了解下使用Compose的3个基本步骤:
- 使用Dockerfile(或其他方式)定义应用程序环境,以便于在任何地方重现该环境
- 在docker-compose.yml文件中定义组成应用程序的服务,以便各个服务在一个隔离的环境中一起运行
- 运行docker-compose up命令,启动并运行整个应用程序
其次,我们仍然以上面的eureka-service为例,来快速实践一下Compose的基本步骤:
(1)打包eureka-service,同上,不再赘述
(2)创建Dockerfile文件,同上,不再赘述
(3)在Dockerfile同一路径下创建docker-compose.yml,并添加以下内容:
代码语言:javascript复制version: '3'
services:
eureka: # 指定服务的名称
build: . # 指定Dockerfile所在路径,注意这里是个 .
ports:
- "8761:8761" # 指定端口映射,类似docker run的-p选项,注意使用字符串形式
(4)通过FTP工具将jar包、dockerfile以及docker-compose.yml一同拷贝到docker宿主机指定文件夹中
(5)在这个目录下执行以下命令,启动容器。
# docker-compose up
PS__:也可以使用docker-compose up -d 来通过后台运行的方式启动并运行这些容器
(6)验证容器是否成功启动:访问http://docker宿主机IP:8761/,可以正常显示Eureka Server首页。
最后,说说Docker Compose将所管理的容器分为三层,分别是工程(Project)、服务(Service)以及容器(Container)。Docker Compose运行目录下的所有文件(docker-compose.yml、extends文件或环境变量文件等)组成一个工程(默认为docker-compose.yml所在目录的目录名称)。一个工程可以包含多个服务,每个服务定义了容器运行的镜像、参数和依赖,一个服务可以包括多个容器实例。
对应上图中的名称,工程名称是eureka-service(对应docker宿主机上的目录名称),该工程包含了1个服务,服务名称是eureka。当执行docker-compose up命令时,启动了eureka服务的1个容器实例eureka_1。
3.3 Docker Compose编排Spring Cloud微服务
这里仍然会采用在2.1节提到的部分示例来(详情请参见github的part5部分)演示,将要编排的微服务列表如下表所示:
微服务项目名称 | 项目微服务中的角色 |
---|---|
eureka-service | 服务发现&注册组件 |
zuul-service | API网关 |
user-service | 服务提供者 |
movie-service | 服务提供者 |
(1)分别通过maven打成jar包,不再赘述。
PS:可以通过使用maven插件来构建docker镜像,需要在pom.xml添加一些内容,这里不阐述,有兴趣的可以百度一下。此外,由于Docker默认网络模式是bridge,各个容器的IP都不相同,因此如果在服务提供者的配置文件中设置了http://localhost:8761/eureka/会无法满足要求。这时,我们可以为Eureka Server所在容器配置一个主机名(例如discover),并让各个微服务使用主机名来访问Eureka Server。所以,这里讲所有微服务关于Eureka地址的配置改为如下内容:
代码语言:javascript复制eureka:
client:
serviceUrl:
defaultZone: http://discovery:8761/eureka/
(2)依次进行build打包docker镜像,这里仍然借助dockerfile,即每个微服务一个dockerfile
(3)编写docker-compose.yml文件
代码语言:javascript复制version: '3'
services:
# 指定服务名称
eureka-service:
# 指定服务所使用的的镜像,后续不再赘述
image: edc/eureka-service:0.0.1
# 暴露端口信息
ports:
- "8761:8761"
zuul-service:
image: edc/zuul-service:0.0.1
# 连接到 eureka-service,这里使用的是SERVICE:ALIAS的形式
links:
- eureka-service:discovery
user-service:
image: edc/user-service:0.0.1
links:
- eureka-service:discovery
movie-service:
image: edc/movie-service:0.0.1
links:
- eureka-service:discovery
(4)执行以下命令启动项目
# docker-compose up -d
PS:这里加上了-d,表示后台运行,否则你的整个屏幕都是日志输出...
最终效果如下图所示:
3.4 Docker Compose编排高可用的Eureka Server
针对Eureka Server,实现高可用的话,也可以通过Compose来编排Eureka Server集群(比如一个2个节点的高可用最小规模集群)。
首先,需要针对Eureka Service的配置文件进行改造,以便通过同样的配置属性就可以实现两个节点的配置,这里仍然使用2.1节中的github中的示例(参见part1部分)。下面是eureka-service-ha-1的配置项,eureka-service-ha-2同理,不再赘述。
代码语言:javascript复制spring:
application:
name: eureka-service-ha-1
---
spring:
# profile=peer1
profiles: peer1
server:
port: 8761
eureka:
instance:
# when profile=peer1, hostname=peer1
hostname: peer1
client:
service-url:
# register self to peer2
defaultZone: http://peer2:8762/eureka
---
spring:
# profile=peer2
profiles: peer2
server:
port: 8762
eureka:
instance:
# when profile=peer2, hostname=peer2
hostname: peer2
client:
service-url:
# register self to peer1
defaultZone: http://peer1:8761/eureka
从上面的配置文件中,两个节点是通过spring.profiles.active来区分配置属性的。
然后,再来编写一个针对高可用eureka server的docker-compose.yml文件:
代码语言:javascript复制version: '3'
services:
# 指定服务名称
eureka-service-ha-1:
hostname: peer1 # 指定hostname
image: edc/eureka-service-ha:0.0.1-SNAPSHOT
links:
- eureka-service-ha-2 # 注册到另一个eureka-service中
ports:
- "8761:8761"
environment:
- spring.profiles.active=peer1
# 指定服务名称
eureka-service-ha-2:
hostname: peer2 # 指定hostname
image: edc/eureka-service-ha:0.0.1-SNAPSHOT
links:
- eureka-service-ha-1 # 注册到另一个eureka-service中
ports:
- "8762:8762"
environment:
- spring.profiles.active=peer2
其他步骤如3.3所述,这里不再进行演示。
3.5 Docker Compose编排可伸缩的微服务
这里仍然以3.3中的movie-service为例,执行以下命令来达到微服务节点的扩展(这里从1个节点变为2个节点):
# docker-compose scale movie-service=2
从上图可以看出,movie-service实例已从1个变为了2个。
同理,要伸缩为1个节点,只需要将2改为1即可,不再赘述。
四、小结
本文极简地介绍了如何通过借助dockerfile的方式部署一个spring boot应用程序到docker,docker compose的快速入门示例以及如何通过docker compose编排spring cloud微服务应用程序,还介绍了实现编排高可用eureka server以及可伸缩的微服务的实现思路。关于docker与docker compose,还有许许多多的内容,其官方文档已经写得非常详细,并对常见的问题也已经有了很多详细的总结,大家可以参见:https://doc.docker.com/compose/faq/ 浏览。此外,十分感谢本文参考资料周立老师著的《Spring Cloud与Docker微服务架构实战(第二版)》,带我快速入门Spring Cloud的世界,谢谢!
参考资料
周立,《Spring Cloud与Docker微服务架构实战(第2版)》
作者:周旭龙
出处:http://edisonchou.cnblogs.com
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文链接。