docker-compose docker启动工具,容器互联
简介:
docker可以一条命令就运行一个配置好的服务器,很是方便。
但是也有一个问题就是,当参数比较多,映射目录比较多,映射端口比较多…………
我以前就是写个脚本,用脚本来启动,很low啊。
也见到一些docker镜像的介绍页有介绍docker-compose,但是因为一直都是小型的应用,也就没认真看这个东西,今天就深入学习一下吧。
Docker Compose是一个用来定义和运行复杂应用的Docker工具
里面的数据结构比我几行脚本清晰的多。而且可以同时启动多个容器,并且是根据依赖关系来先后启动。
比如先启动数据库,再启动博客。
官方说明https://docs.docker.com/compose/
https://docs.docker.com/compose/compose-file/
https://docs.docker.com/compose/compose-file/compose-file-v3/
我学习的版本可能没有官方版本新,看不明白,或有更高级需求的,可以去看官方说明。
一:安装
和安装docker差不多。
安装docker是 dnf install docker
安装docker-compose是 dnf install docker-compose
dnf 是我使用的fedora的包管理工具,根据你的linux版本不同,可能不一样。
在使用CentOS时发现包管理里面没有这个包。
可以用docker官方推荐的方法来安装。
sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
二:无脑试用
创建docker-compose.yml文件
version: '2'
services:
ssh:
image: jackadam/alpine_with_ssh
ports:
- "2222:22"
然后在同目录下执行 docker-compose up -d
这样就启动了一个开放2222端口的apache。
关闭的时候在这里执行 docker-compose down
三:docker-compose命令
Usage:
docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...]
docker-compose -h|--help
Options:
-f, --file FILE Specify an alternate compose file (default: docker-compose.yml)
-p, --project-name NAME Specify an alternate project name (default: directory name)
--verbose Show more output
--no-ansi Do not print ANSI control characters
-v, --version Print version and exit
-H, --host HOST Daemon socket to connect to
--tls Use TLS; implied by --tlsverify
--tlscacert CA_PATH Trust certs signed only by this CA
--tlscert CLIENT_CERT_PATH Path to TLS certificate file
--tlskey TLS_KEY_PATH Path to TLS key file
--tlsverify Use TLS and verify the remote
--skip-hostname-check Don't check the daemon's hostname against the name specified
in the client certificate (for example if your docker host
is an IP address)
--project-directory PATH Specify an alternate working directory
(default: the path of the Compose file)
Commands:
build Build or rebuild services
bundle Generate a Docker bundle from the Compose file
config Validate and view the Compose file
create Create services
down Stop and remove containers, networks, images, and volumes
events Receive real time events from containers
exec Execute a command in a running container
help Get help on a command
images List images
kill Kill containers
logs View output from containers
pause Pause services
port Print the public port for a port binding
ps List containers
pull Pull service images
push Push service images
restart Restart services
rm Remove stopped containers
run Run a one-off command
scale Set number of containers for a service
start Start services
stop Stop services
top Display the running processes
unpause Unpause services
up Create and start containers
version Show the Docker-Compose version information
build 构建或重建服务
help 命令帮助
kill 杀掉容器
logs 显示容器的输出内容
port 打印绑定的开放端口
ps 显示容器
pull 拉取服务镜像
restart 重启服务
rm 删除停止的容器
run 运行一个一次性命令
scale 设置服务的容器数目
start 开启服务
stop 停止服务
up 创建并启动容器
四:docker-compose.yml
简介:
这个就是配置容器启动的参数的。
先看一下官方给的示例:
version: '3.3'
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
ports:
- "8000:80"
restart: always
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: wordpress
volumes:
db_data:
这还是非常方便的,先启动db,然后启动wordpress。
下面逐步解释如何编写docker-compose.yml
https://docs.docker.com/compose/compose-file/
1.基本结构
一个docker-compose.yml包含三大部分:
version services 容器
上面示例中,db 和 wordpress 就是两个容器。
相关内容的第一行,就是容器的名字了。
2.image
在 services 标签下的第二级标签是 web,这个名字是用户自己自定义,它就是服务名称。
image 则是指定服务的镜像名称或镜像 ID。如果镜像在本地不存在,Compose 将会尝试拉取这个镜像。
例如下面这些格式都是可以的:
image: redis
image: ubuntu:14.04
image: tutum/influxdb
image: a4bc65fd
3.bulid
大家也经常使用Dockerfile来自己生成镜像。docker-compose自然也是支持的。
不写image,改为写buile,则是根据dockerfile来生成镜像。
示例代码如下:
build:
context: ../
dockerfile: path/of/Dockerfile
我暂时只用到了
build: .
类似于 docker build .
4.context(配合build)
context 选项可以是 Dockerfile 的文件路径,也可以是到链接到 git 仓库的url,当提供的值是相对路径时,它被解析为相对于撰写文件的路径,此目录也是发送到 Docker 守护进程的 context
5.dockerfile(配合build)
使用此 dockerfile 文件来构建,必须指定构建路径
build:
context: .
dockerfile: Dockerfile-alternate
6.args(配合build)
添加构建参数,这些参数是仅在构建过程中可访问的环境变量
首先, 在Dockerfile中指定参数:
ARG fendo
ARG password
RUN echo "Build number: $fendo"
RUN script-requiring-password.sh "$password"
然后指定 build 下的参数,可以传递映射或列表
build:
context: .
args:
fendo: 1
password: fendo
- fendo=1
- password=fendo
指定构建参数时可以省略该值,在这种情况下,构建时的值默认构成运行环境中的值(还没理解)
args:
- fendo
- password
YAML布尔值(true
,false
,yes
,no
,on
,off
)必须用引号括起来,这样分析器会将它们解释为字符串。
7.container_name
Compose 的容器名称格式是:<项目名称><服务名称><序号>
虽然可以自定义项目名称、服务名称,但是如果你想完全控制容器的命名,可以使用这个标签指定:
container_name: app
8.depends_on
在没启动数据库容器的时候启动了应用容器,这时候应用容器会因为找不到数据库而退出,为了避免这种情况我们需要加入一个标签,就是 depends_on,这个标签解决了容器的依赖、启动先后的问题。
例如下面容器会先启动 redis 和 db 两个服务,最后才启动 web 服务:
version: '3'
services:
web:
build: .
depends_on:
- db
- redis
redis:
image: redis
db:
image: postgres
9.ports
端口映射映射主机端口到容器端口
ports:
- "3000"
- "3000-3005"
- "8000:8000"
- "9090-9091:8080-8081"
- "49100:22"
- "127.0.0.1:8001:8001"
- "127.0.0.1:5000-5010:5000-5010"
- "6060:6060/udp"
- "12400-12500:1240"
10.expose
开放这个服务(容器)的端口
expose:
- "3000"
- "8000"
11.links
较为传统的link,连接本compose文件中的其他容器
web:
links:
- "db"
- "db:database"
- "redis"
12.external_links
扩展连接link,连接非本compose文件的其他容器,就像docker的--link,用来连接公共服务容器,比如说数据库。
external_links:
- redis_1
- project_db_1:mysql
- project_db_1:postgresql
13.networks
由于--link一直说要被淘汰,建议使用network方式配置,类似于docker run --net模式
这个是网络的主配置。
services:
some-service:
networks:
- some-network
- other-network
networks:
some-network:
other-network:
注意:
在networks中声明的网络名称,会自从生成为 Folder_some-network Folder_other-network,即在你设定的网络名称前面加上当前文件夹名,如果想有互相连通的compose,就把yaml放一个文件夹吧,然后使用docker-compose - ***.yaml [command]
如:
14.ALIASES
别名,网络中的别名,可以理解为计算机名。可以同时又多个别名。
services:
some-service:
networks:
some-network:
aliases:
- alias1
- alias3
other-network:
aliases:
- alias2
下面示例展示了3个容器,使用两个网络进行互联的配置。
version: '2'
services:
web:
build: ./web
networks:
- new
worker:
build: ./worker
networks:
- legacy
db:
image: mysql
networks:
new:
aliases:
- database
legacy:
aliases:
- mysql
networks:
new:
legacy:
15.environment
环境变量也就是docker run -e
environment:
RACK_ENV: development
SHOW: 'true'
SESSION_SECRET:963852741
environment:
- RACK_ENV=development
- SHOW=true
- SESSION_SECRET:963852741
16.volumes
卷映射,目录映射,可以:ro 设置为只读
volumes:
# 仅创建目录到宿主机
- /var/lib/mysql
# 创建真实路径到映射
- /opt/data:/var/lib/mysql
# 从compose文件创建相对目录的映射
- ./cache:/tmp/cache
# 在linux用户目录创建映射
- ~/configs:/etc/configs/:ro
# 在目录空间中创建
- datavolume:/var/lib/mysql
17.restart
restart 选项,有下面几种
restart: "no" #从不
restart: always #总是
restart: on-failure #失败时
restart: unless-stopped #除非停止
18.privileged
privileged选项
privileged: true
19.deploy
v3版本新加的参数,部署参数。有什么CPU限制,内存限制………………
因为deploy在使用的时候,有一些限制,但你的compose文件中出现如下配置项时,deploy就无法使用:
build
cgroup_parent
container_name
devices
tmpfs
external_links
links
network_mode
restart
security_opt
stop_signal
sysctls
userns_mode
20:logging
logging可以设置关于日志的东西。
logging:
driver: syslog
options:
syslog-address: "tcp://192.168.0.42:123"
我用到的也就设置日志大小而已。
logging: options:
max-size: "200k"
max-file: "10"
官方文档才是最新最全的。
https://docs.docker.com/compose/compose-file/
五:实例
1.mariadb
mariadb.yaml
version: "3" #版本3 services: #服务 mysql: #服务名mysql image: mariadb #镜像名称 privileged: true #高级权限 tty: true #开一个终端 container_name: mysql #自定义容器名 networks: #网络 - mynet #属于网络mynet ports: #开放端口映射3306-->3306 - 3306:3306 #冒号左边是宿主机开放端口,冒号右边是容器开放端口 environment: #启动变量 MYSQL_ROOT_PASSWORD:123456 #mysql的root密码 volumes: #目录映射 - /storage/mariadb:/var/lib/mysql #映射mariadb的数据库文件存储路径,冒号左边是宿主机路径,冒号右边是容器内路径 networks: #关于网络的服务 mynet: #声明网络mynet
2.wordpress
wordpress.yaml
version: "3" #版本3 services: #服务 wordpress: #服务名wordpress image: wordpress #镜像名称 privileged: true #高级权限 tty: true #开一个终端 container_name: wordpress #自定义容器名 networks: #网络 - mynet #属于网络mynet ports: #开放端口映射80-->80 - 80:80 ##冒号左边是宿主机开放端口,冒号右边是容器开放端口 environment: #启动变量mysql的root密码 WORDPRESS_DB_HOST: mysql #数据库服务器地址,直接用了另一个容器的容器名 WORDPRESS_DB_NAME: wordpress #数据库的库名 WORDPRESS_DB_USER: wordpress #数据库的用户名 WORDPRESS_DB_PASSWORD: wordpress #数据库的密码 volumes: #目录映射 - /storage/wordpress:/var/www/html/wp-content #映射wordpress存储路径(插件,主题,语言包,上传文件),冒号左边是宿主机路径,冒号右边是容器内路径 networks: #关于网络的服务 mynet: #声明网络mynet
3.使用方法
docker-compose -f mariadb.yaml up -d
#后台启动mariadb容器
#使用任意管理工具,连接3306端口,创建给wordpress用的数据库,库名:wordpress,用户名wordpress,密码wordpress,%(任意)主机登录
docker-compose - wordpress.yaml up -d
#后台启动wordpress容器。
由网络mynet来进行两个容器的自动联通。