docker-compose的使用

docker-compose的使用

• • • 一、简介
    • 二、安装与卸载
    • • linux
      • macos、window
      • 卸载
      • 测试安装成功
    • 三、docker compose使用
    • 四、Compose模版文件
    • 五、Compose应用

一、简介

• Compose 项目是 Docker 官方的开源项目，负责实现对 Docker 容器集群的快速编排。
• 其代码目前在 https://github.com/docker/compose 上开源。
• Compose 定位是 「定义和运行多个 Docker 容器的应用（Defining and running multi-container Docker applications）」，其前身是开源项目 Fig。
• 它允许用户通过一个单独的 docker-compose.yml 模板文件（YAML 格式）来定义一组相关联的应用容器为一个项目（project）。
• Compose 中有两个重要的概念：
  • 服务 (service)：一个应用的容器，实际上可以包括若干运行相同镜像的容器实例。
  • 项目 (project)：由一组关联的应用容器组成的一个完整业务单元，在 docker-compose.yml 文件中定
• Compose 的默认管理对象是项目，通过子命令对项目中的一组容器进行便捷地生命周期管理。
• Compose 项目由 Python 编写，实现上调用了 Docker 服务提供的 API 来对容器进行管理。因此，只要所操作的平台支持 Docker API，就可以在其上利用 Compose 来进行编排管理。

二、安装与卸载

linux

• 在 Linux 上的也安装十分简单，从 官方 GitHub Release 处直接下载编译好的二进制文件即可。例如，在 Linux 64 位系统上直接下载对应的二进制包。

$ sudo curl -L https://github.com/docker/compose/releases/download/1.25.5/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

#如果GitHub访问太慢,直接在release中下载对应的linux发行版【docker-compose-linux-x86_64】
#或者下载太慢使用国内代理服务下载（推荐）
sudo curl -L "https://ghproxy.com/https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

#添加执行权限
$ sudo chmod +x /usr/local/bin/docker-compose
#创建软链接
ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

docker-compose历史版本

macos、window

• Compose 可以通过 Python 的包管理工具 pip 进行安装，也可以直接下载编译好的二进制文件使用，甚至能够直接在 Docker 容器中运行。Docker Desktop for Mac/Windows 自带 docker-compose 二进制文件，安装 Docker 之后可以直接使用。

卸载

• 如果是二进制包方式安装的，删除二进制文件即可。

$ sudo rm /usr/local/bin/docker-compose

测试安装成功

$ docker-compose --version
 docker-compose version 1.25.5, build 4667896b

三、docker compose使用

Docker Compose常用命令列表如下：

1.up

docker-compose up [options] [--scale SERVICE=NUM...] [SERVICE...] 

• up命令十分强大，它尝试自动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器的一些列操作。链接的服务都将会被自动启动，除非已经处于运行状态。
• 多数情况下我们可以直接通过该命令来启动一个项目。
• 选项包括：

-d 在后台运行服务容器 
–no-color 不使用颜色来区分不同的服务的控制输出 
–no-deps 不启动服务所链接的容器 
–force-recreate 强制重新创建容器，不能与–no-recreate同时使用 
–no-recreate 如果容器已经存在，则不重新创建，不能与–force-recreate同时使用 
–no-build 不自动构建缺失的服务镜像 
–build 在启动容器前构建服务镜像 
–abort-on-container-exit 停止所有容器，如果任何一个容器被停止，不能与-d同时使用 
-t, --timeout TIMEOUT 停止容器时候的超时（默认为10秒） 
–remove-orphans 删除服务中没有在compose文件中定义的容器 
–scale SERVICE=NUM 设置服务运行容器的个数，将覆盖在compose中通过scale指定的参数

2.ps

• 列出项目中目前的所有容器。
• 选项包括：

-q 只打印容器的ID信息

3. stop

docker-compose stop [options] [SERVICE...]

• 停止已经处于运行状态的容器，但不删除它。
• 选项包括：

-t, --timeout TIMEOUT 停止容器时候的超时（默认为10秒）

4. down

docker-compose down [options]

• 停止和删除容器、网络、卷、镜像，这些内容是通过docker-compose up命令创建的. 默认值删除 容器 网络，可以通过指定 rmi 、volumes参数删除镜像和卷。
• 选项包括：

–rmi type 删除镜像，类型必须是: ‘all’: 删除compose文件中定义的所以镜像；‘local’: 删除镜像名为空的 镜像
-v, --volumes 删除已经在compose文件中定义的和匿名的附在容器上的数据卷 
–remove-orphans 删除服务中没有在compose中定义的容器

5. restart

docker-compose restart [options] [SERVICE...]

• 重启项目中的服务。
• 选项包括：

-t, --timeout TIMEOUT 指定重启前停止容器的超时（默认为10秒）

6. rm

docker-compose rm [options] [SERVICE...] 1

• 删除所有（停止状态的）服务容器。
• 选项包括：

–f, --force 强制直接删除，包括非停止状态的容器 
-v 删除容器所挂载的数据卷

7. start

docker-compose start [SERVICE...]

• 启动已经存在的服务容器。

8. run

docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]

• 在指定服务上执行一个命令。

• 例如：

docker-compose run ubuntu ping www.baidu.com

• 将会执行一个ubuntu容器，并执行ping www.baidu.com命令。
• 默认情况下，如果存在关联，则所有关联的服务将会自动被启动，除非这些服务已经在运行中。该命令类似于启动容器后运行指定的命令，相关卷、链接等都会按照配置自动创建。有两个不同点：

