AurorePaladin
commented
2 years ago MAINTAINER(作者、维护者)设置
通过 MAINTAINER 设置镜像文件的作者或维护者名称。在实际使用中，更加推荐使用 LABEL 标签，因为 LABEL 除了设置作者标签外还可以添加更多其他你需要添加的标签。
MAINTAINER 形式为：
| 形式 | 示例 |
|---|---|
| MAINTAINER <name> | MAINTAINER puxiao |
LABEL(标签)设置
通过 LABEL 设置镜像文件的 label 标签。遵循以下原则：
- 以键值对形式来设置
- 为了可以出现空格，允许使用引号或反斜杠来进行转义
- 允许有多条 LABEL 设置
- 若一条 LBEL 结尾处 出现 \ ，则会将下一行代码 合并到本行中，相当于 跨行符
若要查看镜像文件的 label 标签(同时也是容器的 label 标签)，使用命令：docker inspect imagenamexxx
EXPOSE(端口和协议)设置
通过 EXPOSE 对外通知容器监听的网络端口和使用协议(TCP或UDP)，默认使用TCP协议 。
特别强调：对于端口而言 EXPOSE 仅仅是告知，并不是真正设置端口，真正容器所使用的端口是在 docker run 中 -p 参数来设置端口的。
可以同时添加多条 EXPOSE 设置。
ADD(添加文件)设置
通过 ADD 添加(复制)文件到镜像文件中，被添加(复制)的文件来源是本机资源或远程文件文件或目录，被接收的远程文件拥有600权限(rw-，可读、可写、不可执行)。
ADD 形式有以下2种：
| 形式 | 示例 |
|---|---|
| ADD [--chown=<user>:<group>] <src>... <dest> | 添加文件到某位置，路径不需要双引号包裹 src为文件源URL、dest为镜像文件中的路径 |
| ADD [--chown=<user>:<group>] ["<src>",... "<dest>"] | 路径被双引号包裹，如果路径中有空格只能用这种形式 |
补充说明：
- 若需要拷贝多个文件，则设置多个src路径，以空格为间隔，最后一项必须为 目标目录(即目标路径必须以 / 结尾)
- 若目标路径 是 WORKDIR 目录，可以使用 ./ 代替
- 可以包含通配符 * ？！
- [--chown=<user>:<group>] 为可选参数，且只在 Linux 系统下起作用，目的是改变文件属主(拥有者)
- 如果远程文件有身份验证保护，那么 ADD 将无法顺序执行，只能使用 RUN wget 或 RUN curl
- 如果路径中包含空格，那么需要加上 引号 ""
ADD 添加文件遵循以下原则：
| src路径类型 | 对应含义 |
|---|---|
| 本地文件路径 | 复制该文件到镜像文件中 |
| 本地压缩文件路径(文件格式identidy、gzip、bzip2、xz) | 解压成一个目录，并将该目录复制到镜像文件中 |
| 本地目录路径 | |
| URL文件地址(非 / 结尾) | 下载和复制该文件到镜像文件中 |
| URL压缩文件地址 | 下载，但不会被解压，效果与其他URL文件相同 |
| URL目录地址(以 / 结尾) | 在镜像文件中创建URL中最后的目录，并将URL目录中的文件下载和赋值到镜像文件中 URL目录地址必须包含一个目录，例如http://example.com 并没有包含目录，这是无效的URL路径 |
| dest路径要求 | 补充 |
|---|---|
| dest 是文件路径还是目录，必须和 src 执行结果对应 | src 为本地压缩文件时，dest 对应解压后的文件内容 |
| 如果 src 为目录，则dest 也必须为目录 | |
| 若 dest 本身不存在，则会自动被创建 |
COPY(复制文件)设置
通过 COPY 从上下文目录(本地文件资源或远程URL)中复制文件或目录到容器指定路径里。
形式和 ADD 一样，但是 COPY 仅执行文件复制 即使需要拷贝文件的是压缩文件，也不会尝试进行解压
如果是本地文件，优先考虑使用 COPY 而不是 ADD
COPY 形式为：
| 形式 | 示例 |
|---|---|
| COPY [--chown=<user>:<group>] <src>... <dest> | COPY ./dist ./ 将项目中的 ./dist 目录下的内容拷贝到 虚拟镜像中的 ./ 中， 而 虚拟镜像中的 ./ 其实是指 WORKDIR 设置的项目主目录， 当然也可以不使用 ./ 而是 填写具体的目录，例如 /app |
| COPY [--chown=<user>:<group>] ["<src>",... "<dest>"] | 路径被双引号包裹，如果路径中有空格只能用这种形式 |
同时拷贝多个文件的示例：
WORKDIR /app
#如果拷贝的目标路径是 WORKDIR ，则可以使用 ./ 代替
COPY ./dist ./package.json ./package-lock.json ./.npmrc ./
#为了阅读美观，可以使用 \ 作为换行连接符
COPY ./dist \
./package.json \
./package-lock.json \
./.npmrc \
./VOLUME(匿名数据卷)设置
通过 VOLUME 设置匿名数据卷，若启动容器时忘记挂载数据卷，则会自动挂载到匿名数据卷中。这样做的目的有：
- 避免重要数据因为容器重启而丢失
- 避免容器不断变大
VOLUME 形式为：
| 形式 | 示例 |
|---|---|
| VOLUME <path> | |
| VOLUME ["<path1>", "<path2>"...] |
容器启动时，可通过 -v 参数来修改挂载数据点
WORKDIR(项目虚拟主目录)设置
通过 WORKDIR 来指定本镜像虚拟环境下的项目主目录。将来启动该镜像的容器，默认会从该目录下找执行文件。
注意：为避免冲突，请勿将 WORKDIR 的路径 设置为 常见 Linux 系统默认的目录
WORKDIR 形式：
| 形式 | 示例 |
|---|---|
| WORKDIR <path> |
- 指定的项目主目录无论是否最终使用，都会自动被创建
- 每一个 RUN 命令都新建一层，只有 WORKDIR 创建的目录会一直存在
- 一个 dockerfile 中允许出现多个 WORKDIR，若为相对路径，则每一个 WORKDIR 对应的路径 都将是上一个 WORKDIR 路径累加之后的绝对路径
USER(用户)设置
通过 USER 指定执行后续命令的用户和用户组。
USER 形式为：
| 形式 | 示例 |
|---|---|
| USER |
确保用户和用户组本身已存在
如果不指定，则默认使用 root 用户
Docker常用命令
名词解释
镜像(image)：包含项目运行程序和所需环境的全部文件，为只读文件。
容器(container)：在只读的镜像文件之外添加一个写入层，让原本只读的镜像可以与宿主机之间进行数据交互，实现可读可写。
仓库(depository)：储存镜像文件的仓库，有官方镜像仓库、腾讯云或阿里云镜像仓库、或自己搭建的仓库。
标签(tag)：在 docker 语境下，tag 用来标记镜像文件的版本号或发行标记，tag 的值可以是纯版本号，也可以是其他字符串。
标签(label)：在 docker 语境下，label 用来给镜像文件添加一些描述性信息，在构建 镜像文件时 通过 LABEL 来定义。
镜像ID：安装某镜像时，给该镜像添加的唯一标识符 ID，是一个 12 位的哈希码。
镜像名：镜像默认的名字
镜像别名：为某镜像文件添加一个新的引用名称，所以称为镜像别名。注意只是新增一个引用名，并不是真实复制拷贝一份。
基础命令
查看 docker 支持的命令：docker
查看 docker 信息：docker info
查看 docker 当前版本：docker version
启动 docker ：systemctl start docker
docker 启动项目：docker run xxx
帮助相关
查看帮助：docker --help
查看 某操作 的帮助：docker xxx -help 例如查看 run 相关帮助 docker run --help、docker logs --help、docker ps --help
输出logs相关
查看 logs 帮助：docker logs --help
查看容器日志：docker logs containerxxx
Docker配置文件(daemon.json)
Linux系统，docker 配置文件路径为：/etc/docker/daemon.json
Windows10，docker 桌面版配置文件路径为：c:\users\your-username\.docker\daemon.json
也可以通过点击系统右下角 docker 图标，右键 > settings > docker engine > 右侧内容里修改
使用DockerHub加速器
使用腾讯云或阿里云的 DockerHub 加速器，可以快速拉取 DockerHub 平台上的容器镜像。
Linux系统内，配置步骤如下：
第1步：创建或修改 /etc/docker/daemon.json 文件，并写入以下内容：
第2步：重新加载 守护进程 配置文件
第3步：重启 docker 服务
第4步：验证是否配置生效
若在打印输出的信息中，找到以下信息即表明配置已生效。
Windows10 Docker 桌面版配置方式：
第1步：windows 系统右下角 docker 图标，点击右键，在出现的菜单中点击 Settings。
第2步：在设置面板左侧中，点击 Docker Engine，在右侧文本内容中，将加速地址 "https://e3je0x5v.mirror.aliyuncs.com" 填入到 registry-mirrors 中。
第3步：点击 Apply & Restart，应用并重启 Docker 服务。
第4步：验证是否配置生效
若在打印输出的信息中，找到以下信息即表明配置已生效。
全局DNS配置
创建或修改 /etc/docker/daemon.json 文件，并写入以下内容：
修改镜像文件存放目录
Linux系统内，配置方法
创建或修改 /etc/docker/daemon.json 文件，并写入以下内容：
Windows10 Docker 桌面版配置方式
特别提醒：以下操作仅仅是修改了 Window10 Docker 虚拟机(WSL 2 ) 里静态文件的存放位置，并不是真正 Win10 本地文件系统中的位置。
第1步：windows 系统右下角 docker 图标，点击右键，在出现的菜单中点击 Settings。
第2步：在设置面板左侧中，点击 Docker Engine，在右侧文本内容中，添加参数：
第3步：点击 Apply & Restart，应用并重启 Docker 服务。
以下才是真正 win10下 配置迁移虚拟目录的方法
补充说明：Win10 中虚拟机采用 WSL 2版本，虚拟机文件系统由 WSL 2 管理，因此想更换 docker 的默认镜像文件存放目录，应该通过 WSL 命令来操作。
假设现在我们希望将 docker 默认在 c盘 的虚拟文件存放目录修改到
d:\docker-data\，操作步骤如下：第1步：在终端执行以下命令，查看并确认 本机 docker 使用的是 WSL 2
在终端会打印出：
第2步：关闭 docker 桌面版，或者通过 wsl 关闭
第3步：通过 wsl --export 将原有虚拟目录中的数据，压缩并导出到目标目录中
第4步：注销原有虚拟文件目录
第5步：创建新的虚拟文件目录，并导入原有虚拟目录中的数据(第3步中创建的那个压缩文件)，并设定 WSL 的版本
至此，虚拟目录迁移完成，以后 docker 下载的镜像文件都将存放在这个目录中的 ext4.vhdx 中。 默认的虚拟目录对应的文件
C:\Users\your-user-name\AppData\Local\Docker\wsl\data\ext4.vhdx将不存在。第6步：将之前创建的 d:\docker-data\docker-data.tar 文件删除 (直接用文件夹形式打开目录，找到 .tar 删除即可)
第7步：重启 docker
Dockerfile文件相关
Dockerfile 是一个文本文档，用来存放构建镜像文件过程的全部指令。
Dockerfile 中定义的 “上下文” 指：本地文件路径(file path) 或 Git仓库路径(git url)
基础知识和规范
dockerfile 是用来描述如何去构建镜像文件。
dockerfile 文件遵循以下原则：
(注释)设置
通过 # 来定义注释。dockerfile 内容中，使用 # 开头表示该行为注释，注释不允许换行，注释里的内容不会出现在构建过程中
解析器指令
通过 特殊注释形式，即 使用 # 来定义解析器指令。
解析器指令(可选项)，用来告知 Docker 在使用(解析) dockerfile 文件时 一些解析规则。
以特殊注释形式出现，遵循以下原则：
解析器之转义符
在 dockerfile 中默认转义符为反斜杠 \，若想修改转义符为反引号 ` ，可通过解析器指令修改：
由于默认的 \ 表示可以转义，如果用在命令行尾部，表示 换行连接符，实际构建过程中，会将下一行内容合并到本行。
什么情况下需要将 默认的 转义符 \ 修改为 ` ？
由于 \ 会转义，那么如果在 windows 系统上写路径时需要格外小心，因为路径中的 \ 很可能与预期执行的不一致。如果把 转义符修改为 `，那么此时 \ 就被解释为普通的字符，\ 不在具有转义功能，更加利于 windows 系统路径上的使用。
ENV(环境变量)设置
通过 ENV 来设置环境变量，内容采用 键值对 形式，其他命令行中可以使用 $xxx 或 ${xxx}来使用该变量。不仅构建过程中其他命令行可以使用，在容器中变量也有效可用。
定义形式有2种：
因此后面的值可以有空格、反斜杠等其他字符
value1采用了双引号包裹字符串，value2没有使用双引号，
value2中可以使用 反斜杠来进行字符串转义
在 ${xxx} 形式中，还可以通过 :- 和 :+ 修改返回(使用)值，遵循以下方式：
ENV 定义环境变量遵循以下原则：
环境变量可以用于以下指令中：
STOPSIGNAL、USER、VOLUME、WORKDIR、ONBUILD
ARG(指令变量)设置
通过 ARG 来定义指令变量，内容采用 键值对 形式，仅在构建过程的 FROM 中可以调用。
与环境变量的区别在于：
FROM(基础镜像)设置
通过 FROM 来定义基础镜像，也就是运行程序所需要的基础环境，有以下几种形式：
RUN(执行命令)设置
通过 RUN 在构建过程中执行 shell 语句。形式有以下2种：
n下原则：
CMD(容器启动执行命令)设置
通过 CMD 提供运行容器的默认方法。可以是执行脚本，或者是 指令参数，若不设置 CMD，则必须指定一个 ENTRYPOINT 指令。
CMD 形式有以下3种：
/bin/sh -c "echo "hello world""
ENTRYPOINT(容器启动执行命令)设置
通过 ENTRYPOINT 设置容器运行启动时执行的命令，类似 CMD，CMD 还可以为 ENTRYPOINT 定义变量作为参数。
ENTRYPOINT 形式为：