一、安装
查看github上的docker-compose
发行版本的地址:
https://github.com/docker/compose/tags
当前最新的版本是1.26.2
。
安装的命令如下:
# 1.拉取
curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# 2.设置文件具备执行权限
chmod +x /usr/local/bin/docker-compose
# 3.查看版本信息
docker-compose -version
实例:
[root@localhost ~]# curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 638 100 638 0 0 1714 0 --:--:-- --:--:-- --:--:-- 1719
100 11.6M 100 11.6M 0 0 22827 0 0:08:56 0:08:56 --:--:-- 24434
[root@localhost ~]# chmod +x /usr/local/bin/docker-compose
[root@localhost ~]# docker-compose -version
docker-compose version 1.26.2, build eefe0d31
二、卸载
# 二进制包方式安装的,删除二进制文件即可
rm /usr/local/bin/docker-compose
三、基本使用
- 查看命令的基本用法
可以使用docker-compose [命令] --help|-h
来实现。
docker-compose build -h
- 命令选项如下
-f,–file FILE指定使用的Compose模板文件,默认为docker-compose.yml,可以多次指定。
-p,–project-name NAME指定项目名称,默认将使用所在目录名称作为项目名。
-x-network-driver 使用Docker的可拔插网络后端特性(需要Docker 1.9 及以后版本)
-x-network-driver DRIVER指定网络后端的驱动,默认为bridge(需要Docker 1.9 及以后版本)
-verbose输出更多调试信息
-v,–version打印版本并退出
- docker-compose常用命令列表
命令 | 说明 |
build | 构建项目中的服务容器 |
help | 获得一个命令的帮助 |
kill | 通过发送SIGKILL信号来强制停止服务容器 |
config | 验证和查看compose文件配置 |
create | 为服务创建容器。只是单纯的create,还需要使用start启动compose |
down | 停止并删除容器,网络,镜像和数据卷 |
exec | 在运行的容器中执行一个命令 |
logs | 查看服务容器的输出 |
pause | 暂停一个服务容器 |
port | 打印某个容器端口所映射的公共端口 |
ps | 列出项目中目前的所有容器 |
pull | 拉取服务依赖的镜像 |
push | 推送服务镜像 |
restart | 重启项目中的服务 |
rm | 删除所有(停止状态的)服务容器 |
run | 在指定服务上执行一个命令 |
scale | 设置指定服务运行的容器个数 |
start | 启动已经存在的服务容器 |
stop | 停止已经处于运行状态的容器,但不删除它 |
top | 显示运行的进程 |
unpause | 恢复处于暂停状态中的服务 |
up | 自动完成包括构建镜像、创建服务、启动服务并关闭关联服务相关容器的一些列操作 |
version | 打印版本信息 |
四、常用命令使用
- 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指定的参数
- ps
格式为:
docker-compose ps [options] [SERVICE...]
列出项目中目前的所有容器。
选项包括:
-q 只打印容器的ID信息
- stop
格式为:
docker-compose stop [options] [SERVICE...]
停止已经处于运行状态的容器,但不删除它。
选项包括:
-t, --timeout TIMEOUT 停止容器时候的超时(默认为10秒)
- down
格式为:
docker-compose down [options]
停止和删除容器、网络、卷、镜像,这些内容是通过docker-compose up命令创建的. 默认值删除 容器 网络,可以通过指定 rmi 、volumes参数删除镜像和卷。
选项包括:
–rmi type 删除镜像,类型必须是: ‘all’: 删除compose文件中定义的所以镜像;‘local’: 删除镜像名为空的
镜像
-v, --volumes 删除已经在compose文件中定义的和匿名的附在容器上的数据卷
–remove-orphans 删除服务中没有在compose中定义的容器
在root目录下,移除root的实例:
[root@localhost ~]# docker-compose down
Stopping root_mysql_1 ... done
Stopping root_php_1 ... done
Removing root_mysql_1 ... done
Removing root_php_1 ... done
Removing root_nginx_1 ... done
Removing network root_web-net
- restart
格式为:
docker-compose restart [options] [SERVICE...]
重启项目中的服务。
选项包括:
-t, --timeout TIMEOUT 指定重启前停止容器的超时(默认为10秒)
- rm
格式为:
docker-compose rm [options] [SERVICE...]
删除所有(停止状态的)服务容器。
选项包括:
–f, --force 强制直接删除,包括非停止状态的容器
-v 删除容器所挂载的数据卷
- start
格式为:
docker-compose start [SERVICE...]
启动已经存在的服务容器。
- 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命令。
将会执行一个ubuntu容器,并执行ping www.baidu.com命令。
默认情况下,如果存在关联,则所有关联的服务将会自动被启动,除非这些服务已经在运行中。该命令类似于启动容器后运行指定的命令,相关卷、链接等都会按照配置自动创建。有两个不同点:
- 给定命令将会覆盖原有的自动运行命令
- 不会自动创建端口,以避免冲突
如果不希望自动启动关联的容器,可以使用–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="" 为容器指定默认工作目录
- config
格式为:
docker-compose config [options]
验证并查看compose文件配置。
选项包括:
–resolve-image-digests 将镜像标签标记为摘要
-q, --quiet 只验证配置,不输出。 当配置正确时,不输出任何内容,当文件配置错误,输出错误信息
–services 打印服务名,一行一个
–volumes 打印数据卷名,一行一个
- kill
格式为:
docker-compose kill [options] [SERVICE...]
通过发送SIGKILL信号来强制停止服务容器。 支持通过-s参数来指定发送的信号,例如:通过如下指令发送SIGINT信号:
docker-compose kill -s SIGINT
- create
格式为:
docker-compose create [options] [SERVICE...]
为服务创建容器.只是单纯的create,还需要使用start启动compose。
选项包括:
–force-recreate 重新创建容器,即使它的配置和镜像没有改变,不兼容–no-recreate参数
–no-recreate 如果容器已经存在,不需要重新创建. 不兼容–force-recreate参数
–no-build 不创建镜像,即使缺失
–build 创建容器前,生成镜像
- 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服务中包含多个容器
五、docker-compose模版文件使用
模板文件是docker-compose
的核心。在文件中,可以根据自己的定义,管理多个容器的操作,包括他们的运行,通信等。模板文件的模式名称是docker-compose.yml
,格式是YAML
合适。
一个模板文件的格式如下
version: "2"
services:
volumes:
networks:
services:
定义应用需要的服务的项目,包括定义服务的名字,镜像,数据卷,所属网络,依赖的其他服务等。
volumes:
这里定义数据卷的名称,供不同服务下的应用使用。
networks:
这里定义网路的名称,供不同的服务下的应用使用。
Docker Compose常用模板文件主要命令:
指令 | 功能 |
build | 指定服务镜像Dockerfile所在路径 |
cap_add,cap_drop | 指定容器的内核能力(capacity)分配 |
command | 覆盖容器启动后默认执行的命令 |
cgroup_parent | 指定父cgroup组,意味着将基础该组的资源限制 |
container_name | 指定容器名称。默认将会使用项目名称服务名称序号这样的格式 |
devices | 指定设置映射关系 |
dns | 自定义DNS服务器。可以是一个值,也可以是一个列表 |
dns_search | 配置DNS搜索域。可以是一个值,也可以是一个列表 |
dockerfile | 指定额外编译镜像的Dockerfile文件,可以通过该指令来指定 |
env_file | 从文件中获取环境变量,可以为单独的文件路径或列表 |
environment | 设置环境变量,可以使用数组或字典两种格式 |
expose | 暴露端口 |
external_links | 链接到docker-compose.yml外部的容器,甚至可以是非Compose管理的外部容器 |
extra_hosts | 指定额外的host名称映射信息 |
image | 指定为镜像名称或镜像ID。如果镜像在本地不存在,Compose将会尝试拉取这个镜像 |
labels | 指定服务镜像Dockerfile所在路径 |
links | 链接到其他服务中的容器 |
log_driver | 指定日志驱动类型,类似于Docker中的–log-driver参数。目前支持三种日志驱动类型:log_driver:“json-file”、 log_driver:“syslog”、log_driver:“none” |
log_opt | 日志驱动的相关参数 |
net | 设置网络模式。参数类似于docker clinet的–net参数一样 |
pid | 跟主机系统共享进程命名空间。打开该选项的容器之间,以及容器和宿主机系统之间可以通过进程ID来相互访问和操作 |
ports | 暴露端口信息 |
security_opt | 指定容器模板标签(label)机制的默认属性(如用户、角色、类型、级别等) |
ulimits | 指定容器的ulimits限制值 |
volumes | 数据卷所挂载路径设置。可以设置宿主机路径(HOST:CONTAINER)或加上访问模式(HOST:CONTAINER:ro) 卷-官方文档 |
这里展示了一个使用模板文件的实例:
version: '1'
services:
redis:
image: redis
ports:
- "6379:6379"
container_name: "redis"
networks:
- dev
mysql:
image: centos/mysql-57-centos7
environment:
MYSQL_ROOT_PASSWORD: "root"
ports:
- "3306:3306"
container_name: "mysql"
networks:
- dev
web:
image: tomcat
ports:
- "9090:8080"
container_name: "web"
networks:
- dev
- pro
networks:
dev:
driver: bridge
pro:
driver: bridge