前言

在上一篇文章docker常用命令的实践与解析中，我们提到了可以使用commit命令来在本地创建镜像，但是commit创建的镜像其实是不够正规的，第三方无法了解镜像创建的过程，所以只能作为我们在本地归档的一种方法，用commit创建的镜像在实际生产过程中是无法上传到公司仓库的，举一个简单的例子，我们在我们的镜像中隐藏一个挖矿脚本，如果用commit来打包，那么公司安全部门只能拿到我们最终生成的镜像，假如生产环境引入我们的镜像，那就会给公司服务器造成不必要的负担，也会引起其他的麻烦。这种前提下，公司可以要求开发者使用DockerFile来创建镜像，同时要求必须使用公司仓库已经存在的镜像作为base image，那这样安全部门只需要拿到我们的DockerFile文件来分析即可，在DickerFile通过审核之后，也可以直接用DickerFile文件来构建镜像上传，这样就隔离了开发者与仓库，避免了一些安全问题，同时由于DockerFile文件也有记录的功能，在镜像出现问题后，也可以更好的排查错误。

文章目录

DockerFile相关
命令
- FROM
- - 相关
  - 通式
  - 注意
- RUN
- - 相关
  - 通式
  - 注意
- CMD
- - 相关
  - 通式
  - 注意
- LABEL
- - 相关
  - 通式
  - 注意
- MAINTAINER
- - 相关
  - 通式
- ENV
- - 相关
  - 通式
  - 注意
- ADD
- - 相关
  - 通式
  - 注意
- COPY
- - 相关
  - 通式
- ENTRYPOINT
- - 相关
  - 通式
  - 注意
- VOLUME
- - 相关
  - 通式
- WORKDIR
- - 相关
  - 通式
- ARG
- - 相关
  - 通式
- ONBUILD
- - 相关
  - 通式
- HEALTHCHECK
- - 相关
  - 通式
  - EXPOSE
  - 相关
  - 通式
- USER
- - 相关
  - 通式
  - 注意
实战
- 需求
- 前期准备
- - base image 选型
  - consul选型
- Dockerfile
- docker-entrypoint.sh
- start.sh
- 构建并启动
总结

DockerFile相关

DockerFile官方文档

docker系统可以通过DockerFile文档来自动构建镜像，DockerFile是一个包含了所有用户用以组装镜像的命令的文本文档。

命令

FROM

通式

FROM的用法通常是以下三种

FROM [--platform=<platform>] <image> [AS <name>]

FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]

FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

注意

1.ARG命令是唯一允许出现在FROM命令之前的命令，其具体用法在下文描述
2.FROM可以在单个Dockerfile中多次出现，以创建多个映像或将一个构建阶段用作对另一个构建阶段的依赖。只需在每个新的FROM指令之前记录一次提交输出的最后一个图像ID。每个FROM指令清除由先前指令创建的任何状态。
3.通过将AS名称添加到FROM指令中，可以选择为新的构建阶段指定名称。该名称可以在后续的FROM和COPY --from = <名称>指令中使用，以引用此阶段中构建的映像。
4.tag或digest是可选的。如果您忽略其中任何一个，那么缺省情况下构建器将采用最新标签。如果构建器找不到合适的标签值，则返回错误。
5.在FROM引用多平台镜像的情况下，可设置--platform标志可用于指定镜像的平台。例如linux/amd64，linux/arm64或Windows/amd64。默认情况下，使用构建请求的平台类型。

RUN

通式

RUN <command>

RUN ["executable", "param1", "param2"]
executable：一个可执行的脚本文件
param1、param2：executable所传入的参数

注意

每一条RUN命令都会生成一个中间镜像，在一般情况下，建议将RUN下可以合成一条的指令合并在一起，如：

RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'

CMD

通式

CMD command param1 param2

CMD ["executable","param1","param2"]

CMD ["param1","param2"]

注意

一个Dockerfile中仅能够存在一条CMD命令，若存在多条，将只执行最后一条

LABEL

通式

LABEL <key>=<value> <key>=<value> <key>=<value> ...

注意

如果当前设置的LABEL数据与父镜像的LABEL数据冲突了，将覆盖父镜像的LABEL对应数据

MAINTAINER

通式

MAINTAINER <name>

ENV

通式

ENV <key>=<value> ...

注意

1.在docker run命令中，可以通过-e或者--env来替换Dockerfile中设置的ENV参数值
2.使用docker inspect命令也可以看到环境变量中的值

ADD

通式

ADD [--chown=<user>:<group>] <src>... <dest>
ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

ADD指令从复制新文件、目录或远程文件，并将它们添加到路径处的映像文件系统中。

可以指定多个资源，但如果它们是文件或目录，则它们的路径被解释为相对于构建上下文的源。

还可以是一个通配符，比如

