Docker笔记--核心DockerFile介绍和常用指令解释以及案例演示

骑猪看日落 2021-07-05 01:06 476阅读 0赞

## 一、DockerFile ##

在Docker中创建镜像就是编写Dockerfile。Dockerfile是一个Docker镜像的描述文件，通过文件符合系统也就是生活中常吃的“花卷”。而Dockerfile其内部包含了一条条的指令，每一条指令构建一层，因此每一条指令的内容，就是描述该层应当如何构建。相当于我们搭积木一样，先底层再第二层，一层层往上搭建

一个Dockerfile的示例 如下图：  
　　![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dUV1pldXM_size_16_color_FFFFFF_t_70]

#基于centos镜像
    FROM centos
    
    #维护人的信息
    MAINTAINER The CentOS Project Zeus
    
    #安装httpd软件包(永远以yes同意安装)
    RUN yum -y update
    RUN yum -y install httpd
    Run yun -y install vim
    
    #开启80端口
    EXPOSE 80
    
    #复制网站首页文件至镜像中web站点下
    ADD index.html /var/www/html/index.html
    
    #复制该脚本至镜像中，并修改其权限
    ADD run.sh /run.sh
    RUN chmod 775 /run.sh
    
    #当启动容器时执行的脚本文件
    CMD ["/run.sh"]

**由上可知，Dockerfile结构大致分为四个部分：**

（1）基础镜像信息

（2）维护者信息

（3）镜像操作指令

（4）容器启动时执行指令。

Dockerfile每行支持一条指令，每条指令可带多个参数，支持使用以\#号开头的注释。下面会对上面使用到的一些常用指令做一些介绍。

## 二、Dockerfile常用指令 ##

首先，来一张通俗易懂的全景图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dUV1pldXM_size_16_color_FFFFFF_t_70 1]

**2.1 FROM**

指明构建的新镜像是来自于哪个基础镜像，例如：

FROM centos:6

**2.2 MAINTAINER**

指明镜像维护着及其联系方式（一般是邮箱地址），例如：

MAINTAINER Zues

不过，MAINTAINER并不推荐使用，更推荐使用LABEL来指定镜像作者，例如：

LABEL maintainer="Zeus"

**2.3 RUN**

构建镜像时运行的Shell命令，例如：

RUN ["yum", "install", "httpd"]
    RUN yum install httpd

又如，我们在使用微软官方ASP.NET Core Runtime镜像时往往会加上以下RUN命令，弥补无法在默认镜像下使用Drawing相关接口的缺憾：

FROM microsoft/dotnet:2.2.1-aspnetcore-runtime
    RUN apt-get update
    RUN apt-get install -y libgdiplus
    RUN apt-get install -y libc6-dev
    RUN ln -s /usr/lib/libgdiplus.so /lib/x86_64-linux-gnu/libgdiplus.so

**2.4 CMD**

启动容器时执行的Shell命令，例如：

CMD ["-C", "/start.sh"] 
    CMD ["/usr/sbin/sshd", "-D"] 
    CMD /usr/sbin/sshd -D

**2.5 EXPOSE**

声明容器运行的服务端口，例如：

EXPOSE 80 443

**2.6 ENV**

设置环境内环境变量，例如：

ENV MYSQL_ROOT_PASSWORD 123456
    ENV JAVA_HOME /usr/local/jdk1.8.0_45

**2.7 ADD**

拷贝文件或目录到镜像中，例如：

ADD <src>...<dest>
    ADD html.tar.gz /var/www/html
    ADD https://xxx.com/html.tar.gz /var/www/html

***特别注意是和Copy的区别是：如果是文件URL或压缩包，会自动下载或自动解压（ADD），而Copy不会***

**2.8 COPY**

拷贝文件或目录到镜像中，用法同ADD，只是不支持自动下载和解压，例如：

COPY ./start.sh /start.sh

**2.9 ENTRYPOINT**

启动容器时执行的Shell命令，同CMD类似，只是由ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖，而且，这些命令行参数会被当作参数传递给ENTRYPOINT指定指定的程序，例如：

**ENTRYPOINT ["/bin/bash", "-C", "/start.sh"]
    ENTRYPOINT /bin/bash -C '/start.sh'**

