Docker-17-docker-compose使用案例

述

上文中,对docker-compose做了一个简单的介绍,以及安装,本文将通过一个简单的案例,来进一步了解docker-compose的使用

本文以jpress(Java版的wordPress)这样一个开源网站的部署为例,来了解docker-compose的使用,我们不必关注jpress的实现,在这里我们只需要将之当作一个普通的web应用即可.

准备工作

一共需要两个容器:

• Tomcat
• Mysql

然后需要jpress的war包,下载地址

编写Dockerfile

Tomcat容器中,要下载相关的war等,因此这里编写一个Dockerfile来做这个事.在一个空的文件夹下创建
Dockerfile,内容如下:

FROM tomcat
ADD https://github.com/JpressProjects/jpress/raw/alpha/wars/jpress-web-newest.war /usr/local/tomcat/webapps/
RUN cd /usr/local/tomcat/webapps/ \
    && mv jpress-web-newest.war jpress.war

这个Dockerfile主要内容就是:

1. 基于Tomcat镜像构建容器
2. 下载jpress项目的war包到tomcat的webapps目录下
3. 给jpress项目重命名

编写docker-compose.yml

在相同的目录下创建docker-compose.yml,内容如下:

version: "3.1"
services: 
  web: 
    build: .
    container_name: jpress
    ports: 
      - "8080:8080"
    volumes: 
      - /usr/local/tomcat/
    depends_on: 
      - db
  db: 
    image: mysql
    container_name: mysql
    command: --default-authentication-plugin=mysql_native_password
    restart: always 
    ports: 
      - "3306:3306"
    environment: 
      MYSQL_ROOT_PASSWORD: 123
      MYSQL_DATABASE: jpress

详解

• version: 指定 compose 文件的版本( Compose文件格式有3个版本,分别为1, 2.x 和 3.x目前主流的为 3.x 其支持 docker 1.13.0 及其以上的版本)
• services: 定义所有的service信息,services下面的第一级别的 key 既是一个 service 的名称(如上面的web,db).
• build: 指定包含构建上下文的路径,或作为一个对象，该对象具有 context 和指定的 dockerfile 文件以及 args 参数值
• container_name: 容器名称
• ports: 容器端口映射
• volumes: 挂载数据卷
• depends_on: 上面的值是db,表示该容器依赖于db容器,在启动的时候,会先启动db容器,然后再启动web容器,这只是启动时机的先后问题,并不是说web容器会等db容器完全启动了才会启动
• image: 对于db容器,则使用image来构建,没有使用Dockerfile
• restart: 重启策略
• environment:启动容器时的环境变量,这里配置了数据库root用户的密码以及在启动时创建一个名为jpress的库,environment的配置可以使用字典和数组两种形式

上面的两个文件创建完成之后,就ok了

运行

运行的方式有好几种,但是建议使用up这个终极命令,up命令十分强大,它将尝试自动完成包括构建镜像,（重新）创建服务,启动服务,并关联服务相关容器的一系列操作.对于大部分应用都可以直接通过该命令来启动.

默认情况下,docker-compose up启动的容器都在前台,控制台将会同时打印所有容器的输出信息,可以很方便进行调试,通过 Ctrl-C停止命令时,所有容器将会停止,而如果使用docker-compose up -d命令,
则将会在后台启动并运行所有的容器.一般推荐生产环境下使用该选项.

进入到docker-compose.yml的目录下,执行以下命令:

docker-compose up -d

image

启动完成之后,访问http://localhost:8080/jpress,就可以看到jpress的页面了,如下:

image

停止容器的命令如下:

docker-compose down

踩坑记录

在上面执行docker-compose up -d去启动容器的时候,遇到了一个错误,提示如下:

Unsupported config option for services

解决方案参考地址

原因就是我们上面docker-compose.yml中,指定的version,这个version需要跟docker-compose的版本是对应的,否则是无法解析的,具体的对照信息可以去docker-compose的github中去查看,在release中找到自己的docker-compose版本,然后查看可以使用的version