ADD hom* /mydir/

注意

ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>。
ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。

COPY

通式

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

ENTRYPOINT

通式

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2

注意

如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令，仅最后一个生效。

VOLUME

通式

VOLUME ["/data"]

WORKDIR

通式

WORKDIR /path/to/workdir

ARG

通式

ARG <name>[=<default value>]

ONBUILD

通式

ONBUILD <INSTRUCTION>

HEALTHCHECK

通式

HEALTHCHECK [选项] CMD <命令>：设置检查容器健康状况的命令
HEALTHCHECK NONE：如果基础镜像有健康检查指令，使用这行可以屏蔽掉其健康检查指令
HEALTHCHECK [选项] CMD <命令> : 这边 CMD 后面跟随的命令使用，可以参考 CMD 的用法。

EXPOSE

通式

EXPOSE <port> [<port>/<protocol>...]

USER

通式

USER <user>[:<group>]
USER <UID>[:<GID>]

注意

相关的user或group已经在容器中存在了

实战

现在我将在我的服务器上新建一个dockerfile文件，并对其进行构建。

需求

新建一个镜像，封装consul注册中心，开箱即用。

因为我最近正在做相关的工作，所以使用的这个例子，如果之前没有接触过consul的安装，可以自行去查找资料，这有利于你理解下面的内容

前期准备

base image 选型

这里我们使用的是官方的alpine，alpine是一个基于Alpine Linux的Docker镜像，只有5MB，有许多组件都是用这个作为base image。

consul选型

选择当前较新的1.9.1—2021.1.2

Dockerfile

# Set the base image
FROM alpine:3.12# This is the release of Consul to pull in.
ENV CONSUL_VERSION=1.9.1# This is the location of the releases.
ENV HASHICORP_RELEASES=https://releases.hashicorp.com# Create a consul user and group first so the IDs get set the same way, even as
# the rest of this may change over time.
RUN addgroup consul && \adduser -S -G consul consul# Set up certificates, base tools, and Consul.
# libc6-compat is needed to symlink the shared libraries for ARM builds
# Set the shell
# e: if return 0 exit,
# u: when an undefined variable is used during execution, an error message is displayed,
# x: after the instruction is executed, the instruction and its parameters will be displayed first.
RUN set -eux && \# apk: the package tool in alpine# install curl dumb-init gnupg libcap openssl su-exec iputils jq libc6-compat apk add --no-cache ca-certificates curl dumb-init gnupg libcap openssl su-exec iputils jq libc6-compat && \gpg --keyserver pgp.mit.edu --recv-keys 91A6E7F85D05C65630BEF18951852D87348FFC4C && \mkdir -p /tmp/build && \cd /tmp/build && \# choose a system apkArch="$(apk --print-arch)" && \case "${apkArch}" in \aarch64) consulArch='arm64' ;; \armhf) consulArch='armhfv6' ;; \x86) consulArch='386' ;; \x86_64) consulArch='amd64' ;; \*) echo >&2 "error: unsupported architecture: ${apkArch} (see ${HASHICORP_RELEASES}/consul/${CONSUL_VERSION}/)" && exit 1 ;; \esac && \# get consulwget ${HASHICORP_RELEASES}/consul/${CONSUL_VERSION}/consul_${CONSUL_VERSION}_linux_${consulArch}.zip && \wget ${HASHICORP_RELEASES}/consul/${CONSUL_VERSION}/consul_${CONSUL_VERSION}_SHA256SUMS && \wget ${HASHICORP_RELEASES}/consul/${CONSUL_VERSION}/consul_${CONSUL_VERSION}_SHA256SUMS.sig && \# check the consulgpg --batch --verify consul_${CONSUL_VERSION}_SHA256SUMS.sig consul_${CONSUL_VERSION}_SHA256SUMS && \grep consul_${CONSUL_VERSION}_linux_${consulArch}.zip consul_${CONSUL_VERSION}_SHA256SUMS | sha256sum -c && \# unzip the consulunzip -d /bin consul_${CONSUL_VERSION}_linux_${consulArch}.zip && \cd /tmp && \# delete the temp filerm -rf /tmp/build && \gpgconf --kill all && \apk del gnupg openssl && \rm -rf /root/.gnupg && \# tiny smoke test to ensure the binary we downloaded runsconsul version# The /consul/data dir is used by Consul to store state. The agent will be started
# with /consul/config as the configuration directory so you can add additional
# config files in that location.
RUN mkdir -p /consul/data && \mkdir -p /consul/config && \chown -R consul:consul /consul# set up nsswitch.conf for Go's "netgo" implementation which is used by Consul,
# otherwise DNS supercedes the container's hosts file, which we don't want.
RUN test -e /etc/nsswitch.conf || echo 'hosts: files dns' > /etc/nsswitch.conf
# Expose the consul data directory as a volume since there's mutable state in there.
VOLUME /consul/data# Server RPC is used for communication between Consul clients and servers for internal
# request forwarding.
EXPOSE 8300# Serf LAN and WAN (WAN is used only by Consul servers) are used for gossip between
# Consul agents. LAN is within the datacenter and WAN is between just the Consul
# servers in all datacenters.
EXPOSE 8301 8301/udp 8302 8302/udp# HTTP and DNS (both TCP and UDP) are the primary interfaces that applications
# use to interact with Consul.
EXPOSE 8500 8600 8600/udp# Consul doesn't need root privileges so we run it as the consul user from the
# entry point script. The entry point script also uses dumb-init as the top-level
# process to reap any zombie processes created by Consul sub-processes.
COPY ./docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
ENTRYPOINT ["docker-entrypoint.sh"]# By default you'll get an insecure single-node development server that stores
# everything in RAM, exposes a web UI and HTTP endpoints, and bootstraps itself.
# Don't use this configuration for production.
CMD ["agent", "-dev", "-client", "0.0.0.0"]