***一句话说：Dockerfile文件中也可以存在多个ENTRYPOINT指令，但仅有最后一个才有效。相反的是CMD都会执行所有指令***

**2.10 VOLUME**

指定容器挂载点到宿主机自动生成的目录或其他容器，例如：

VOLUME ["/var/lib/mysql"]

**提示：一般不会在Dockerfile中用到，更常见的还是在docker run的时候指定-v数据卷。**  
　　  
**2.11 USER**

为RUN、CMD和ENTRYPOINT执行Shell命令指定运行用户，例如：

USER <user>[:<usergroup>]
    USER <UID>[:<UID>]
    USER edisonzhou

**2.12 WORKDIR**

为RUN、CMD、ENTRYPOINT以及COPY和AND设置工作目录，例如：

WORKDIR /data

**2.13 HEALTHCHECK**

告诉Docker如何测试容器以检查它是否仍在工作，即健康检查如：

HEALTHCHECK --interval=5m --timeout=3s --retries=3 \
        CMD curl -f http:/localhost/ || exit 1
    
    　　其中，一些选项的说明：
    
         --interval=DURATION (default: 30s)：每隔多长时间探测一次，默认30秒
         -- timeout= DURATION (default: 30s)：服务响应超时时长，默认30秒
         --start-period= DURATION (default: 0s)：服务启动多久后开始探测，默认0秒
         --retries=N (default: 3)：认为检测失败几次为宕机，默认3次
    
    　　一些返回值的说明：
    
         0：容器成功是健康的，随时可以使用
         1：不健康的容器无法正常工作
         2：保留不使用此退出代码

**2.14 ARG**

在构建镜像时，指定一些参数，例如：

FROM centos:6
    ARG user # ARG user=root
    USER $user

这时，我们在docker build时可以带上自定义参数user了，如下所示：

docker build --build-arg user=Zues Dockerfile .//（注意后面还有个点）

## 三、Dockerfile简单案例 ##

下面是一个Java Web应用的镜像Dockerfile，综合使用到了上述介绍中最常用的几个命令：  
复制代码

