1 Docker Compose单机编排
Compose面向项目project
进行管理,一个项目包含多个服务service
,一个服务service
就是一个应用容器,实际上可以运行多个相同镜像的实例。
每次编排一个项目,会同时创建项目专用的bridge网络,该网络下的 DNS
服务器 127.0.0.11
会为容器提供域名解析
,一个项目内的容器可以通过service名称
直接相互访问。
1.1 安装
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
或
访问官方GitHub页面 https://github.com/docker/compose/releases 下载二进制文件
chmod +x /usr/local/bin/docker-compose
1.2 Compose 模板文件
默认的模板文件名称为 docker-compose.yml
或docker-compose.yaml
。
包含version
和services
两大部分,每个service
都必须通过 image 指令指定镜像或 build 指令(需要 Dockerfile)等来自动构建生成镜像。
例子:
version: "3.9"
services:
web:
build: .
ports:
- "5000:5000"
redis:
image: "redis:alpine"
1.2.1 build
指定 Dockerfile
所在文件夹的路径(可以是绝对路径,或者相对 docker-compose.yml
文件的路径)。 Compose 将会利用它自动构建这个镜像,然后使用这个镜像。
- 可以使用
context
指令指定 Dockerfile 所在文件夹的路径。 - 可以使用
dockerfile
指令指定 Dockerfile 文件名。 - 可以使用
arg
指令指定构建镜像时的变量。
例子:
version: '3'
services:
webapp:
build: ./dir
version: '3'
services:
webapp:
build:
context: ./dir
dockerfile: Dockerfile-alternate
args:
buildno: 1
1.2.2 image
指定为镜像名称或镜像 ID,如果镜像在本地不存在,将会远程拉取这个镜像。
version: '3'
services:
webapp:
image: ubuntu
...
image: centos:centos7
...
image: a4bc65fd
1.2.3 depends_on
容器的依赖、在指定容器启动后再启动。以下例子会先启动 redis db 再启动 web
version: '3'
services:
web:
...
depends_on:
- db
- redis
redis:
...
db:
...
1.2.4 environment
设置环境变量,支持数组或字典两种格式。
version: '3'
services:
web:
environment:
RACK_ENV: development
SESSION_SECRET: 123456
db:
environment:
- RACK_ENV=development
- SESSION_SECRET=123456
1.2.5 volumes
数据卷所挂载路径设置
-
HOST-DIR:CONTAINER-DIR[:权限]
格式
version: '3'
services:
web:
volumes:
- /var/lib/mysql
- cache/:/tmp/cache
- ~/configs:/etc/configs/:ro
-
volume名字:CONTAINER-DIR[:权限]
格式,还需要在Compose文件中配置数据卷
version: '3'
services:
web:
volumes:
- mysql_data:/var/lib/mysql
volumes:
mysql_data:
1.2.6 ports
暴露端口信息,[宿主机IP:]宿主机端口:容器端口
格式,或者仅指定容器的端口,宿主机将使用随机端口。
version: '3'
services:
web:
ports:
- "3000"
- "8000:8000"
- "49100:22"
- "127.0.0.1:8001:8001"
1.2.7 command
覆盖容器启动后默认执行的命令,如果容器运行时使用entrypoint
,则command
为entrypoint
命令后续的参数。
version: '3'
services:
web:
command: echo "hello world"
1.2.8 restart
指定容器退出后的重启策略
version: '3'
services:
web:
restart: always
1.2.9 network_mode
设置网络模式,使用和 docker run 的 --network 参数一样的值。
version: '3'
services:
web:
network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"
1.2.10 cap_add, cap_drop
指定容器的内核能力(capacity)分配
例子:让容器拥有所有能力
version: '2.3'
services:
log:
cap_add:
- ALL
例子:让容器去掉某些能力
version: '2.3'
services:
log:
cap_drop:
- CHOWN
- DAC_OVERRIDE
- SETGID
- SETUID
1.2.11 container_name
指定容器名称。默认将会使用 项目目录名称_服务名称_序号
这样的格式。
version: '2.3'
services:
log:
container_name: harbor-log
1.2.12 logging
配置日志选项
version: '2.3'
services:
log:
logging:
driver: "syslog"
options:
syslog-address: "tcp://localhost:1514"
tag: "registry"
driver
代表日志驱动类型,目前支持3种:
- "json-file"
- "syslog"
- "none"
options
配置日志的相关参数
1.3 Compose 命令
1.3.1 up
docker-compose up [options] [SERVICE...]
在项目目录下运行,自动完成包括构建镜像,(重新)创建服务,启动服务,并关联服务相关容器
默认情况,docker-compose up
启动的容器都在前台,控制台将会同时打印所有容器的输出信息。如果使用 docker-compose up -d
,将会在后台启动并运行所有的容器。
使用docker-compose启动的容器名字为docker-compose.yml所在目录名_service名
选项:
-d 在后台运行服务容器。
--no-color 不使用颜色来区分不同的服务的控制台输出。
--no-deps 不启动服务所链接的容器。
--force-recreate 强制重新创建容器,不能与 --no-recreate 同时使用。
--no-recreate 如果容器已经存在了,则不重新创建,不能与 --force-recreate 同时使用。
--no-build 不自动构建缺失的服务镜像。
--scale SERVICE=NUM 设置指定服务运行的容器个数
-t, --timeout TIMEOUT 停止容器时候的超时(默认为 10 秒)。
1.3.2 stop
docker-compose stop [options] [SERVICE...]
在项目目录下运行,停止已经处于运行状态的容器
1.3.3 start
docker-compose start [SERVICE...]
在项目目录下运行,启动已经存在的服务容器
1.3.4 rm
docker-compose rm [options] [SERVICE...]
在项目目录下运行,删除所有(停止状态的)服务容器,推荐先执行 docker-compose stop
命令来停止容器
1.3.5 restart
docker-compose restart [options] [SERVICE...]
在项目目录下运行,重启项目中的服务。
1.3.6 部署ssh+nginx容器例子
准备项目目录
mkdir ~/ssh_nginx
准备docker-compose.yaml
、dockerfile
、health_check.sh
、init.sh
文件
# dockerfile
FROM centos:centos7
RUN mkdir /etc/yum.repos.d/backup \
&& mv /etc/yum.repos.d/*.repo /etc/yum.repos.d/backup \
&& curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo \
&& curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo \
&& yum -y install openssh-server initscripts nginx \
&& /usr/sbin/sshd-keygen
WORKDIR /script
ENV SSH_PWD="123456"
ADD init.sh health_check.sh ./
EXPOSE 22 80
ENTRYPOINT ["/bin/bash", "init.sh"]
HEALTHCHECK --interval=5s --timeout=3s CMD bash health_check.sh
# init.sh
#! /bin/bash
echo $SSH_PWD | passwd --stdin root
/usr/sbin/sshd && /usr/sbin/nginx -g "daemon off;"
# health_check.sh
#! /bin/bash
if curl 127.0.0.1:80 &> /dev/null && ps -ef | grep "/usr/sbin/ssh[d]" > /dev/null ;then
exit 0
else
exit 1
fi
# docker-compose.yaml
version: "3.9"
services:
server1:
build: ./
ports:
- "822:22"
- "880:80"
environment:
SSH_PWD: "centos"
部署容器
cd ~/ssh_nginx && docker-compose up -d
1.3.7 部署wordpress容器例子
准备项目目录
mkdir ~/wordpress
准备docker-compose.yaml
由于项目专用的bridge网络能够提供
service名称
的DNS解析,所以在参数中可以直接使用service名称
,例如WORDPRESS_DB_HOST: db:3306
version: "3.9"
services:
db:
image: mysql:5.7
volumes:
- db_data:/var/lib/mysql
restart: always
environment:
MYSQL_ROOT_PASSWORD: somewordpress
MYSQL_DATABASE: wordpress
MYSQL_USER: wordpress
MYSQL_PASSWORD: wordpress
wordpress:
depends_on:
- db
image: wordpress:latest
volumes:
- wordpress_data:/var/www/html
ports:
- "8000:80"
restart: always
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: wordpress
WORDPRESS_DB_NAME: wordpress
volumes:
db_data: {}
wordpress_data: {}