docker-entrypoint.sh

#!/usr/bin/dumb-init /bin/sh
set -e# Note above that we run dumb-init as PID 1 in order to reap zombie processes
# as well as forward signals to all processes in its session. Normally, sh
# wouldn't do either of these functions so we'd leak zombies as well as do
# unclean termination of all our sub-processes.
# As of docker 1.13, using docker run --init achieves the same outcome.# You can set CONSUL_BIND_INTERFACE to the name of the interface you'd like to
# bind to and this will look up the IP and pass the proper -bind= option along
# to Consul.
CONSUL_BIND=
if [ -n "$CONSUL_BIND_INTERFACE" ]; thenCONSUL_BIND_ADDRESS=$(ip -o -4 addr list $CONSUL_BIND_INTERFACE | head -n1 | awk '{print $4}' | cut -d/ -f1)if [ -z "$CONSUL_BIND_ADDRESS" ]; thenecho "Could not find IP for interface '$CONSUL_BIND_INTERFACE', exiting"exit 1fiCONSUL_BIND="-bind=$CONSUL_BIND_ADDRESS"echo "==> Found address '$CONSUL_BIND_ADDRESS' for interface '$CONSUL_BIND_INTERFACE', setting bind option..."
fi# You can set CONSUL_CLIENT_INTERFACE to the name of the interface you'd like to
# bind client intefaces (HTTP, DNS, and RPC) to and this will look up the IP and
# pass the proper -client= option along to Consul.
CONSUL_CLIENT=
if [ -n "$CONSUL_CLIENT_INTERFACE" ]; thenCONSUL_CLIENT_ADDRESS=$(ip -o -4 addr list $CONSUL_CLIENT_INTERFACE | head -n1 | awk '{print $4}' | cut -d/ -f1)if [ -z "$CONSUL_CLIENT_ADDRESS" ]; thenecho "Could not find IP for interface '$CONSUL_CLIENT_INTERFACE', exiting"exit 1fiCONSUL_CLIENT="-client=$CONSUL_CLIENT_ADDRESS"echo "==> Found address '$CONSUL_CLIENT_ADDRESS' for interface '$CONSUL_CLIENT_INTERFACE', setting client option..."
fi# CONSUL_DATA_DIR is exposed as a volume for possible persistent storage. The
# CONSUL_CONFIG_DIR isn't exposed as a volume but you can compose additional
# config files in there if you use this image as a base, or use CONSUL_LOCAL_CONFIG
# below.
CONSUL_DATA_DIR=/consul/data
CONSUL_CONFIG_DIR=/consul/config# You can also set the CONSUL_LOCAL_CONFIG environemnt variable to pass some
# Consul configuration JSON without having to bind any volumes.
if [ -n "$CONSUL_LOCAL_CONFIG" ]; thenecho "$CONSUL_LOCAL_CONFIG" > "$CONSUL_CONFIG_DIR/local.json"
fi# If the user is trying to run Consul directly with some arguments, then
# pass them to Consul.
if [ "${1:0:1}" = '-' ]; thenset -- consul "$@"
fi# Look for Consul subcommands.
if [ "$1" = 'agent' ]; thenshiftset -- consul agent \-data-dir="$CONSUL_DATA_DIR" \-config-dir="$CONSUL_CONFIG_DIR" \$CONSUL_BIND \$CONSUL_CLIENT \"$@"
elif [ "$1" = 'version' ]; then# This needs a special case because there's no help output.set -- consul "$@"
elif consul --help "$1" 2>&1 | grep -q "consul $1"; then# We can't use the return code to check for the existence of a subcommand, so# we have to use grep to look for a pattern in the help output.set -- consul "$@"
fi# If we are running Consul, make sure it executes as the proper user.
if [ "$1" = 'consul' -a -z "${CONSUL_DISABLE_PERM_MGMT+x}" ]; then# If the data or config dirs are bind mounted then chown them.# Note: This checks for root ownership as that's the most common case.if [ "$(stat -c %u "$CONSUL_DATA_DIR")" != "$(id -u consul)" ]; thenchown consul:consul "$CONSUL_DATA_DIR"fiif [ "$(stat -c %u "$CONSUL_CONFIG_DIR")" != "$(id -u consul)" ]; thenchown consul:consul "$CONSUL_CONFIG_DIR"fi# If requested, set the capability to bind to privileged ports before# we drop to the non-root user. Note that this doesn't work with all# storage drivers (it won't work with AUFS).if [ ! -z ${CONSUL_ALLOW_PRIVILEGED_PORTS+x} ]; thensetcap "cap_net_bind_service=+ep" /bin/consulfiset -- su-exec consul:consul "$@"
fiexec "$@"