FROM centos:7
    MAINTANIER www..com
    
    ADD jdk-8u45-linux-x64.tar.gz /usr/local
    ENV JAVA_HOME /usr/local/jdk1.8.0_45
    
    ADD apache-tomcat-8.0.46.tar.gz /usr/local
    COPY server.xml /usr/local/apache-tomcat-8.0.46/conf
    
    RUN rm -f /usr/local/*.tar.gz WORKDIR /usr/local/apache-tomcat-8.0.46 EXPOSE 8080 ENTRYPOINT ["./bin/catalina.sh", "run"]

**有了Dockerfile，就可以创建镜像了：**

docker build -t tomcat:v1 .

**最后，可以通过以下命令创建容器：**

docker run -itd --name=tomcate -p 8080:8080 \
        -v /app/webapps/:/usr/local/apache-tomcat-8.0.46/webapps/ \
        tomcat:v1

**也可以直接去docker的hub里面看看完成的一个dockerfile文件的一些内容**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dUV1pldXM_size_16_color_FFFFFF_t_70 2]**例如mysql的官方版的dockerFile中的内容有这么多：**

FROM debian:buster-slim
    
    # add our user and group first to make sure their IDs get assigned consistently, regardless of whatever dependencies get added
    RUN groupadd -r mysql && useradd -r -g mysql mysql
    
    RUN apt-get update && apt-get install -y --no-install-recommends gnupg dirmngr && rm -rf /var/lib/apt/lists/* # add gosu for easy step-down from root # https://github.com/tianon/gosu/releases ENV GOSU_VERSION 1.12 RUN set -eux; \ savedAptMark="$(apt-mark showmanual)"; \ apt-get update; \ apt-get install -y --no-install-recommends ca-certificates wget; \ rm -rf /var/lib/apt/lists/*; \ dpkgArch="$(dpkg --print-architecture | awk -F- '{ print $NF }')"; \ wget -O /usr/local/bin/gosu "https://github.com/tianon/gosu/releases/download/$GOSU_VERSION/gosu-$dpkgArch"; \ wget -O /usr/local/bin/gosu.asc "https://github.com/tianon/gosu/releases/download/$GOSU_VERSION/gosu-$dpkgArch.asc"; \ export GNUPGHOME="$(mktemp -d)"; \ gpg --batch --keyserver hkps://keys.openpgp.org --recv-keys B42F6819007F00F88E364FD4036A9C25BF357DD4; \ gpg --batch --verify /usr/local/bin/gosu.asc /usr/local/bin/gosu; \ gpgconf --kill all; \ rm -rf "$GNUPGHOME" /usr/local/bin/gosu.asc; \ apt-mark auto '.*' > /dev/null; \ [ -z "$savedAptMark" ] || apt-mark manual $savedAptMark > /dev/null; \ apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false; \ chmod +x /usr/local/bin/gosu; \ gosu --version; \ gosu nobody true RUN mkdir /docker-entrypoint-initdb.d RUN apt-get update && apt-get install -y --no-install-recommends \ # for MYSQL_RANDOM_ROOT_PASSWORD pwgen \ # for mysql_ssl_rsa_setup openssl \ # FATAL ERROR: please install the following Perl modules before executing /usr/local/mysql/scripts/mysql_install_db: # File::Basename # File::Copy # Sys::Hostname # Data::Dumper perl \ # install "xz-utils" for .sql.xz docker-entrypoint-initdb.d files xz-utils \ && rm -rf /var/lib/apt/lists/* RUN set -ex; \ # gpg: key 5072E1F5: public key "MySQL Release Engineering <mysql-build@oss.oracle.com>" imported key='A4A9406876FCBD3C456770C88C718D3B5072E1F5'; \ export GNUPGHOME="$(mktemp -d)"; \ gpg --batch --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \ gpg --batch --export "$key" > /etc/apt/trusted.gpg.d/mysql.gpg; \ gpgconf --kill all; \ rm -rf "$GNUPGHOME"; \ apt-key list > /dev/null ENV MYSQL_MAJOR 8.0 ENV MYSQL_VERSION 8.0.20-1debian10 RUN echo "deb http://repo.mysql.com/apt/debian/ buster mysql-${MYSQL_MAJOR}" > /etc/apt/sources.list.d/mysql.list # the "/var/lib/mysql" stuff here is because the mysql-server postinst doesn't have an explicit way to disable the mysql_install_db codepath besides having a database already "configured" (ie, stuff in /var/lib/mysql/mysql) # also, we set debconf keys to make APT a little quieter RUN { \ echo mysql-community-server mysql-community-server/data-dir select ''; \ echo mysql-community-server mysql-community-server/root-pass password ''; \ echo mysql-community-server mysql-community-server/re-root-pass password ''; \ echo mysql-community-server mysql-community-server/remove-test-db select false; \ } | debconf-set-selections \ && apt-get update && apt-get install -y mysql-community-client="${MYSQL_VERSION}" mysql-community-server-core="${MYSQL_VERSION}" && rm -rf /var/lib/apt/lists/* \ && rm -rf /var/lib/mysql && mkdir -p /var/lib/mysql /var/run/mysqld \ && chown -R mysql:mysql /var/lib/mysql /var/run/mysqld \ # ensure that /var/run/mysqld (used for socket and lock files) is writable regardless of the UID our mysqld instance ends up having at runtime && chmod 777 /var/run/mysqld VOLUME /var/lib/mysql # Config files COPY config/ /etc/mysql/ COPY docker-entrypoint.sh /usr/local/bin/ RUN ln -s usr/local/bin/docker-entrypoint.sh /entrypoint.sh # backwards compat ENTRYPOINT ["docker-entrypoint.sh"] EXPOSE 3306 33060 CMD ["mysqld"]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dUV1pldXM_size_16_color_FFFFFF_t_70]: /images/20210704/eb0af44276bd4ddd893fd850232fe623.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dUV1pldXM_size_16_color_FFFFFF_t_70 1]: /images/20210704/e2b2e01bb2a14cb29cb9d8a4bf8153dd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dUV1pldXM_size_16_color_FFFFFF_t_70 2]: /images/20210704/e60f4a487f2144c48c96de519c2c24bc.png