1. 给定命令将会覆盖原有的自动运行命令
2. 不会自动创建端口，以避免冲突

• 如果不希望自动启动关联的容器，可以使用–no-deps选项，例如：

docker-compose run --no-deps web

将不会启动web容器关联的其他容器

选项包括：

-d 在后台运行服务容器 
–name NAME 为容器指定一个名字 
–entrypoint CMD 覆盖默认的容器启动指令 
-e KEY=VAL 设置环境变量值，可多次使用选项来设置多个环境变量
-u, --user="" 指定运行容器的用户名或者uid
–no-deps 不自动启动管理的服务容器 
–rm 运行命令后自动删除容器，d模式下将忽略 
-p, --publish=[] 映射容器端口到本地主机 
–service-ports 配置服务端口并映射到本地主机 
-v, --volume=[] 绑定一个数据卷，默认为空 
-T 不分配伪tty，意味着依赖tty的指令将无法运行 
-w, --workdir="" 为容器指定默认工作目录

9. confifig

docker-compose config [options]

• 验证并查看compose文件配置。
• 选项包括：

–resolve-image-digests 将镜像标签标记为摘要 
-q, --quiet 只验证配置，不输出。 当配置正确时，不输出任何内容，当文件配置错误，输出错误信息 
–services 打印服务名，一行一个 
–volumes 打印数据卷名，一行一个

10. kill

docker-compose kill [options] [SERVICE...]

• 通过发送SIGKILL信号来强制停止服务容器。 支持通过-s参数来指定发送的信号，例如：通过如下指令发送SIGINT信号：

docker-compose kill -s SIGINT

11. create

docker-compose create [options] [SERVICE...] 1

• 为服务创建容器.只是单纯的create，还需要使用start启动compose。

–force-recreate 重新创建容器，即使它的配置和镜像没有改变，不兼容–no-recreate参数 
–no-recreate 如果容器已经存在，不需要重新创建. 不兼容–force-recreate参数 
–no-build 不创建镜像，即使缺失 
–build 创建容器前，生成镜像

12. exec

docker-compose exec [options] SERVICE COMMAND [ARGS...]

• 与 docker exec 命令功能相同，可以通过service name登陆到容器中。
• 选项包括：

-d 分离模式，后台运行命令. 
–privileged 获取特权. 
–user USER 指定运行的用户. 
-T 禁用分配TTY. By default docker-compose exec分配 a TTY. 
–index=index 当一个服务拥有多个容器时，可通过该参数登陆到该服务下的任何服务，例如：docker-compose exec --index=1 web /bin/bash ，web服务中包含多个容器

四、Compose模版文件

模板文件是使用Compose的核心，涉及的指令关键字也比较多，大部分指令与 docker run 相关参数的含义都是类似的。默认的模板文件名称为docker-compose.yml，格式为YAML格式。

比如一个Compose模板文件：

version: "2" 
	services: 
		web:
			images: nginx 
			ports: -"8080:80" 
			volumes: - /usr/local/abc:/usr/local/cba 
#volumes: 
#networks:

Docker Compose的模板文件主要分为3个区域，如下：

• services
  • 服务，在它下面可以定义应用需要的一些服务，每个服务都有自己的名字、使用的镜像、挂载的数据卷、所属的网络、依赖哪些其他服务等等。
• volumes
  • 数据卷，在它下面可以定义的数据卷（名字等等），然后挂载到不同的服务下去使用。
• networks
  • 应用的网络，在它下面可以定义应用的名字、使用的网络类型等等。

五、Compose应用

需求：编写compose模版文件，实现同时启动tomcat、mysql和redis容器。

1、 编写模版文件

# 创建文件夹
mkdir -p /usr/local/mycompose 
#进入文件夹 
cd /usr/local/mycompose 
#创建 docker-compose.yml文件；内容如下 
vi docker-compose.yml

docker-compose.yml文件内容如下（文件内容请从 资料\配置文件\docker-compose.yml 复制）：

version: '3'
services:
  redis1:
    image: redis
    ports:
      - "6379:6379"
    container_name: "redis1"
    networks: 
      - dev
  mysql1:
    image: centos/mysql-57-centos7
    environment:
      MYSQL_ROOT_PASSWORD: "root"
    ports: 
      - "3306:3306"
    container_name: "mysql1"
    networks: 
      - dev
  web1:
    image: tomcat
    ports: 
      - "9090:8080"
    container_name: "web1"
    networks: 
      - dev
      - pro
networks:
  dev:
    driver: bridge
  pro:
    driver: bridge

上面我们声明了3个服务；分别是：redis1、mysql1、web1；并且对3个服务都指定了对应的docker 镜像和端口。

2、启动

#启动前最好把docker重启，不然原来的tomcat/mysql/redis容器也是启动状态的话，那么端口会冲突而启动失败 
systemctl restart docker 

cd /usr/local/mycompose 

docker-compose up 

# 如果后台启动则使用如下命令 
docker-compose up -d 

# 若要停止 
docker-compose stop

可以查看到命令中，创建了两个自定义的网络（mycompose_dev和mycompose_pro），然后创建容器，并「Attaching to …」，将网络应用到服务上。

好啦~今天的学习就到此结束，喜欢的可以三连谢谢！！