docker compose 起步

2017-11-03 tech docker 10 mins 3581 字

昨天写完了 Dockerfile，使用 Docker run 将容器启动起来了。今天使用 docker compose 的方式将它启动起来。先前转载过一篇教程，也可以看一看：《Docker Compose工具快速入门》

安装

Compose 目前支持 Linux、macOS、Windows 10 三大平台。 Compose 可以通过 Python 的包管理工具 pip 进行安装，也可以直接下载编译好的二进制文件使用，或在 Docker 容器中运行。

用 pip 安装比较简单：

 pip install -U docker-compose

即可开始使用。

卸载的话使用如下命令：

pip uninstall docker-compose

编写yaml模板文件

接上一篇的dockerfile

模板文件涉及的命令还蛮多的，不过大部分指令跟 docker run 相关参数的含义都是类似的。

来看我编写的 docker-compose.yml。

version: '3'    
services:
  nginx:	  # 镜像名称
    build: .  # 指定 `Dockerfile` 所在文件夹的路径，进行镜像编译。
    ports:    # 暴露端口信息。
     - "18080:80"
    volumes:  # 数据卷所挂载路径设置。
     - /var/local/nginx:/var/local/nginx/conf/vhost
     - /var/local/log/nginx:/var/local/log/nginx
  redis:      # 做个样子顺便写的
    image: "redis:alpine"   # 镜像

这里解释一下常用的这些命令：

build

自动构建这个镜像，然后使用这个镜像
ports

暴露端口信息。

使用 （HOST:CONTAINER）格式，或者仅仅指定容器的端口（宿主将机端口）都可以。
```
  ports:
   - "3000"
   - "8000:8000"
   - "49100:22"
   - "127.0.0.1:8001:8001"
```
volumes

数据卷所挂载路径设置。可以设置宿主机路径（HOST:CONTAINER）或加上访问模式（HOST:CONTAINER:ro）。

该指令中路径支持相对路径。例如
```
  volumes:
   - /var/lib/mysql
   - cache/:/tmp/cache
   - ~/configs:/etc/configs/:ro
```
image

指定为镜像名称或镜像 ID。如果镜像在本地不存在，Compose 将会尝试拉去这个镜像。

例如：
```
  image: ubuntu
  image: orchardup/postgresql
  image: a4bc65fd
```
command

覆盖容器启动后默认执行的命令。
```
  command: echo "hello world"
```

指令列表如下：

更详细的指令解说可以查看这个文档https://yeasy.gitbooks.io/docker_practice/content/compose/yaml_file.html

运行 docker compose

写好 docker-compose.yml 后就是运行了。Compose 命令的基本的使用格式是

docker-compose [-f=<arg>...] [options] [COMMAND] [ARGS...]

命令选项

-f, --file FILE 指定使用的 Compose 模板文件，默认为 docker-compose.yml，可以多次指定。
-p, --project-name NAME 指定项目名称，默认将使用所在目录名称作为项目名。
--x-networking 使用 Docker 的可拔插网络后端特性（需要 Docker 1.9 及以后版本）。
--x-network-driver DRIVER 指定网络后端的驱动，默认为 bridge（需要 Docker 1.9 及以后版本）。
--verbose 输出更多调试信息。
-v, --version 打印版本并退出。

也解释一下常用命令：

`up`

格式为 docker-compose up [options] [SERVICE...]。

该命令十分强大，它将尝试自动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器的一系列操作。

链接的服务都将会被自动启动，除非已经处于运行状态。

可以说，大部分时候都可以直接通过该命令来启动一个项目。

默认情况，docker-compose up 启动的容器都在前台，控制台将会同时打印所有容器的输出信息，可以很方便进行调试。

当通过 Ctrl-C 停止命令时，所有容器将会停止。

如果使用 docker-compose up -d，将会在后台启动并运行所有的容器。一般推荐生产环境下使用该选项。

默认情况，如果服务容器已经存在，docker-compose up 将会尝试停止容器，然后重新创建（保持使用 volumes-from 挂载的卷），以保证新启动的服务匹配 docker-compose.yml 文件的最新内容。如果用户不希望容器被停止并重新创建，可以使用 docker-compose up --no-recreate。这样将只会启动处于停止状态的容器，而忽略已经运行的服务。如果用户只想重新部署某个服务，可以使用 docker-compose up --no-deps -d <SERVICE_NAME> 来重新创建服务并后台停止旧服务，启动新服务，并不会影响到其所依赖的服务。

选项：

-d 在后台运行服务容器。
--no-color 不使用颜色来区分不同的服务的控制台输出。
--no-deps 不启动服务所链接的容器。
--force-recreate 强制重新创建容器，不能与 --no-recreate 同时使用。
--no-recreate 如果容器已经存在了，则不重新创建，不能与 --force-recreate 同时使用。
--no-build 不自动构建缺失的服务镜像。
-t, --timeout TIMEOUT 停止容器时候的超时（默认为 10 秒）。

`build`

格式为 docker-compose build [options] [SERVICE...]。

构建（重新构建）项目中的服务容器。

服务容器一旦构建后，将会带上一个标记名，例如对于 web 项目中的一个 db 容器，可能是 web_db。

可以随时在项目目录下运行 docker-compose build 来重新构建服务。

选项包括：

--force-rm 删除构建过程中的临时容器。
--no-cache 构建镜像过程中不使用 cache（这将加长构建过程）。
--pull 始终尝试通过 pull 来获取更新版本的镜像。

`logs`

格式为 docker-compose logs [options] [SERVICE...]。

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

`ps`

格式为 docker-compose ps [options] [SERVICE...]。

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

选项：

-q 只打印容器的 ID 信息。

更详细的指令解说可以查看这个文档https://yeasy.gitbooks.io/docker_practice/content/compose/commands.html