- 是什么
- DockerFile构建过程解析
- 表示注释
- ">
- DockerFile 常用保留字指令
- 参考tomcat8 的dockerfile 入门
- FROM: 基础镜像,当前新镜像是基于那个镜像,指定一个已经存在的镜像作为模版,第一条必须是from
- MAINTAINER(官网已弃用): 镜像维护者的姓名和邮箱地址
- RUN:容器构建时需要运行的命令
- EXPOSE: 当前容器对外暴露出的端口
- WORKDIR:指定在容器后,终端默认登陆的进来工作目录,一个落脚点
- USER:指定该镜像以什么用户去执行,如果都不指定,默认是root
- ENV: 用来在构建镜像过程中设置环境变量
- ADD:将宿主机目录下的文件拷贝进镜像且会自动处理URL和解压tar压缩包
- COPY:拷贝文件和目录到镜像中
- VOLUME:容器数据卷,用于数据保存和持久化工作
- CMD:指定容器启动后要干的事情
- ENTRYPOINT:指定容器启动时要运行的命令
- 案例
- 小总结
是什么
DockerFile 是用来构建Docker 镜像的文本文件,是由一条条 构建镜像所需的指令和参数构成的脚本
概述
官网
https://docs.docker.com/engine/reference/builder/
构建三步骤
编写DockerFile 文件
docker build 命令构建镜像
docker run 依镜像运行容器实例
DockerFile构建过程解析
DockerFile内容基础知识
Docker执行DockerFile的大致流程
1)docker从基础镜像运行一个容器
2)执行一条指令并对容器作出修改
3)执行类似docker commit 的操作提交一个新的镜像层
4)docker 再基于刚提交的镜像运行一个新容器
5)执行dockerfile 中的下一条指令直到所有指令都执行完成
小总结
从应用软件的角度来看,Dockerfie、Docker镜像与Docker容器分别代表软件的三个不同阶段,
Dockerfile是软件的原材料
Docker镜像是软件的交
* Docker容器则可以认为是软件镜像的运行态,也即依照镜像运行的容器实例
Dockerfile面向开发,Docker镜像成为交付标准,Docker容器则涉及部署与运维,三者缺一不可,合力充当Docker体系的基石。
DockerFile 常用保留字指令
参考tomcat8 的dockerfile 入门
https://registry.hub.docker.com/_/tomcat
tomcat 的dockerfile 文件链接:https://github.com/docker-library/docs/tree/master/tomcat/README.md#supported-tags-and-respective-dockerfile-links
#
# NOTE: THIS DOCKERFILE IS GENERATED VIA "apply-templates.sh"
#
# PLEASE DO NOT EDIT IT DIRECTLY.
#
FROM amazoncorretto:8
ENV CATALINA_HOME /usr/local/tomcat
ENV PATH $CATALINA_HOME/bin:$PATH
RUN mkdir -p "$CATALINA_HOME"
WORKDIR $CATALINA_HOME
# let "Tomcat Native" live somewhere isolated
ENV TOMCAT_NATIVE_LIBDIR $CATALINA_HOME/native-jni-lib
ENV LD_LIBRARY_PATH ${LD_LIBRARY_PATH:+$LD_LIBRARY_PATH:}$TOMCAT_NATIVE_LIBDIR
# see https://www.apache.org/dist/tomcat/tomcat-10/KEYS
# see also "versions.sh" (https://github.com/docker-library/tomcat/blob/master/versions.sh)
ENV GPG_KEYS A9C5DF4D22E99998D9875A5110C01C5A2F6059E7
ENV TOMCAT_MAJOR 10
ENV TOMCAT_VERSION 10.0.14
ENV TOMCAT_SHA512 c2d2ad5ed17f7284e3aac5415774a8ef35434f14dbd9a87bc7230d8bfdbe9aa1258b97a59fa5c4030e4c973e4d93d29d20e40b6254347dbb66fae269ff4a61a5
RUN set -eux; \
\
# http://yum.baseurl.org/wiki/YumDB.html
if ! command -v yumdb > /dev/null; then \
yum install -y yum-utils; \
yumdb set reason dep yum-utils; \
fi; \
# a helper function to "yum install" things, but only if they aren't installed (and to set their "reason" to "dep" so "yum autoremove" can purge them for us)
_yum_install_temporary() { ( set -eu +x; \
local pkg todo=''; \
for pkg; do \
if ! rpm --query "$pkg" > /dev/null 2>&1; then \
todo="$todo $pkg"; \
fi; \
done; \
if [ -n "$todo" ]; then \
set -x; \
yum install -y $todo; \
yumdb set reason dep $todo; \
fi; \
) }; \
_yum_install_temporary gzip tar; \
\
ddist() { \
local f="$1"; shift; \
local distFile="$1"; shift; \
local mvnFile="${1:-}"; \
local success=; \
local distUrl=; \
for distUrl in \
# https://issues.apache.org/jira/browse/INFRA-8753?focusedCommentId=14735394#comment-14735394
"https://www.apache.org/dyn/closer.cgi?action=download&filename=$distFile" \
# if the version is outdated (or we're grabbing the .asc file), we might have to pull from the dist/archive :/
"https://downloads.apache.org/$distFile" \
"https://www-us.apache.org/dist/$distFile" \
"https://www.apache.org/dist/$distFile" \
"https://archive.apache.org/dist/$distFile" \
# if all else fails, let's try Maven (https://www.mail-archive.com/users@tomcat.apache.org/msg134940.html; https://mvnrepository.com/artifact/org.apache.tomcat/tomcat; https://repo1.maven.org/maven2/org/apache/tomcat/tomcat/)
${mvnFile:+"https://repo1.maven.org/maven2/org/apache/tomcat/tomcat/$mvnFile"} \
; do \
if curl -fL -o "$f" "$distUrl" && [ -s "$f" ]; then \
success=1; \
break; \
fi; \
done; \
[ -n "$success" ]; \
}; \
\
ddist 'tomcat.tar.gz' "tomcat/tomcat-$TOMCAT_MAJOR/v$TOMCAT_VERSION/bin/apache-tomcat-$TOMCAT_VERSION.tar.gz" "$TOMCAT_VERSION/tomcat-$TOMCAT_VERSION.tar.gz"; \
echo "$TOMCAT_SHA512 *tomcat.tar.gz" | sha512sum --strict --check -; \
ddist 'tomcat.tar.gz.asc' "tomcat/tomcat-$TOMCAT_MAJOR/v$TOMCAT_VERSION/bin/apache-tomcat-$TOMCAT_VERSION.tar.gz.asc" "$TOMCAT_VERSION/tomcat-$TOMCAT_VERSION.tar.gz.asc"; \
export GNUPGHOME="$(mktemp -d)"; \
for key in $GPG_KEYS; do \
gpg --batch --keyserver keyserver.ubuntu.com --recv-keys "$key"; \
done; \
gpg --batch --verify tomcat.tar.gz.asc tomcat.tar.gz; \
tar -xf tomcat.tar.gz --strip-components=1; \
rm bin/*.bat; \
rm tomcat.tar.gz*; \
command -v gpgconf && gpgconf --kill all || :; \
rm -rf "$GNUPGHOME"; \
\
# https://tomcat.apache.org/tomcat-9.0-doc/security-howto.html#Default_web_applications
mv webapps webapps.dist; \
mkdir webapps; \
# we don't delete them completely because they're frankly a pain to get back for users who do want them, and they're generally tiny (~7MB)
\
nativeBuildDir="$(mktemp -d)"; \
tar -xf bin/tomcat-native.tar.gz -C "$nativeBuildDir" --strip-components=1; \
_yum_install_temporary \
apr-devel \
gcc \
make \
openssl11-devel \
; \
( \
export CATALINA_HOME="$PWD"; \
cd "$nativeBuildDir/native"; \
aprConfig="$(command -v apr-1-config)"; \
./configure \
--libdir="$TOMCAT_NATIVE_LIBDIR" \
--prefix="$CATALINA_HOME" \
--with-apr="$aprConfig" \
--with-java-home="$JAVA_HOME" \
--with-ssl=yes \
; \
nproc="$(nproc)"; \
make -j "$nproc"; \
make install; \
); \
rm -rf "$nativeBuildDir"; \
rm bin/tomcat-native.tar.gz; \
\
# mark any explicit dependencies as manually installed
find "$TOMCAT_NATIVE_LIBDIR" -type f -executable -exec ldd '{}' ';' \
| awk '/=>/ && $(NF-1) != "=>" { print $(NF-1) }' \
| xargs -rt readlink -e \
| sort -u \
| xargs -rt rpm --query --whatprovides \
| sort -u \
| tee "$TOMCAT_NATIVE_LIBDIR/.dependencies.txt" \
| xargs -r yumdb set reason user \
; \
\
# clean up anything added temporarily and not later marked as necessary
yum autoremove -y; \
yum clean all; \
rm -rf /var/cache/yum; \
\
# sh removes env vars it doesn't support (ones with periods)
# https://github.com/docker-library/tomcat/issues/77
find ./bin/ -name '*.sh' -exec sed -ri 's|^#!/bin/sh$|#!/usr/bin/env bash|' '{}' +; \
\
# fix permissions (especially for running as non-root)
# https://github.com/docker-library/tomcat/issues/35
chmod -R +rX .; \
chmod 777 logs temp work; \
\
# smoke test
catalina.sh version
# verify Tomcat Native is working properly
RUN set -eux; \
nativeLines="$(catalina.sh configtest 2>&1)"; \
nativeLines="$(echo "$nativeLines" | grep 'Apache Tomcat Native')"; \
nativeLines="$(echo "$nativeLines" | sort -u)"; \
if ! echo "$nativeLines" | grep -E 'INFO: Loaded( APR based)? Apache Tomcat Native library' >&2; then \
echo >&2 "$nativeLines"; \
exit 1; \
fi
EXPOSE 8080
CMD ["catalina.sh", "run"]
FROM: 基础镜像,当前新镜像是基于那个镜像,指定一个已经存在的镜像作为模版,第一条必须是from
FROM [—platform= [AS
Or
FROM [—platform=[:
Or
FROM [—platform=[@
MAINTAINER(官网已弃用): 镜像维护者的姓名和邮箱地址
MAINTAINER
RUN:容器构建时需要运行的命令
shell格式
RUN
例:RUN yum -y install vim
exec格式
RUN [“executable”, “param1”, “param2”]
例:RUN [“/bin/bash”, “-c”, “echo hello”] == RUN /bin/bash -c echo hello
RUN是在docker build时运行
EXPOSE
例: EXPOSE 80/udp
EXPOSE: 当前容器对外暴露出的端口
WORKDIR:指定在容器后,终端默认登陆的进来工作目录,一个落脚点
WORKDIR /path/to/workdir
例:WORKDIR /a
USER:指定该镜像以什么用户去执行,如果都不指定,默认是root
USER
or
USER
ENV: 用来在构建镜像过程中设置环境变量
ENV
例:ENV MY_NAME=”John Doe”
ENV MY_DOG=Rex\ The\ Dog
ENV MY_CAT=fluffy
可以在后续命令中使用,$变量名,获取变量信息,$MY_CAT
ADD:将宿主机目录下的文件拷贝进镜像且会自动处理URL和解压tar压缩包
COPY:拷贝文件和目录到镜像中
COPY [—chown=
COPY [—chown=
VOLUME:容器数据卷,用于数据保存和持久化工作
VOLUME [“/data”]
例:FROM ubuntu
RUN mkdir /myvol
RUN echo “hello world” > /myvol/greeting
VOLUME /myvol
CMD:指定容器启动后要干的事情
CMD command param1 param2
例:CMD echo “This is a test.” | wc -
CMD [“param1”,”param2”] (as default parameters to ENTRYPOINT)
例:CMD [“/usr/bin/wc”,”—help”]
注意
在Dockerfile中只能有一个CMD指令。如果你列出了多个CMD,那么只有最后一个CMD将生效。
和RUN命令的区别
CMD 是在docker run 时运行
RUN 是 在docker build 时运行
ENTRYPOINT:指定容器启动时要运行的命令
ENTRYPOINT [“executable”, “param1”, “param2”]
ENTRYPOINT command param1 param2
类似于CMD ,但是ENTRYPOINT 不会被 docker run 后面的命令覆盖,而且这些命令会被当作参数送给 ENTRYPOINT 指令指定的程序
优点
缺点
案例
自定义镜像mycentosjava8
来取cenos镜像
docker pull centos
要求
1、Centos镜像具备vim+ifconfig+jdk8
2、jdk 下载镜像地址 - 官网: https://www.oracle.com/java/technologies/javase/javase8u211-later-archive-downloads.html, 根据自己需要,下载对应的版本
编写
在根目录创建 myfile 文件夹,上传 jdk的jdk-8u301-linux-x64.tar.gz
mkdir myfile
创建DockerFile 文件, 注意 F 是小写 : 一定是 Dockerfile
vim DockerFile
# 手动敲的
FROM centos
MAINTAINER ljx<1506095514@qq.com>
ENV MYPATH /usr/local
WORKDIR $MYPATH
# 安装 vim 编辑器
RUM yum -y install vim
# 安装ifconfig 命令查看网络IP
RUM yum -y install net-tools
# 安装 java8 及lib库
RUM ym -y install glibc.i686
RUM mkdir /usr/local/java
# ADD 是相对路径jar,把 jdk-8u301-linux-x64.tar.gz 添加到容器中,安装包必须要和DockerFile 文件在同一位置
ADD jdk-8u301-linux-x64.tar.gz /usr/local/java/
# 配置Java 环境变量 , 注意jdk1.8.0_301 这个是根据解压出来的文件夹命名
ENV JAVA_HOME /usr/local/java/jdk1.8.0_301
ENV JRE_HOME $JAVA_HOME/jre
ENV CLASSPATH $JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tool.jar:$JRE_HOME/lib:$CLASSPATH
ENV PATH $JAVA_HOME/bin:$PATH
EXPOSE 80
CMD echo $MYPATH
CMD echo "success -----------ok"
CMD /bin/bash
# 拷贝的
FROM centos
MAINTAINER ljx<1506095514@qq.com>
ENV MYPATH /usr/local
WORKDIR $MYPATH
#安装vim编辑器
RUN yum -y install vim
#安装ifconfig命令查看网络IP
RUN yum -y install net-tools
#安装 java8及 Lib库
RUN yum -y install glibc.i686
RUN mkdir /usr/local/java
#ADD 是相对路径jar,把jdk-8u171-linux-x64.tar.gz添加到容器中,安装包必须要和Dockerfile文件在同一位置
ADD jdk-8u301-linux-x64.tar.gz /usr/local/java/
#配置java环境变量 注意jdk1.8.0_301 这个是根据解压出来的文件夹命名
ENV JAVA_HOME /usr/local/java/jdk1.8.0_301
ENV JRE_HOME $JAVA_HOME/jre
ENV CLASSPATH $JAVALHOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib:$CLASSPATH
ENV PATH $JAVA_HOME/bin:$PATH
EXPOSE 80
CMD echo $MYPATH
CMD echo "success -----------ok"
CMD /bin/bash
构建
docker build -t 新镜像名字:TAG . 注意上面TAG 后面有个空格,有个点
docker build -t centosjava8:1.5 .
出现如下错误,找不到Dockerfile的文件,查看文件名是否错误,一定是 Dockerfile
unable to prepare context: unable to evaluate symlinks in Dockerfile path: lstat /myfile/Dockerfile: no such file or directory
修改文件名的命令
mv DockerFile Dockerfile
运行
docker run -it e5d7b4d533de /bin/bash
测试相关命令
ifconfig
再体会下UnionFS(联合文件系统)
虚悬镜像
是什么
仓库名、标签都是
创建一个测试文件夹,在文件内创建一个test文件夹,再在文件内创建一个Dockerfile 文件
Dockerfile 创建一个
FROM ubuntu
CMD echo 'action is success'
构建
docker build .
查看
docker image ls -f dangling=true
删除
docker image prune