05 docker-compose

docker-compose介绍

是docker官方的开源项目,负责实现对docker容器集群的快速编排,从功能上看,跟openstack中的heat十分类似

compose中有两个重要的概念

  • 服务(service):一个应用的容器,实际上可以包括若干运行相同镜像的容器实例
  • 项目(project):由一个关联的应用容器组成一个完整业务单元,在docker-compose.yml文件中定义

安装

$ sudo curl -L https://github.com/docker/compose/releases/download/1.25.5/dockercompose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

# 测试
docker-compose version

# 卸载
二进制文件,删除即可

wordpress初体验

version: ‘3.0‘
services:
  mysql:
    image: registry.cn-shanghai.aliyuncs.com/baim0/mysql:5.7
    container_name: mysql
    networks:
      - lnmp
    environment:
      - MYSQL_ROOT_PASSWORD=123
      - MYSQL_DATABASE=wordpress
  php:
    image: registry.cn-shanghai.aliyuncs.com/baim0/php7.1:v1
    container_name: php
    networks:
      - lnmp
    volumes:
      - /wordpress:/usr/share/nginx/html
  nginx:
    image: registry.cn-shanghai.aliyuncs.com/baim0/nginx:youhua
    container_name: nginx
    networks:
      - lnmp
    volumes:
      - /wordpress:/usr/share/nginx/html
    ports:
      - "80:80"
    depends_on:
      - php
networks:
  lnmp:

模板介绍

build

context:指定文件路径
dockerfile:指定文件名
args:指定构建时的变量,有点鸡肋,dockerfile里可以指定
# 案例
version: ‘3.0‘
services:
  web: 
    build:
      context: .
      dockerfile: Dockerfile
      args:
        name: 1

command

覆盖容器启动后默认执行的命令

version: ‘3.0‘
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        name: 1
    command: nginx -g "daemon off"

container_name

指定容器名称,默认将会使用项目名称,服务名称,序号这样的格式,相当于--name

container_name: nginx

depends_on

解决容器的依赖、先后启动的问题,先启动redis,db再启动web

version: ‘3‘
services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres

env_file

从文件中获取环境变量,如果与environment指令冲突,后者为准,环境变量文件中必须符合指定格式,支持#开头的注释行

env_file: .env
env_file:
 - ./common.env
 - ./apps/web.env
 - /opt/secrets.env

environment

设置环境变量,你可以用数组或者字典格式

environment:
 RACK_ENV: development
 SESSION_SECRET:
environment:
 - RACK_ENV=development
 - SESSION_SECRET

healthcheck

容器的健康检查,配置在每个服务的那一层

version: ‘2.9‘
services:
  mysql:
    image: registry.cn-shanghai.aliyuncs.com/baim0/mysql:5.7
    container_name: mysql
    networks:
      - lnmp
    environment:
      - MYSQL_ROOT_PASSWORD=123
      - MYSQL_DATABASE=wordpress
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost"]
      interval: 1m30s
      timeout: 10s
      retries: 3

image

为指定镜像名称或镜像ID,如果本地不存在,compose将会拉取这个镜像。

image: ubuntu
image: orchardup/postgresql
image: a4bc65fd

networks

配置容器连接的网络,先指定后使用,与service同层指定

version: ‘2.9‘
services:
  nginx:
    image: registry.cn-shanghai.aliyuncs.com/baim0/nginx:youhua
    container_name: nginx
    networks:
      - lnmp
    volumes:
      - /wordpress:/usr/share/nginx/html
    ports:
      - "80:80"
    depends_on:
      - php
networks:
  lnmp:

ports

暴露端口,使用宿主主机端口

ports:
  - "3000"
  - "8000:8000"
  - "49100:22"
  - "127.0.0.1:8001:8001"

sysctls

设置内核参数

sysctls:
  net.core.somaxconn: 1024
  net.ipv4.tcp_syncookies: 0
sysctls:
  - net.core.somaxconn=1024
  - net.ipv4.tcp_syncookies=0

ulimits

指定容器的ulimits限制数,指定最大进程数为65535,指定文件句柄数为20000

 ulimits:
   nproc: 65535
   nofile:
   soft: 20000
   hard: 40000

volumes

数据卷的挂载路径,可以设置为宿主机路径或者数据卷名称,并且可以设置访问模式

volumes:
  - /var/lib/mysql
  - cache/:/tmp/cache
  - ~/configs:/etc/configs/:ro

如果路径时数据卷名称,必须在文件中配置数据卷

version: "3"
services:
  my_src:
  image: mysql:8.0
  volumes:
    - mysql_data:/var/lib/mysql
volumes:
  mysql_data:

常用命令

# 1. 命令对象与格式
docker-compose [COMMAND] --help
# 2. 命令选项
-f, --file FILE 指定使?的 Compose 模板?件,默认为 docker-compose.yml ,可以多次指定。
-p, --project-name NAME 指定项?名称,默认将使?所在?录名称作为项?名。
--x-networking 使? Docker 的可拔插?络后端特性
--x-network-driver DRIVER 指定?络后端的驱动,默认为 bridge
--verbose 输出更多调试信息。
-v, --version 打印版本并退出。
# 3.命令使?说明
1、up
格式为 docker-compose up [options] [SERVICE...] 。
   # 1、该命令?分强?,它将尝试?动完成包括构建镜像,(重新)创建服务,启动服务,并关联服务相关容器的?系列操作。
   # 2、链接的服务都将会被?动启动,除?已经处于运?状态。
   # 3、可以说,?部分时候都可以直接通过该命令来启动?个项?。
   # 4、默认情况, docker-compose up 启动的容器都在前台,控制台将会同时打印所有容器的输出信息,可以很
   # 5、?便进?调试。
   # 5、当通过 Ctrl-C 停?命令时,所有容器将会停?。
   # 6、如果使? docker-compose up -d ,将会在后台启动并运?所有的容器。?般推荐?产环境下使?该选项。
   # 7、默认情况,如果服务容器已经存在, docker-compose up 将会尝试停?容器,然后重新创建(保持使? volumes-from 挂载的卷),以保证新启动的服务匹配 docker-compose.yml ?件的最新内容
2、down
  此命令将会停? up 命令所启动的容器,并移除?络
3、exec
  进?指定的容器。
4、ps
格式为 docker-compose ps [options] [SERVICE...] 。
列出项?中?前的所有容器。
 选项:
   -q 只打印容器的 ID 信息。
5、restart
格式为 docker-compose restart [options] [SERVICE...] 。
重启项?中的服务。
选项:
   -t, --timeout TIMEOUT 指定重启前停?容器的超时(默认为 10 秒)。
6、rm
格式为 docker-compose rm [options] [SERVICE...] 。
删除所有(停?状态的)服务容器。推荐先执? docker-compose stop 命令来停?容器。
选项:
   -f, --force 强制直接删除,包括?停?状态的容器。?般尽量不要使?该选项。
   -v 删除容器所挂载的数据卷。
7、start
格式为 docker-compose start [SERVICE...] 。
启动已经存在的服务容器。
8、stop
格式为 docker-compose stop [options] [SERVICE...] 。
停?已经处于运?状态的容器,但不删除它。通过 docker-compose start 可以再次启动这些容器。
选项:
   -t, --timeout TIMEOUT 停?容器时候的超时(默认为 10 秒)。
9、top
查看各个服务容器内运?的进程。
10、unpause
格式为 docker-compose unpause [SERVICE...] 。
恢复处于暂停状态中的服务。

05 docker-compose

上一篇:golang 版本的migrate数据迁移工具


下一篇:deepin 20.2.2升级后出现的两个问题