start.sh

一个启动脚本

docker stop $(docker ps -q)
docker rm consul-1
docker build --rm -t consul:centos-1.0 .
docker run -it -p 8500:8500 --name consul-1  consul:centos-1.0

构建并启动

将以上三个文件放到同一个文件夹下，执行start.sh脚本，确认无误后访问yourIp:8500

此时就已经在你的服务器上搭建了一个consul节点，不过是以dev模式启动的。

总结

这一篇文章浪费了两个周，其中大部分时间浪费在了base image的选型上，最后是参考官方的Dockerfile才解决了问题。

总体上来说，入门不算难，难的是写好一个Dockerfile需要比较深厚的shell基础。

文章中有一些细节没有写出来，如果你在跟着做的过程中出现了问题，欢迎私信我交流。
我是Baldwin，一个25岁的程序员，致力于让学习变得更有趣！
现在关注作者即可领取海量学习资料与简历模板

往期好文：

用Python每天给女神发一句手机短信情话

MySQL优化之explain

Spring源码分析-MVC初始化

春风得意马蹄疾，一文看尽（JVM）虚拟机

造轮子的艺术

源码阅读技巧

Java注解详解

教你自建SpringBoot服务器

更多文章请点击

Docker从入门到放弃-----Dockerfile常用命令解析与实战（使用docker制作一个开箱即用的consul镜像）相关推荐

Docker（二）安装及常用命令
1.安装 1.安装虚拟机VMWare 链接:https://pan.baidu.com/s/1Xl7ENUm2gapPOFs-iXHpRQ 提取码:eubm 2.下载centos,我下的是这个版本的 ...
【Docker学习笔记二】Docker安装、运行流程与常用命令
上一篇Blog详细介绍了Docker为什么会出现,是为了解决什么问题而出现:Docker的基本组成部分.架构.本篇Blog就来详细了解下Docker如何安装.卸载以及常用的操作命令有哪些.因为Dock ...
Docker常用命令使用详解（docker help、version、info、images）（一）
Docker常用命令命令描述 docker .docker help.docker --help 列出可用命令 docker version 显示Docker版本信息 docker info 显示 ...
［转］VBA常用命令解析之001——On Error（将错就错）
VBA常用命令解析之001--On Error(将错就错) 谁都希望自己的程序能一顺百顺,但是错误却一直是我们心中的痛.总是时不时地跳出来影响我们的情绪.虽然跳出来的错误提示会中断我们程序的运行,但是 ...
运维之道 | Git分布式版本控制常用命令解析
Git分布式版本控制常用命令解析一.创建版本库版本库(repository)也叫仓库,可以看做一个目录,这个目录里的所以文件都由Git进行管理,每个文件的修改.删除,Git都能跟踪 1.选择一个合 ...
linux常用rm命令详解,Linux常用命令解析- rm命令
今天小编要跟大家分享的文章是关于Linux常用命令解析- rm命令.rm 是一个命令行工具,用于删除文件和目录.这是每个Linux用户都应该熟悉的基本命令之一. 在本指南中,我们将通过最常见的rm选项 ...
strongswan常用命令解析(二)
strongswan常用命令解析 0 > ipsec reload //重新加载 ipsec.conf文件 1 > ipsec rereadsecrets //重新加载ipsec.secr ...
Docker 入门（二）常用命令纯手敲带测试结果
Docker常用命令帮助命令 docker version # 显示docker版本信息 docker info # 显示docker系统信息,包括镜像和容器的数量 docker --help # ...
docker删除es数据_Docker的常用命令
Docker的常用命令 docker version#显示docker的版本信息 docker info#显示docker的系统信息,包括镜像和容器的数量 docker --help#docker帮助 ...

Docker从入门到放弃-----Dockerfile常用命令解析与实战（使用docker制作一个开箱即用的consul镜像）