Docker - Dockerfile - 常见命令简介

概述
1. 感觉是个比较重要的东西
有个疑问
1. 我是先讲 docker build 还是先讲 Dockerfile
  1. 穿插讲
    1. docker build
      1. 最基本的东西
        
        原理
        
        -t
        
        -f
    2. docker file
      1. 各种命令
        
        命令本身
        
        如果需要 docker build 配合, 那就和 docker build 一起讲
准备
1. os
  1. centos7
2. docker
  1. client
    1. 18.09.6
  2. engine
    1. 18.09.6
3. 知识
  1. docker
  2. docker 镜像
  3. shell 编程

1. Dockerfile

概述
1. 简介 Dockerfile
回顾
1. docker 镜像
  1. 概述
    1. docker 容器的模板
  2. 结构
    1. 由若干个 layer 组成
  3. 构建容器机制
    1. 构建时, 自底向上依次构造 layer
      1. 只读模式
    2. 向外提供一个读写层
  4. 创建方式
    1. docker commit
      1. 概述
        
        将当前的容器, 构造成一个镜像
    2. docker build
      1. 概述
        
        由 Dockerfile, 构建一个镜像
    3. 对比
      1. docker commit
        
        方便构建
        
        但是会缺失一些信息
      2. docker build
        
        方便管理
        
        环境及代码
        
        可以用 git 管理
        
        方便移动
        
        方便修改, 结构清晰
  5. 建议
    1. 尽量用 Dockerfile 构建镜像
Dockerfile
1. 概述
  1. docker 构建镜像的源文件
2. 机制
  1. docker 依次读取 Dockerfile 里的命令
  2. 指定的环境
  3. 逐层构建镜像
3. 语法
  1. Dockerfile 语法想对较多
    1. 这个后面慢慢描述

2. docker build

概述
1. docker client 构造镜像
准备
1. 一个 Dockerfile
  1. 记录构建镜像的命令
2. 一个上下文
  1. 准备构建镜像时需要的资源
Dockerfile
1. 例子
```
# 最简单的 Dockerfile
# 文件名为 Dockerfile
FROM ubuntu:14.04
RUN echo 'hello'
```
2. 注意
  1. Dockerfile 的文件名
    1. 默认文件名是 Dockerfile
      1. 如果首字母没有大写, docker 可能会找不到文件
      2. 如果硬要执着名字, 需要 -f 参数来制定
        
        这个后面会讲
    2. Dockerfile 里的命令, 一定要大写
      1. 小写了 docker 不认识
docker build
1. 概述
  1. 构建镜像的命令
  2. 这里简单讲下使用
    1. 其他的参数, 后面会跟 Dockerfile 的语法一起讲
2. 准备
  1. context
    1. 作用
      1. 存放 Dockerfile
      2. 存放 image 需要的其他文件
  2. Dockerfile
    1. 作用
      1. 构建镜像的说明书
  3. 其他
    1. 执行命令时, 需要进入 context 目录
3. 命令执行
  1. 最简单的那种
    1. 命令
```
# 是的, 你没看错, 这就完了...
# 格式: docker build <context>
> docker build .
```
    2. 结果
      1. 镜像生成成功
    3. 问题
      1. 生成的镜像, 没有仓库和 tag 信息, 很难定位
  2. 添加仓库信息定位
    1. 命令
```
# -t 选项, 可以提供 标签 的配置
# 格式: docker build -t <repo>[:tag] <context>
> docker build -t myrepo/image:0.0.1 .
```
    2. 结果
      1. 镜像生成成功
      2. 带有 repo 和 tag 信息
  3. 自定义 Dockerfile 和 context
    1. 命令
```
# 手动指定 Dockerfile 和 context
# 格式: docker build -t <repo>[:tag] -f <DockerfilePath> <context>
> docker build -t myrepo/image:0.0.2 -f /root/myDockerfile /root/context
```
    2. 结果
      1. 镜像生成成功
      2. 使用的是指定的资源

执行结果

结果

> docker build -t <repo>/demo:0.0.2 -f Dockerfile .
Sending build context to Docker daemon  2.048kB
Step 1/2 : FROM ubuntu:latest
 ---> 7698f282e524
Step 2/2 : RUN echo 'hello'
 ---> Using cache
 ---> 331b9ab46190
Successfully built 331b9ab46190
Successfully tagged <repo>/demo:0.0.2

3. Dockerfile 命令简介

概述
1. 简单介绍命令

1. 注释

概述
1. Dockerfile 的注释

格式

