Docker 解释

[TZ时区](https://timezone.mariushosting.com/)

[**Docker 参考文档**](https://docs.docker.com/reference/)
```bash
# 清理 Docker
docker rm $(docker ps --all -q -f status=exited)		# 清理已经停止运行的docker容器
docker system prune		# 删除未使用资源
docker image prune -af		# 强制清理未使用镜像
  -a, --all    # 删除所有没有用的镜像，而不仅仅是临时文件
  -f, --force  # 强制删除镜像文件，无需弹出提示确认
```

## [docker(CLI)](https://docs.docker.com/engine/reference/commandline/docker/)
```bash
docker system df		# 查看 Docker 占用
```

### [docker run](https://docs.docker.com/engine/reference/run/)
```bash
docker exec -it <容器名> bash		# 进入容器
docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

-d, --detach=false         # 指定容器运行于前台还是后台，默认为false
  -i, --interactive=false    # 打开STDIN，用于控制台交互
  -t, --tty=false            # 分配tty设备，该可以支持终端登录，默认为false
  -u, --user=""              # 指定容器的用户
  -a, --attach=[]            # 登录容器（必须是以docker run -d启动的容器）
  -w, --workdir=""           # 指定容器的工作目录
  -c, --cpu-shares=0         # 设置容器CPU权重，在CPU共享场景使用
  -e, --env=[]               # 指定环境变量，容器中可以使用该环境变量
  -m, --memory=""            # 指定容器的内存上限
  -P, --publish-all=false    # 指定容器暴露的端口
  -p, --publish=[]           # 指定容器暴露的端口
  -h, --hostname=""          # 指定容器的主机名
  -v, --volume=[]            # 给容器挂载存储卷，挂载到容器的某个目录
  --volumes-from=[]          # 给容器挂载其他容器上的卷，挂载到容器的某个目录
  --cap-add=[]               # 添加权限，权限清单详见：http://linux.die.net/man/7/capabilities
  --cap-drop=[]              # 删除权限，权限清单详见：http://linux.die.net/man/7/capabilities
  --cidfile=""               # 运行容器后，在指定文件中写入容器PID值，一种典型的监控系统用法
  --cpuset=""                # 设置容器可以使用哪些CPU，此参数可以用来容器独占CPU
  --device=[]                # 添加主机设备给容器，相当于设备直通
  --dns=[]                   # 指定容器的dns服务器
  --dns-search=[]            # 指定容器的dns搜索域名，写入到容器/etc/resolv.conf文件
  --entrypoint=""            # 覆盖image的入口点
  --env-file=[]              # 指定环境变量文件，文件格式为每行一个环境变量
  --expose=[]                # 指定容器暴露的端口，即修改镜像的暴露端口
  --link=[]                  # 指定容器间的关联，使用其他容器的IP、env等信息
  --lxc-conf=[]              # 指定容器的配置文件，只有在指定--exec-driver=lxc时使用
  --name=""                  # 指定容器名字，后续可以通过名字进行容器管理，links特性需要使用名字
  --net="bridge"             # 容器网络设置:
                                # bridge 使用docker daemon指定的网桥
                                # host    //容器使用主机的网络
                                # container:NAME_or_ID  >//使用其他容器的网路，共享IP和PORT等网络资源
                                # none 容器使用自己的网络（类似--net=bridge），但是不进行配置
  --privileged=false         # 指定容器是否为特权容器，特权容器拥有所有的capabilities
  --restart="no"             # 指定容器停止后的重启策略:
                                # no：容器退出时不重启
                                # on-failure：容器故障退出（返回值非零）时重启
                                # always：容器退出时总是重启
  --rm=false                 # 指定容器停止后自动删除容器(不支持以docker run -d启动的容器)
  --sig-proxy=true           # 设置由代理接受并处理信号，但是SIGCHLD、SIGSTOP和SIGKILL不能被代理
```

### docker update
容器创建后通过update命令更新
```bash
docker update --restart=always blynk		# 更新 blynk 为自启动
```

**退出容器：**
<kbd>Ctrl</kbd>+<kbd>D</kbd> 或 `exit` 退出容器，`会杀死容器`
<kbd>Ctrl</kbd>+<kbd>P</kbd> 再按 <kbd>Ctrl</kbd>+<kbd>Q</kbd> 退出容器，`会后台运行`

## [docker-compose](https://docs.docker.com/compose/reference/)
```bash
# 容器运行相关
docker-compose pull		# 下载镜像(可用于更新镜像)
docker-compose up		# 构建、启动容器(-d 后台运行)
docker-compose down [容器名]		# 停止并删除容器(stop + rm)
docker-compose start [容器名]		# 启动指定服务已存在的容器
docker-compose stop [容器名]		# 停止已运行的服务的容器
docker-compose rm [容器名]		# 删除指定服务的容器
docker-compose kill [容器名]		# 强制停止容器
docker-compose build		# 构建或者重新构建服务

# 辅助相关
docker-compose ps		# 列出所有运行容器
docker-compose logs		# 查看服务日志输出
docker-compose port		# 打印绑定的公共端口
	docker-compose port <容器名> 8761		# 以输出 eureka 服务 8761 端口所绑定的公共端口
docker-compose run <命令> bash		# 在一个服务上执行一个命令
docker-compose scale user=3 movie=3		# 设置指定服务运气容器的个数，以 service=num 形式指定
docker compose config <容器项目名>  # 显示出指定项目的配置文件(可以加载变量)
```

### [docker-compose.yml](https://docs.docker.com/compose/compose-file/)
```yaml
➡version: "3"
代表这当前yml文件的语言版本，目前常用的是2.X和3.X版本，主流为3.X版本，可空
➡name: ABC
代表当前项目名字为ABC，可空
➡services：
代表下属层级的都是服务，就是我们的容器
➡s1：容器的hostname，理解为项目内的id，唯一且必填
➡container_names：容器名称，等同于docker run的name，可空
➡image：镜像，等同于docker run的image，必填
➡env_file：环境变量文件，等同于docker run的–env，可空
➡environment：环境变量，等同于docker run的-e，根据项目要求更改
➡volumes：存储卷，等同于docker run的-v，支持绑定和卷，如果是卷需要在下面的volumes去新增。
➡networks：网络，等同于docker run的–net，指定容器所在的网络
➡restart：重启策略，等同于docker run的restart，自定义
➡ports：端口，等同于docker run的-p，自定义
➡depends_on：依赖，等同于docker run的link，表示容器间的依赖关系
➡s2：另外一个容器
➡volumes：容器卷，这里只填写卷模式，如果是绑定模式则在容器内部定义。
➡db1：新建一个叫db1的卷
➡db2：新建一个叫db2的卷
➡networks：➡net1：新建一个叫net1的网络，单个compose项目可以不需要，会自动生成项目名称的网络
```
- version:指定版本(影响格式)
- services:多个容器集合
- build:配置构建时，Compose 会利用它自动构建镜像，该值可以路径/对象
    ```yml
    build: ./dir		# 路径
    ---------------
    build:
        context: ./dir
        dockerfile: Dockerfile		# 指定 Dockerfile 参数
        args:
            buildno: 1
    ```
- command:覆盖容器启动后默认执行的命令
    ```yml
    command: bundle exec thin -p 3000
    ----------------------------------
    command: [bundle,exec,thin,-p,3000]
    ```
- dns:配置 dns 服务器，可以是一个值或列表
    ```yml
    dns: 8.8.8.8
    ------------
    dns:
        - 8.8.8.8
        - 9.9.9.9
    ```
- dns_search:配置 DNS 搜索域，可以是一个值或列表
    ```yml
    dns_search: example.com
    ------------------------
    dns_search:
        - dc1.example.com
        - dc2.example.com
    ```
- environment:环境变量配置，可以用数组或字典两种方式
    ```yml
    environment:  # ⭐推荐,方便阅读
        RACK_ENV: development
        SHOW: 'ture'
    -------------------------
    environment:  # 参数不利于阅读
        - RACK_ENV=development
        - SHOW=ture
    ```
- env_file:从文件中获取环境变量，优先级低于 environment 指定的环境变量
    ```yml
    env_file: .env
    ---------------
    env_file:
        - ./common.env
    ```
- expose:暴露端口，只将端口暴露给连接的服务，而不暴露给主机，用于容器之间调用
    ```yml
    expose:
        - "3000"
        - "8000"
    ```
- image:指定服务所使用的镜像
    ```yml
    image: java
    ```
- network_mode:设置网络模式
    ```yml
    network_mode: "bridge"		# 桥接
    network_mode: "host"		# 主机
    network_mode: "none"		# 无任何网络(单机运行)
    network_mode: "service:[服务名称]"
    network_mode: "container:[容器名称 or 容器id]"		# 连接其他容器,docker-compose 好像不支持
    ```
- network:设置网络
    ```yml
    network:		# 链接网络,可以同时链接多个,需下方配置
      - <连接名称>		# 链接到的网络名称

network:
      <连接名称>:		# 网络名称,可以自定义
        driver:<网络类型>		# 新建网络需设置类型(bridge/host/none)
        external:		# 链接已创建网络,如果是新建则不需要这个关键字
          name: <网络名称>		# 链接的网络名称
    ```
- ports:对外暴露的端口定义，和 expose 对应
    ```yml
    ports:		# 暴露端口信息，"宿主机端口:容器暴露端口/[tcp or udp]"
        - "8763:8763"		# 不加协议默认为 tcp协议
        - "8763:8763/udp"		# 指定位 udp协议
    ```
- links:将指定容器连接到当前连接，可以设置别名，避免ip方式导致的容器重启动态改变的无法连接情况，`如果是同个 docker-compose.yml 文件下创建的容器(同bridge网络)，无须链接就可用主机名访问`
    ```yml
    links:		# 指定服务名称:别名
        - docker-compose-[名称]-server:compose-[名称]
    ```
- working_dir:设置工作目录
    ```yml
    working_dir: /application  # 指定工作目录(内部文件可以挂载进来)
    ```
- volumes:挂载路径/卷，可以指定本地路径，也可以指定卷
    ```yml
    volumes:		# 挂载路径/卷
        - etc/data:/etc/data		# 挂载当前路径下的 etc/data
        - db-data1:/etc/data1		# 挂载 db-data1卷
        - db-data2:/etc/data2		# 挂载 db-data2卷

volumes:		# 生成卷
        db-data1:		# 卷名，可以不设任何参数
        db-data2:		# 卷名
            driver: flocker
            driver_opts:
                size: "10GiB"		# 指定大小
    ```
- container_name:容器名称
    ```yaml
    container_name: qinglong  # 指定容器名称(默认为 文件夹名称_项目名称_1)
    ````
- logs:日志输出信息
    ```yml
    logs:
        --no-color		# 单色输出，不显示其他颜色
        -f, --follow		# 跟踪日志输出，就是可以实时查看日志
        -t, --timestamps		#显示时间戳
        --tail		# 从日志的结尾显示，--tail=200
    ```

## [Dockerfile](https://docs.docker.com/engine/reference/builder/)

## 容器内文件导入/导出
```bash
# 把宿主机上的文件复制到 docker容器内部
docker cp /path/filename <容器id或名称>:/path/filename

# 把 docker容器内部的文件复制到本地
docker cp <容器id或名称>:/path/filename /path/filename
```