Docker-compose
一、YAML 文件格式及编写注意事项
1、yaml简介
YAML 是一种标记语言,它可以很直观的展示数据序列化格式,可读性高。类似于 json 数据描述语言,语法比 json 简单的很多。YAML 数据结构通过缩进来表示,连续的项目通过减号来表示,键值对用冒号分隔,数组用中括号 [] 括起来, hash 用花括号 {} 括起来。
1.1 yaml语法特性
使用 YAML 时需要注意下面事项:
●大小写敏感
●通过缩进表示层级关系
●不支持制表符 tab 键缩进,只能使用空格缩进
●缩进的空格数目不重要,只要相同层级左对齐,通常开头缩进2个空格
●用 # 号注释
●符号字符后缩进1个空格,如冒号 : 、逗号 , 、横杠 -
●如果包含特殊字符用单引号('')引起来会作为普通字符串处理,双引号(""): 特殊字符作为本身想表示的意思
1.2 数据结构
- 对象: 键值对的字典
- 数组: 一组按次序排列的列表
- 纯量: 单个的且不可再分的值
- 布尔值
- 字符串类型
# 纯量
hello
# 数组
- Cat
- Dog
- Goldfish
# 对象
animal: pets
#布尔值
debug: true
debug: false
#字符串类型
name: tom
name: 'tom'
name: "tom"
引号区别
- 单引号(‘’): 特殊字符作为普通字符串处理
- 双引号(“”): 特殊字符作为本身想表示的意思
# 单引号
name: 'Hi,\nTom'
# 双引号
name: "Hi,\nTom"
内置类型列表
# YAML允许使用个感叹号(!)强制转换数据类型
# 单叹号通常是自定义类型,双叹号是内置类型
money: !!str
123
date: !Boolean
true
对应编号 | 内置类型 | 解释说明 |
---|---|---|
1 | !!int | 整数类型 |
2 | !!float | 浮点类型 |
3 | !!bool | 布尔类型 |
4 | !!str | 字符串类型 |
5 | !!null | 空值 |
6 | !!set | 集合 |
7 | !!seq | 列表 |
8 | !!map | 键值表 |
9 | !!binary | 字符串类型 |
10 | !!timestamp | 日期时间类型 |
11 | !!omap /!!pairs | 键值列表 |
2、yaml文件格式
文件名格式以 .yml
或者.yaml
为后缀,用 空格缩进表示字段的层级关系,可读性高,易于人类管理。
一个key有多个值
纵向格式
animal:
- 飞行动物
- 爬行动物
- 水生动物
- 两栖东西
横向格式
animal: ["飞行动物", "爬行动物", "水生动物", "两栖东西"]
#多级字段格式
一级字段:
二级字段1: #yaml格式用 空格缩进 表示字段的层级关系,同一层字段要靠左对齐
二级字段2:
三级字段:
#yaml 格式
human: #序列的映射
- name
- age
- sex
- height
human: #映射的映射
name:
姓: "王"
ming:
- 李白
- 杜甫
age: 24
sex: 男
height: 180
#YAML特殊类型:文本块
# 注意“|”与文本之间须另起一行
# 使用|标注的文本内容缩进表示的块,可以保留块中已有的回车换行
value: -> value: "helloworld"
hello
world
value: | -> value: "hello\nworld" #key: | 表示保留文本块里的换行符
hello
world
# +表示保留文字块末尾的换行
# -表示删除字符串末尾的换行
value: |- -> value: 相当于 echo -n "helloworld"
hello
world
value: |+ -> value: "hello\nworld\n"
hello
world
name: &a yaml #锚点,相当于 a="yaml"
book: *a #引用,相当于 echo $a book: yaml
3、json格式
文件名格式通常是以 .json 为后缀,用 大括号{} 表示字段的层级关系,每层字段除了最后一个字段都要用逗号,结尾,特性:易于api接口解析
# Json格式
{ "字段": "值"}
{ "debug": true } 布尔值类型
{ "ylc": "dashuaige" } 字符串类型
{
"human": { #json格式用 大括号{} 表示字段的层级关系,每层字段除了最后一个字段都要用逗号,结尾
"name": {
"姓": ["王"],
"名":["李白", "杜甫"]
},
"age": ["24"],
"sex": ["男"],
"height": ["180"]
}
}
二、Docker-Compose
1、简介
docker-compose 是实现在单机上对容器集群编排管理的工具。
docker-compose是基于python开发的,能运行docker的平台,都能用docker-compose编排管理容器。
本质就是在yaml格式的docker-compose配置模板文件里定义多个容器的启动参数和依赖关系,并使用docker-compose根据这个模板文件的配置启动和管理容器集群。
传统的容器管理:Dockerfile文件 --> 手动执行 docker build 一个个构建镜像 -> 手动执行 docker run 一个个创建启动容器
编排管理容器:Dockerfile文件 --> 在 docker compose 配置文件里定义好容器启动参数和依赖关系 -> 执行 docker-compose 命令指定配置文件一次性的自动完成所有镜像的构建和容器的创建启动
2、docker-compose的三大概念
项目project -> 包含一个或多个服务service -> 包含一个或多个容器container的镜像、端口映射、环境变量、依赖关系等启动参数
1)默认使用项目的目录名作为project的项目名,支持使用 -p
或 --project-name
来指定项目名称
2)在项目目录里要包含一个 docker-compose 配置模板文件,默认为 docker-compose.yml
,支持使用 -f 或 --file 来指定项目的配置模板文件
3)在配置模板文件里要包含一个或多个服务容器的配置,每个服务要包含容器的名称、镜像、映射端口、挂载点、网络模式、依赖关系等容器启动的配置参数
3、docker-compose配置常用字段
docker run -id [选项] 镜像:标签 [容器启动命令]
字段 | 描述 |
---|---|
build | 指定 Dockerfile 文件名,要指定Dockerfile文件需要在build标签的子级标签中使用dockerfile标签指定 |
dockerfile | 构建镜像上下文路径 |
context | 可以是 dockerfile 的路径,或者是指向 git 仓库的 url 地址 |
image | 指定镜像 |
command | 执行命令,覆盖容器启动后默认执行的命令 |
container_name | –name 指定容器名称,由于容器名称是唯一的,如果指定自定义名称,则无法scale指定容器数量 |
deploy | 指定部署和运行服务相关配置,只能在 Swarm 模式使用 |
environment | 添加环境变量 -e --env |
networks | 指定加入的网络和IP --IP |
network_mode | –network 设置容器的网络模式,如 host,bridge,… |
ports | -p 暴露容器端口,与 -p 相同,但端口不能低于 60 |
volumes | -v 挂载一个宿主机目录或命令卷到容器,命名卷要在顶级 volumes 定义卷名称 |
volumes_from | –volumes-from 从另一个服务或容器挂载卷,可选参数 :ro 和 :rw,仅版本 ‘2’ 支持 |
hostname | -h --hostname 容器主机名 |
sysctls | –sysctl 在容器内设置内核参数 |
links | –link 连接到另外一个容器,- 服务名称[:服务别名] |
privileged | –privileged 用来给容器root权限,注意是不安全的,true | false |
restart | –restart 设置重启策略,no,always,no-failure,unless-stopped |
depends_on | 在使用Compose时,最大的好处就是少打启动命令,但一般项目容器启动的顺序是有要求的,如果直接从上到下启动容器,可能会因为容器依赖问题而启动失败。例如在没启动数据库容器的时候启动应用容器,应用容器会因为找不到数据库而退出。depends_on标签用于解决容器的依赖、启动先后的问题。 |
4、docker-compose 常用命令
docker-compose -f docker-compose.yml <command> -d
-f, --file FILE :使用特定的 compose 模板文件,默认为 docker-compose.yml
-p, --project-name NAME :指定项目名称,默认使用目录名称
-d :在后台运行
字段 | 描述 |
---|---|
build | 重新构建服务 |
ps | 列出容器 |
up | 创建和启动容器 |
exec | 在容器里面执行命令 |
scale | 指定一个服务容器启动数量 |
top | 显示容器进程 |
logs | 查看容器输出 |
down | 删除容器、网络、数据卷和镜像 |
stop/start/restart | 停止/启动/重启服务 |
三、Docker-compose安装
1、Docker Compose 环境安装
Docker Compose 是 Docker 的独立产品,因此需要安装 Docker 之后在单独安装 Docker Compose
方法一:使用docker自带的docker-compose,把它复制到/usr/local/bin/
find / -name "docker-compose"
cp /usr/libexec/docker/cli-plugins/docker-compose /usr/local/bin/
docker-compose -v
方法二:#下载
https://github.com/docker/compose/tags
curl -L https://github.com/docker/compose/releases/download/1.21.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
#安装
chmod +x /usr/local/bin/docker-compose
#查看版本
docker-compose --version
2、创建工作目录,编写相关Dockerfile文件
#创建工作目录
mkdir /opt/compose_lnmp
cd /opt/compose_lnmp
mkdir nginx mysql php
编写创建nginx、mysql、php的镜像的Dockerfile文件
详见我的上一篇博客 【Dockerfile镜像实战】构建LNMP环境并运行Wordpress网站平台
3、编写配置文件docker-compose.yml
编写配置文件docker-compose.yml
使用现有的镜像创建容器(本地/仓库) images: name:tag
或者现场构建,基于Dockerfile
相对于配置模板所在的目录
cd /opt/compose_lnmp
#本次nginx使用现场构建,php和mysql使用本地镜像
vim docker-compose.yml
version: '3'
services:
nginx:
build:
context: ./nginx
dockerfile: Dockerfile
container_name: nginx
ports:
- 80:80
- 443:443
volumes:
- ./nginx/html/:/usr/local/nginx/html/
- ./nginx/nginx.conf:/usr/local/nginx/conf/nginx.conf
networks:
lnmp:
ipv4_address: 172.18.0.10
mysql:
image: mysql:lnmp
container_name: mysql
privileged: true
volumes:
- db-dir:/usr/local/mysql/
networks:
lnmp:
ipv4_address: 172.18.0.20
php:
image: php:lnmp
container_name: php
ports:
- 9000:9000
volumes:
- db-dir:/usr/local/mysql/
- ./nginx/html/:/usr/local/nginx/html/
networks:
lnmp:
ipv4_address: 172.18.0.30
depends_on:
- nginx
- mysql
networks:
lnmp:
driver: bridge
ipam:
config:
- subnet: 172.18.0.0/16
volumes:
db-dir:
4、根据配置文件创建和启动容器
docker-compose -f docker-compose.yml up -d
docker ps -a
cd /opt/
docker-compose ps #必须在docker-compose.yml所在目录执行此命令
5、登录容器,进行相关操作
#登录到Mysql容器
docker exec -it mysql /bin/bash -c "mysql"
#创建wordpress数据库
create database wordpress;
#授权并刷新
grant all privileges on wordpress.* to 'wordpress'@'%' identified by '123456';
grant all privileges on *.* to 'root'@'%' identified by 'abc123';
flush privileges;
#登录到nginx容器
docker exec -it nginx /bin/bash
cd /usr/local/nginx
#修改html目录的属主,否则无法创建配置文件
chown nginx html
6、访问宿主机IP,安装Wordpress
浏览器访问
http://192.168.210.104/wordpress/index.php