# 以 # 开头的行
# 行中出现的 # 则一律不被视为 注释
# 注释不支持 换行

特殊注释
1. 概述
  1. 有部分特殊的注释, 会影响 Dockerfile 的构建
2. 注意
  1. 一类特殊注释, 只能出现一次
  2. 出现的位置, 必须在 FROM 语句之前
  3. 而且格式必须符合要求, 否则就是普通注释
    1. 不能换行
    2. 不能随便加空格
      1. 后跟一个空格
      2. = 前后没有空格
      3. 下面给的例子, 肯定没问题
3. syntax
  1. 概述
    1. Dockerfile 语法指定
  2. 例子
```
# syntax=docker/dockerfile
```
  3. 其他
    1. 需要有 BuildKit 的支持
    2. 默认是 docker/Dockerfile
    3. 具体可用版本, 请查询官方文档
4. escape
  1. 概述
    1. 指定转义字符符号
      1. 这个名字叫啥, 我也不确定
  2. 转义字符
    1. 默认
      1. \ 开头, 后面的一个字符会被转义
    2. 设置
      1. 可以配置成其他的
      2. windows 环境下, 常用 `
  3. 例子
```
# 这个例子
# escape=`
```

2. FROM

概述
1. 指定一个基础镜像
基础镜像
1. 概述
  1. 在某个镜像的基础上, 再构建镜像
2. 作用
  1. 方便构建
    1. 省去基础的准备
  2. 加快速度
    1. 构建直接从新内容开始
    2. 基础层沿用基础镜像的内容
  3. 发展快速
    1. 你的构建, 也可以成为别人构建的基础
示例
```
FROM ubuntu:latest
```
其他
1. 通常在 Dockerfile 第一句
  1. 例外
    1. 注释
      1. 常规注释
      2. syntax
      3. escape
    2. arg
      1. 指定参数
2. from 一定要大写
3. tag
  1. 最好指定明确版本, 不要用 latest

3. ARG

概述
1. 给指定镜像参数
参数
1. 镜像在构建中使用的变量
2. 构建完成后就会无效
3. 构建中如果声明了同名的环境变量, 就会被替代
  1. 环境变量后面会提到
示例1: 定义一个变量, 用来定义基础镜像的版本
1. Dockerfile
```
# Version 0.0.4
ARG version
FROM ubuntu:$version
```
2. 命令
```
# 通过 --build-arg 指定了 version 参数
# -f 指定了 Dockerfile
> docker image build --build-arg version=19.04 -t repo/demo:0.0.4 -f Dockerfile04 .
```
3. 结果
  1. 构建成功
  2. 版本正确
```
> docker image inspect -f '{{.RepoTags}}' repo/demo:0.0.4 
```
4. 其他
  1. 构建中
    1. 命令行中的 step 里, 看到的还是 $version
5. 问题: 万一我忘了加参数, 会怎么样呢
  1. 结果
    1. 生成会报错
  2. 有没有什么好办法呢
    1. 当然有啦, 加默认值
示例2: 为 arg 添加默认值
1. Dockerfile
```
# Version 0.0.5
ARG version=19.04
FROM ubuntu:${version}
```
2. 命令
```
> docker image build -t repo/demo:0.0.5 -f Dockerfile05 .
```
3. 结果
  1. 创建成功
4. 问题1: 如果我又想指定值了, 有办法吗?
  1. 当然有啦
    1. 还是用 --build-arg 指定
5. 问题2: 这个 arg 除了指定 from 的版本信息, 还能干别的吗?
  1. 也可以在其他地方用啊
    1. 马上就开始讲了
示例3: arg 的其他使用
1. Dockerfile
```
# Version 0.0.6
ARG version=19.04
FROM ubuntu:${version}
RUN echo ${version}
```
2. 命令
```
> docker image build -t repo/demo:0.0.6 -f Dockerfile06 .
```
3. 结果
  1. 镜像成功创建
  2. echo 那行, 却没有显示出版本号
4. 问题1: 为什么版本号不见了?
  1. 结果
    1. 作用域问题
      1. from 前面的 arg, 作用域只能到 from 语句
      2. 之后就消失了
    2. ref
      1. 官方文档
      2. Dockerfile 中RUN 命令的ARG 为空问题。
  2. 后续
    1. 如何使用 from 前的 arg
      1. 重新声明即可
        
        # Version 0.0.7 ARG version=19.04 FROM ubuntu:${version} ARG version RUN echo "hello ${version}"
    2. 或者说, 在 from 后面使用 arg
    3. 再者, 还可以直接使用 env
问题: 既然在构建完就无法使用了, 能不能用来存放密码之类的东西
1. 不建议
  1. 虽然重新起来的容器看不到了
  2. 但是可以通过 'docker image history' 查看这个东西

预定义 arg

概述
1. docker 预定义了一些变量

列表

# 本质上只有 四个
# 具体干啥, 我现在还不知道
# 但是乍一看, 是跟 网络相关的
# 这个等以后有机会, 再讲吧
HTTP_PROXY
http_proxy
HTTPS_PROXY
https_proxy
FTP_PROXY
ftp_proxy
NO_PROXY
no_proxy

4. ENV

概述
1. 镜像对应容器的环境变量
环境变量
1. 概述
  1. 由镜像启动容器后, 默认会带一些环境变量
2. 作用
  1. 环境变量可以改变环境的很多东西
    1. 或者说, 改变环境变量, 就能改变系统行为
  2. 而且环境变量这种东西, 一般是所有用户都能获取到的
示例1: 简单使用环境变量
1. Dockerfile
```
# Version 0.0.8
ARG version=19.04
FROM ubuntu:${version}
ARG version
RUN echo "hello ${version}"
ENV var="docker"
RUN echo "hello ${var}"
```
2. 命令
```
> docker image build -t repo/demo:0.0.8 -f Dockerfile08 .
```
3. 结果
  1. 镜像创建成功
  2. 变量成功使用
4. 问题1: 为啥这次一上来就设置 env 的默认值, 不设置可以吗?
  1. 当然可以啦
    1. 但是, 弥补时机, 不太一样
  2. 弥补时机
    1. arg
      1. docker image build
        
        --build-arg
    2. env
      1. docker container run
        
        -e / --env
        
        这个后面应该会找机会讲, 还是有点用的
5. 问题2: 会不会有这种场景, 我的某个 arg 和 env, 值其实是一样的
  1. 场景
    1. arg 和 env 值是一样的
    2. 我想在 build 时确认, 以免后面忘了
  2. 当然可以
    1. arg 和 env 可以联动的
示例2: arg 联动 env
1. Dockerfile
```
# Version 0.0.9
ARG version=19.04
FROM ubuntu:${version}
ARG version
RUN echo "hello ${version}" 
ENV var=${version}
RUN echo "hello ${var}"
```
2. 命令
```
> docker image build -t repo/demo:0.0.9 -f Dockerfile09 .
```
3. 结果
  1. 镜像正常产生
  2. var 也被赋予了 verison 的值
4. 其他
  1. 在这种场景下, env 甚至可以和 arg 重名
    1. 结果
      1. env 被赋予 arg 的值
      2. arg 就没了
5. 问题1: env 可以取消吗
  1. 这个在 shell 里是可以的
  2. 但是 Dockerfile 里, 是否有, 我暂时还没找到...

5. run

概述
1. 执行命令
执行
1. 表面
  1. 执行命令
2. 实际
  1. 将上一层的镜像, 启动为一个容器
  2. 在容器里执行命令
  3. 将执行命令后的容器, 再整成一层新的镜像
模式
1. shell 模式
  1. 概述
    1. 启动一个 shell, 然后执行命令
  2. 默认shell
    1. linux
      1. /bin/sh -c
    2. win
      1. cmd /S /C
  3. 切换 shell
    1. 这个可以通过后面的 SHELL 命令来做
  4. 命令
```
# RUN <command> [<options and args>]
RUN echo "hello, docker."
```
2. exec 模式
  1. 概述
    1. 不启动 shell, 直接执行命令
  2. 不启动 shell
    1. 这个我也看不懂
      1. 官网说的很模糊
      2. 强调的, 也只有 exec 模式取不到环境变量
    2. 好吧, 那我就理解为
      1. 取不到环境变量
      2. 原因可能是害怕某种干扰吧
  3. 命令
```
# 1. 使用 json 的 数组格式
# 2. 命令和参数作为数组的成员
# 3. 空格隔开的, 就是一个参数
# 4. 每个参数, 都要用 "" 引起来
RUN ["echo", "hello, docker."]
# 如果硬要 环境变量
RUN ["/bin/sh", "-c", "echo", "hello, docker."]
```
建议
1. 加速
  1. 因为执行一个 run, 会生成一个容器和镜像
    1. run 越多, 构造时间就越长
  2. 解决
    1. 将多个命令, 写到一个 run 里
```
FROM ubuntu:16.04
RUN apt-get update \
    && apt-get install -y curl \
    && rm -rf /var/lib/apt/lists/*
```

6. shell

概述
1. 指定运行命令的 shell
shell
1. 默认 shell
  1. 上一部分提过
2. 切换 shell
  1. Dockerfile 中可以随时切
3. 问题
  1. 切换 shell, 会不会导致环境变量丢失

命令

# linux
SHELL ["/bin/bash"]
# win
SHELL ["powershell", "-command"]

7. copy

概述
1. 将文件从宿主机拷贝到镜像
拷贝
1. 源
  1. 拷贝的源, 必须在 context 下
    1. 所以路径信息, 都是以context为根的路径
  2. 内容
    1. 文件
    2. 目录
  3. 原内容支持通配符
    1. 通配符不是正则表达式
  4. 解压
    1. 不会做
2. 目的
  1. 拷贝的目的
    1. 文件
      1. 结尾不带 /
    2. 目录
      1. 结尾带 /
  2. 路径
    1. 如果路径不存在, 会自动创建
3. dest 文件权限
  1. 默认
    1. uid 和 gid 都为 0
  2. 命令
```
# 官网上给的例子
# 其他的搭配, 估计只有自己尝试了...
--chown=<userId>:<groupName> 
--chown=<userName> 
--chown=<userId>
--chown=<userId>:<groupId> 
```
4. 权限
  1. 默认 0755
    1. 这个需要用命令改

命令

COPY [--chown=<user>:<group>] <src> ... <dest>

8. add

概述
1. 将文件拷贝到镜像
  1. 来源丰富
  2. 可以解压
拷贝
1. 源
  1. 拷贝的源
    1. context 下, 同 copy
    2. url
  2. 解压
    1. 不会做
  3. 其他
    1. 同 copy
2. 目的
  1. 解压
    1. 源是压缩包
      1. gz 等
      2. 需要去官网确认
    2. 目的
      1. 一个目录
    3. 如果目的有同名文件
      1. 不会覆盖
  2. 其他
    1. 同 copy
3. dest 文件归属
  1. 同 copy
4. 权限
  1. 默认 0755
    1. 这个需要用命令改

命令

# 从 url 获取(不解压)
ADD http://wordpress.org/latest.zip /root/wordpress.zip
# 解压
ADD http://wordpress.org/latest.zip /root/wordpress/

9. cmd

概述
1. 容器启动命令
2. 配合 entrypoint
  1. 这个后面再说
启动命令
1. 启动命令
  1. 时机
    1. 容器启动时执行的命令
  2. 只会有一个
    1. 所以 cmd 命令只有最后一个会生效
  3. 替代
    1. 如果 docker run 指定了启动命令的话
      1. cmd 的命令, 不会再执行
2. 执行模式
  1. shell 模式
    1. 命令
```
# 类似 RUN 
CMD command param1 param2
```
  2. exec 模式
```
 ```
     # 类似 RUN 
     CMD ["executable","param1","param2"]
 ```
```
3. docker run
  1. 没有命令
    1. 执行 cmd
  2. 有命令
    1. 执行 docker run 的命令

10. entrypoint

概述
1. 优先级更高的启动命令
2. 配合 cmd 可以指定命令的默认参数
启动命令
1. 工作模式
  1. shell 模式
    1. 同 run
  2. exec 模式
    1. 同 run
2. 单独使用 entrypoint
  1. 同单独使用 cmd
3. 配合使用
  1. entrypoint
    1. 使用 exec 模式
      1. 第一个参数为, 可执行命令
      2. 后面的参数, 为稳定的参数或者选项
  2. cmd
    1. 使用 exec 模式
      1. 所有参数, 都是 entrypoint 的参数
      2. 如果 cmd 可以执行, 则会覆盖 entrypoint
4. docker run
  1. 没有命令
    1. 执行 entrypoint + cmd
  2. 有命令
    1. 执行 entrypoint + docker run 后面跟的参数
ref
1. 6 Dockerfile指令详解 && ENTRYPOINT 指令

11. label

概述
1. 添加描述信息
描述信息
1. 镜像元数据
命令
```
LABEL maintainer='repo'
```

查看

> docker image inspect -f '{{json .ContainerConfig.Labels}}' repo/demo:0.0.1

12. user

概述
1. 指定默认用户
默认用户
1. 默认执行命令的用户
2. 默认值
  1. root
3. 命令
```
USER <user>[:<group>]
USER <UID>[:<GID>]
```

13. workdir

概述
1. 指定默认目录
默认目录
1. docker 启动后的 pwd
  1. 命令如果不指定路径, 都会以那里为 pwd
2. 默认值
  1. /root/
3. 路径
  1. 绝对路径
    1. / 开头
  2. 相对路径
    1. 直接是路径开头
      1. 相对的是上一个 workdir
  3. 可以解析环境变量
  4. 如果指定到一个空路径
    1. 会主动创建
4. 命令格式
```
WORKDIR /absolutePath
WORKDIR relativePath
```

14. onbuild

概述
1. 触发器
触发器
1. 触发场景
  1. 该镜像察觉到自己作为其他镜像的基础镜像
2. 结果
  1. 执行以 ONBUILD 开头的命令
    1. 可以理解为在 from 语句后, 按顺序执行 onbuild 语句
    2. 然后再执行 Dockerfile 里的语句
命令
```
ONBUILD <otherInstruction>
```

15. volume

概述
1. 添加挂载点
挂载点
1. 概述
  1. 一个路径
  2. 但这个路径下, 会挂载一个卷
2. 机制
  1. Dockerfile
    1. 指定挂载点
  2. 创建镜像
  3. 生成容器
    1. 默认行为
      1. 在 host 生成一个卷
        
        卷名随机
      2. 将这个卷挂载到容器的挂载点
    2. -v
      1. 将 -v 指定的内容, 对接到挂载点
3. 其他
  1. 如果路径不存在, 会在容器里创建

命令

# 列表式
VOLUME /myvol /root/test
# json 式
VOLUME ["/myvol", /root/test]

16. expose

概述
1. 暴露容器端口
暴露容器端口
1. 概述
  1. 指定某个容器端口
  2. 让这个端口在默认的情况下, 暴露出来
2. 暴露
  1. 对容器外可见
3. 机制
  1. expose 某个端口
  2. 启动容器

命令

# 指定端口和协议
# 默认协议是 tcp
# 可以指定 多个
expose <port>[:<protocol>]

创建容器

# 一定要加 -P
# 这样 expose 的端口, 会随机映射到 host 的可用端口上
# 如果没有, 则会别 映射到 null
# 不影响 -p 选项来暴露端口
> docker container run --rm --name demo03 -it -P -p 32769:90/tcp repo/demo:0.0.1

验证

# 可以在 ports 那里, 看到暴露端口
> docker container ls

17. healthcheck

概述
1. 健康检查
健康检查
1. 机制
  1. 定期在容器中执行命令,
  2. 根据执行结果判断容器是否健康
  3. 将健康情况, 反馈到 docker container ps 的 status 栏里
2. 执行机制
  1. 参数
    1. 时间间隔
      1. --interval
      2. 默认值 30 s
    2. 超时时间
      1. --timeout
      2. 默认值 30s
    3. 重试次数
      1. --retries
      2. 默认值 3
  2. 健康状态
    1. starting
      1. 开始状态
    2. healthy
      1. 健康状态
    3. unhealthy
      1. 不健康状态
  3. 注意
    1. 一个镜像, 只能有一个生效的 checkhealth
    2. 如果当前 Dockerfile 里没写, 会继承父镜像的
    3. 如果当前和父镜像都有, 则以当前为准
3. 命令
```
# 拒绝继承, 
CHECKHEALTH NONE
# 简单示例
# 注意, 那个 CMD 是格式, 跟 CMD 命令要区别开
# curl 如果失败, 则容器状态变为 不健康
checkout --interval=10s --timeout=3s --retries=3 CMD curl http://192.168.30.5:5000/v2
```

ps

ref
1. Dockerfile reference
2. docker build
3. Dockerfile HEALTHCHECK详解
4. 书籍
  1. 第一本 docker 书(修订版)
  2. docker 容器与容器云
  3. spring 微服务实战
  4. docker 实践
后续
1. 整理
  1. 花了一晚上整理的内容, 感觉还是有点乱
  2. 想把它拆开
    1. 放一块的话, 内容可能会不全
2. 搭建一些环境, 稍微实战一下
3. 学习容器编排
  1. compose
  2. k8s

posted @ 2019-11-27 18:44 轩辕拾銉阅读(490) 评论(0) 编辑收藏举报

刷新页面返回顶部

轩辕拾銉

无业游民, 不爱画图, 一个废物

Docker - Dockerfile - 常见命令简介

1. Dockerfile

2. docker build

3. Dockerfile 命令简介

1. 注释

后跟一个空格

2. FROM

3. ARG

4. ENV

5. run

6. shell

7. copy

8. add

9. cmd

10. entrypoint

11. label

12. user

13. workdir

14. onbuild

15. volume

16. expose

17. healthcheck

ps

公告