docker-compose终端常用命令

Posted by     "麦子" on Thursday, 2019年04月25日

[TOC]

转载: https://blog.csdn.net/Anumbrella/article/details/80877643

Compose作用

Compose项目是Docker官方的开源项目,负责实现对Docker容器集群的快速编排。它是一个定义和运行多容器的docker应用工具。使用compose,你能通过YMAL文件配置你自己的服务,然后通过一个命令,你能使用配置文件创建和运行所有的服务。

Compose使用的模板文件就是一个YAML格式文件,它允许用户通过一个docker-compose.yml来定义一组相关联的应用容器为一个项目(project)。

在Compose中有两个重要的概念:

服务(service)

一个应用的容器,实际上可以包括若干运行相同镜像的容器实例。

服务(service)就是在它下面可以定义应用需要的一些服务,代表配置文件中的每一项服务。每个服务都有自己的名字、使用的镜像、挂载的数据卷、所属的网络、依赖哪些其他服务等等,即以容器为粒度,用户需要Compose所完成的任务。

项目(project)

由一组关联的应用容器组成的一个完成业务单元,在docker-compose.yml中定义。

项目(project)代表用户需要完成的一个项目,即是Compose的一个配置文件可以解析为一个项目,即Compose通过分析指定配置文件,得出配置文件所需完成的所有容器管理与部署操作。

Compose ,DockerFile区别

Dockerfile 是一个 配置文件,里面可以放多条处理命令,一次配置好了可以简化后续的部分操作。需要注意的是,一个 Dockerfile 只能包含一个基础镜像,就像函数一样,一个配置文件只干一件事。

对于需要用到多个容器的应用,Docker 也提供了更强大的工具 Compose 来管理容器。

Compose常用命令

build

构建(重新构建)项目中的服务容器。

格式为:

docker-compose build [options] [--build-arg key=val...] [SERVICE...]

选项包括:

–compress 通过gzip压缩构建上下环境
–force-rm 删除构建过程中的临时容器
–no-cache 构建镜像过程中不使用缓存
–pull 始终尝试通过拉取操作来获取更新版本的镜像
-m, --memory MEM 为构建的容器设置内存大小
–build-arg key=val 为服务设置build-time变量

kill

通过发送SIGKILL信号来强制停止服务容器。

格式为:

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

支持通过-s参数来指定发送的信号,例如通过如下指令发送SIGINT信号:
docker-compose kill -s SIGINT

config

验证并查看compose文件配置。

格式为:

docker-compose config [options]

选项包括:

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

create

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

格式为:

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

选项包括:

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

down

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

格式为:

docker-compose down [options]

选项包括:

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

exec

docker exec命令功能相同,可以通过service name登陆到容器中。

格式为:

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

选项包括:

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

logs

查看服务容器的输出。默认情况下,docker-compose将对不同的服务输出使用不同的颜色来区分。可以通过–no-color来关闭颜色。

格式为:

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

pause

暂停一个服务容器。

格式为:

docker-compose pause [SERVICE...]

port

显示某个容器端口所映射的公共端口。

格式为:

docker-compose port [options] SERVICE PRIVATE_PORT

选项包括:

–protocol=proto 指定端口协议,TCP(默认值)或者UDP
–index=index 如果同意服务存在多个容器,指定命令对象容器的序号(默认为1)

ps

列出项目中目前的所有容器。

格式为:

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

选项包括: 

-q 只打印容器的ID信息

pull

拉取服务依赖的镜像。

格式为:

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

选项包括:

–ignore-pull-failures 忽略拉取镜像过程中的错误
–parallel 多个镜像同时拉取
–quiet 拉取镜像过程中不打印进度信息

push

推送服务依的镜像。

格式为:

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

选项包括:

–ignore-push-failures 忽略推送镜像过程中的错误

restart

重启项目中的服务。

格式为:

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

选项包括:

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

rm

删除所有(停止状态的)服务容器。

格式为:

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

选项包括:

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

run

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

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

格式为:

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

例如:
docker-compose run ubuntu ping www.anumbrella.net
#将会执行一个ubuntu容器,并执行ping www.anumbrella.net命令。

选项包括:

-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="" 为容器指定默认工作目录

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

docker-compose run --no-deps web
将不会启动web容器关联的其他容器。

scale

设置指定服务运行的容器个数。通过service=num的参数来设置数量。例如:

docker-compose scale web=3 db=2
将启动3个容器运行web服务,2个容器运行db服务。一般情况下,当指定书目多于该服务当前实际运行容器,将新创建并启动容器;反之,将停止容器。

格式为:

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

选项包括:

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

start

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

格式为:

docker-compose start [SERVICE...]

stop

停止已经处于运行状态的容器,但不删除它

格式为:

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

选项包括:

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

top

显示各个容器运行的进程情况。

格式为:

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

unpause

恢复处于暂停状态中的服务。

格式为:

docker-compose unpause [SERVICE...]

up

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

格式为:

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

选项包括:

-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指定的参数

version

格式为:

docker-compose version

「真诚赞赏,手留余香」

真诚赞赏,手留余香

使用微信扫描二维码完成支付