Docker-Compose 是 Docker 的一种编排服务,是一个用于在 Docker 上定义并运行复杂应用的工具,可以让用户在集群中部署分布式应用。

使用一个 Dockerfile 模板文件可以定义一个单独的应用容器,如果需要定义多个容器就需要服务编排。Docker Compose是其中的一种服务编排技术方案,是Docker的官方产品。

Dockerfile 可以让用户管理一个单独的应用容器;而 Compose 则允许用户在一个模板(YAML 格式)中定义一组相关联的应用容器(被称为一个 project,即项目),例如一个 Web 服务容器再加上后端的数据库服务容器等。

参考:Docker 三剑客之 Docker Compose

Docker Compose 介绍

通过 Docker-Compose 用户可以很容易地用一个配置文件定义一个多容器的应用,然后使用一条指令安装这个应用的所有依赖,完成构建。Docker-Compose 解决了容器与容器之间如何管理编排的问题。

Docker Compose 工作原理图
Docker Compose 工作原理图

Compose 中有两个重要的概念:

  • 服务 (service) :一个应用的容器,实际上可以包括若干运行相同镜像的容器实例。
  • 项目 (project) :由一组关联的应用容器组成的一个完整业务单元,在 docker-compose.yml 文件中定义。

一个项目可以由多个服务(容器)关联而成,Compose 面向项目进行管理,通过子命令对项目中的一组容器进行便捷地生命周期管理。

Compose 项目由 Python 编写,实现上调用了 Docker 服务提供的 API 来对容器进行管理。因此,只要所操作的平台支持 Docker API,就可以在其上利用 Compose 来进行编排管理。

Docker Compose 安装

Docker Compose 是 Docker 的独立产品,因此需要安装 Docker 之后在单独安装 Docker Compose .

macOS

macOS下使用homebrew安装之后默认安装好了Docker Compose

1
brew cask install docker

Centos

方法一:

1
2
3
4
5
6
#下载
sudo curl -L https://github.com/docker/compose/releases/download/1.20.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
#安装
chmod +x /usr/local/bin/docker-compose
#查看版本
docker-compose version

方法二:

1
2
3
4
5
6
7
8
9
10
11
#安装pip
yum -y install epel-release
yum -y install python-pip
#确认版本
pip --version
#更新pip
pip install --upgrade pip
#安装docker-compose
pip install docker-compose
#查看版本
docker-compose version

安装完成后执行docker-compose version,输出以下信息,说明安装完成。

1
2
3
4
docker-compose version 1.24.1, build 4667896b
docker-py version: 3.7.3
CPython version: 3.6.8
OpenSSL version: OpenSSL 1.1.0j 20 Nov 2018

一个小例子

源码地址:https://github.com/chenanyu/springboot-docker-demo

创建一个SpringBoot应用

创建于SpringBoot应用,配合Redis记录访问次数。

pom

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

<dependency>
<groupId>redis.clients</groupId>
<artifactId>jedis</artifactId>
</dependency>

DockerController

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@RestController
public class DockerController {

@Autowired
@Lazy
private StringRedisTemplate redisTemplate;

@GetMapping("/")
public String index() {
redisTemplate.opsForValue().increment("request_key", 1);
String times = redisTemplate.opsForValue().get("request_key");
return "Hello Docker! you had request "+times+" times!!!!!!!!!";
}

}

Dockerfile

src/main/docker路径中创建Dockerfile文件.

1
2
3
4
5
6
7
8
9
FROM openjdk:8-jdk-alpine

MAINTAINER chenanyu antchenanyu@163.com

VOLUME /tmp

ADD target/springboot-docker-demo-0.0.3.jar app.jar

ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

docker-compose

在根目录创建docker-compose.yml文件。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
version: '3'
services:
app:
container_name: v-app
restart: always
build: .
working_dir: /app
volumes:
- ./:/app
- ~/.m2:/root/.m2
expose:
- "8080"
depends_on:
- nginx
- redisserver
command: mvn clean spring-boot:run -Dspring-boot.run.profiles=docker
redisserver:
restart: always
container_name: v-redis
image: "redis:alpine"
ports:
- 6379:6379
nginx:
container_name: v-nginx
image: nginx:1.13
restart: always
ports:
- 8081:80
- 443:443
volumes:
- ./nginx:/etc/nginx/conf.d

使用docker-compose命令运行

1
docker-compose up
docker-compose up
docker-compose up

这个时候浏览器访问http://youipaddress:8081,就能看到效果了,访问次数会不断的叠加。

1
Hello Docker! you had request 5 times!!!!!!!!!
nginx
nginx

在macOS中,非root用户是无法使用小于1024的常用端口的。如果开发中需要用到80端口, 就要设置端口转发。
这里就不想麻烦了,使用8081来做测试。

Docker Compose常用命令

  • 使用docker-compose up -d在后台启动服务

    1
    2
    3
    [root@localhost composetest]# docker-compose up -d
    Starting composetest_web_1 ...
    Starting composetest_web_1 ... done
  • 使用docker-compose ps命令查看启动的服务

    1
    2
    3
    4
    5
    [root@localhost composetest]# docker-compose ps
    Name Command State Ports
    -------------------------------------------------------------------------------------
    composetest_redis_1 docker-entrypoint.sh redis ... Up 6379/tcp
    composetest_web_1 python app.py Up 0.0.0.0:5000->5000/tcp
  • 使用docker-compose stop停止服务。

    1
    2
    3
    [root@localhost composetest]# docker-compose stop
    Stopping composetest_web_1 ... done
    Stopping composetest_redis_1 ... done
  • 其他

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    #查看帮助
    docker-compose -h

    # -f 指定使用的 Compose 模板文件,默认为 docker-compose.yml,可以多次指定。
    docker-compose -f docker-compose.yml up -d

    #启动所有容器,-d 将会在后台启动并运行所有的容器
    docker-compose up -d

    #停用移除所有容器以及网络相关
    docker-compose down

    #查看服务容器的输出
    docker-compose logs

    #列出项目中目前的所有容器
    docker-compose ps

    #构建(重新构建)项目中的服务容器。服务容器一旦构建后,将会带上一个标记名,例如对于 web 项目中的一个 db 容器,可能是 web_db。可以随时在项目目录下运行 docker-compose build 来重新构建服务
    docker-compose build

    #拉取服务依赖的镜像
    docker-compose pull

    #重启项目中的服务
    docker-compose restart

    #删除所有(停止状态的)服务容器。推荐先执行 docker-compose stop 命令来停止容器。
    docker-compose rm

    #在指定服务上执行一个命令。
    docker-compose run ubuntu ping docker.com

    #设置指定服务运行的容器个数。通过 service=num 的参数来设置数量
    docker-compose scale web=3 db=2

    #启动已经存在的服务容器。
    docker-compose start

    #停止已经处于运行状态的容器,但不删除它。通过 docker-compose start 可以再次启动这些容器。
    docker-compose stop

参考