【docker】docker-compose.yml 文件详解

1.docker-compose.yml 文件详解 

--默认的模板名是docker-compose.yml
--文件格式示例：
version: "3.1" -- 指定compose 文件的版本
services: --定义所有的service 信息
mysql: -- 服务名字
restart: always --定义容器重启策略，always 无论如何容器都会重启
image: 192.168.1.11:443/myharbor/mysql:5.7.21 -- 指定docker 镜像, 可以是远程仓
库镜像、本地镜像
container_name: app-mysql --指定容器的名称(等同于docker run --name 的作用)
ports: -- 建立宿主机和容器之间的端口映射关系, ports 支持两种语法格式，
- 13306:3306 --容器的3306 端口和宿主机的13306 端口建立映射关系
# - "3000" 暴露容器的3000 端口, 宿主机的端口由docker 随机映射一个没有被占用的端口
# - "3000-3005" 暴露容器的3000 到3005 端口, 宿主机的端口由docker 随机映射没有被占用的端口
# "127.0.0.1:8001:8001" # 指定映射宿主机的指定地址的
# - "6060:6060/udp" # 指定协议
#ports: #v3.2 新增的语法格式
#- target: 3306 # 容器端口
# published: 13306 # 宿主机端口
# protocol: tcp # 协议类型
# mode: host # host 在每个节点上发布主机端口, ingress 对于群模式端口进行负载均衡
networks: -- 定义networks 信息
- overlay -- overlay 驱动程序创建一个跨多个节点命名的网络
environment: --设置环境变量， environment 的值可以覆盖env_file 的值(等同于
docker run --env 的作用)
- MYSQL_ROOT_PASSWORD=rootroot
- TZ=Asia/Shanghai
command: --覆盖容器启动后默认执行的命令, 支持shell 格式和[] 格式
--character-set-server=utf8mb4
--collation-server=utf8mb4_general_ci
--explicit_defaults_for_timestamp=true
--lower_case_table_names=1
--max_allowed_packet=128M
--sql-mode="STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION,NO_ZERO_DATE,NO_ZERO_IN_DATE,ERROR_FOR_DIVISION_BY_ZERO"
volumes: --定义容器和宿主机的卷映射关系, 其和networks 一样可以位于services 键的二级键和compose 顶级键, 如果需要跨服务间使用则在顶级键定义, 在services 中引用
- /data/mysql/data:/data/mysql/data

2.volumes 的简短语法格式示例:

volumes:
- /var/lib/mysql # 映射容器内的/var/lib/mysql 到宿主机的一个随机目录中
- /data/mysql:/var/lib/mysql # 映射容器内的/var/lib/mysql 到宿主机的/data/mysql
- ~/configs:/etc/configs/:ro # 映射容器宿主机的目录到容器中去,权限只读
- mysqlvolume:/var/lib/mysql # mysqlvolume 为volumes 顶级键定义的目录, 
	--在此处直接调用

3.volumes 的新版本语法格式示例

--(v3.2 新增的语法格式，和K8S 类似)
volumes:
- type: volume --mount 的类型, 必须是bind、volume 或tmpfs
	source: mysqdata --宿主机目录
	target: /var/lib/mysql --容器目录
	volume: --配置额外的选项, 其key必须和type 的值相同
	nocopy: true -- volume 额外的选项,在创建卷时禁用从容器复制数据
- type: bind -- volume 模式只指定容器路径即可, 宿主机路径随机生成; bind 需要指定容器和宿主机的映射路径
	source: /data/mysql/data/
	target: /var/lib/mysql
	read_only: true --设置文件系统为只读文件系统
volumes:
	mysqdata: --定义在volume, 可在所有服务中调用

4.关于布署参数说明

tomcat:
restart: always
image: tomcat:20220529
container_name: app-tomcat
ports:
- 8080:8080
environment:
- TZ=Asia/Shanghai
networks:
- overlay
volumes:
- /data/tomcat/webapps:/usr/local/tomcat/webapps
- /data/tomcat/logs:/usr/local/tomcat/logs
deploy:
replicas: 2 --deploy 的mode 为replicated 时, 指定容器副本的数量
update_config: --用于配置滚动更新配置
parallelism: 2 --一次性更新的容器数量
delay: 10s --更新一组容器之间的间隔时间
restart_policy: --定义容器重启策略, 用于代替restart 参数
condition: on-failure --只有当容器内部应用程序出现问题才会重启

--模板文件是Compose 的核心，涉及的指令关键字比较多，
--但是大部分的指令与docker run 相关的