文档建议反馈控制台
首页
学习
活动
专区
圈层
工具
MCP广场
文章/答案/技术大牛
发布
社区首页 >专栏 >Docker 摸门级简易手册

Docker 摸门级简易手册

作者头像
双鬼带单
发布于 2023-09-11 16:32:00
发布于 2023-09-11 16:32:00
7490
举报
文章被收录于专栏：CodingToDieCodingToDie

Docker 摸门级简易手册

使用 Docker 构建 Java 项目镜像

假设有个 Spring Boot 项目，其项目结构如下

代码语言：javascript
复制
.
├── Dockerfile
├── docker-entrypoint.sh
├── mvnw
├── mvnw.cmd
├── pom.xml
├── settings.xml
└── src
    ├── main
    │   ├── java
    │   │   └── order
    │   │       ├── AppOrderApplication.java
    │   │       ├── InfoController.java
    │   │       ├── OrderController.java
    │   │       └── OrderServerProperties.java
    │   └── resources
    │       ├── application-dev.yaml
    │       ├── application-prod.yaml
    │       ├── application-test.yaml
    │       ├── application.yaml
    │       └── logback-file-and-console.xml
    └── test
        └── java
            └── order
                └── AppOrderApplicationTests.java

docker-entrypoint.sh

代码语言：javascript
复制
#!/bin/sh

echo "Start service [ Spring Boot Application ]."
java -jar app.jar ${JAVA_ARGS}

Dockerfile

代码语言：javascript
复制
FROM openjdk:8u342-oracle
LABEL authors="zhangyunan"

ENV TZ=Asia/Shanghai
ENV LC_ALL en_US.utf8

WORKDIR /app

COPY target/*.jar /app/app.jar
COPY docker-entrypoint.sh /app

RUN chmod +x docker-entrypoint.sh

EXPOSE 30000

ENTRYPOINT ["docker-entrypoint.sh"]

Docker 构建项目

代码语言：javascript
复制
docker build -t zyndev/spring-boot-app:1.0 .

Docker 运行项目

代码语言：javascript
复制
docker run -e "JAVA_ARGS=--spring.profiles.active=prod" -p 30002:30000 -d --name spring-boot-app-prod zyndev/spring-boot-app:1.0

测试一下

代码语言：javascript
复制
curl 127.0.0.1:30002/info

{
    "currentTime": "2023-09-01T16:00:51.618",
    "ServerName": "order",
    "Profile": "prod"
}

Dockerfile 中最常用的指令包括：

  • FROM：指定基础镜像。一般为 linux 或者对应的运行环境，比如 node, python, jdk
  • RUN：镜像构建时执行的命令
  • EXPOSE：指定容器暴露的端口
  • ENV：设置环境变量
  • COPY：将文件或目录复制到镜像中
  • WORKDIR：设置镜像的工作目录
  • ENTRYPOINT：启动时的默认命令，此指令设置的命令不可修改

Docker 安装

Install on Mac

可以通过安装 Docker Desktop 来间接安装 Docker

Install on Windows

可以通过安装 Docker Desktop 来间接安装 Docker

Install on Linux

Dockerfile 说明

Dockerfile 文件由一系列指令组成。每个指令都描述了构建镜像的某个步骤。Docker 可以通过读取 Dockerfile 中的指令自动构建镜像。Dockerfile 是一个文本文档，其中包含用户可以在命令行上调用来组装映像的所有命令。

在 Dockerfile 中的 指令不区分大小写。不过按照惯例是用大写的，以便更容易地将它们与参数区分开来。在构建过程中按照 Dockerfile 中的指令顺序来执行。每个 Dockerfile 必须以 FROM 开始，其 FROM 前面只能有一个或多个 ARG 指令

Dockerfile 中最常用的指令包括：

  • FROM：指定基础镜像
  • WORKDIR：设置镜像的工作目录
  • ENV：设置环境变量
  • COPY：将文件或目录复制到镜像中
  • ADD：将文件或目录复制到镜像中
  • RUN：执行命令，在构建的阶段执行
  • CMD：指定容器启动后默认执行的命令
  • EXPOSE：指定容器暴露的端口
  • VOLUME：创建卷
  • USER：指定容器运行时的用户
  • ARG：定义构建时可选参数

FROM

FROM 命令是指定你所使用的基础镜像.

指令语法

代码语言：javascript
复制
FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

如果引用多架构的镜像，可选 --platform 标志可用于指定架构的镜像。FROM 例如 linux/amd64、 linux/arm64、 或 windows/amd64。默认情况下使用构建机器对应的架构

示例

代码语言：javascript
复制
FROM ubuntu
FROM ubuntu:latest
FROM ubuntu:23.10
FROM alpine:3.18.3
FROM busybox

FROM openjdk:8u342-oracle
FROM python:3.9-slim

LABEL

将一些元数据添加到镜像中。

指令语法

代码语言：javascript
复制
LABEL <key>=<value> <key>=<value> <key>=<value> ...

示例

代码语言：javascript
复制
LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.0"
LABEL description="描述"
LABEL org.opencontainers.image.authors="张瑀楠"

LABEL multi.label1="value1" multi.label2="value2" other="value3"

LABEL multi2.label1="value1" \
      multi2.label2="value2" \
      other2="value3"

可以使用 docker image inspect 来查看打包后的镜像的元数据信息

代码语言：javascript
复制
docker image inspect --format='{{json .Config.Labels}}' myimage

{
  "com.example.vendor": "ACME Incorporated",
  "com.example.label-with-value": "foo",
  "version": "1.0",
  "description": "描述",
  "multi.label1": "value1",
  "multi.label2": "value2",
  "other": "value3",
  "org.opencontainers.image.authors": "张瑀楠",
  "multi2.label1": "value1",
  "multi2.label2": "value2",
  "other2": "value3"
}

ENV

设置环境变量。

指令语法

代码语言：javascript
复制
ENV <key>=<value> ...

示例

代码语言：javascript
复制
ENV TZ=Asia/Shanghai
ENV LC_ALL en_US.utf8

ENV JAVA_HOME /usr/lib/jvm/java-7-openjdk-amd64
ENV CLASSPATH $JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
ENV PATH $PATH:$JAVA_HOME/bin:$JRE_HOME/bin

ENV JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64 \
    CLASSPATH=$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar \
    PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin

WORKDIR

指定容器中的工作目录，可以在构建时使用，也可以在启动容器时使用，构建使用就是通过 WORKDIR 将当前目录切换到指定的目录中，容器中使用的意思则是在你使用 docker run 命令启动容器时，默认进入的目录是 WORKDIR 指定的。

指令语法

代码语言：javascript
复制
WORKDIR /path/to/workdir

示例

代码语言：javascript
复制
WORKDIR /app
WORKDIR /opt/user

COPY

复制文件到镜像中。

指令语法

代码语言：javascript
复制
COPY [--chown=<user>:<group>] [--chmod=<perms>] <src>... <dest>
COPY [--chown=<user>:<group>] [--chmod=<perms>] ["<src>",... "<dest>"]

COPY 的 src 部分只能是本地文件，文件路径是 Dockerfile 的相对路径。如果 dest 是目录并且目录不存在，会帮你创建。

示例

代码语言：javascript
复制
COPY requirements.txt /app
COPY app.py /app

COPY target/*.jar /app/app.jar
COPY --chmod=777 docker-entrypoint.sh /app

COPY --chown=55:mygroup files* /somedir/
COPY --chown=bin files* /somedir/
COPY --chown=1 files* /somedir/
COPY --chown=10:11 files* /somedir/
COPY --chown=myuser:mygroup --chmod=644 files* /somedir/

ADD

复制命令，把本机的文件复制到镜像中，如果 dest 是目录则会帮你创建出这个目录，如果 src 是压缩文件会帮你解压出来。如果 src 是 url 则下载文件。

指令语法

代码语言：javascript
复制
ADD [--chown=<user>:<group>] [--chmod=<perms>] [--checksum=<checksum>] <src>... <dest>
ADD [--chown=<user>:<group>] [--chmod=<perms>] ["<src>",... "<dest>"]

示例

代码语言：javascript
复制
ADD https://th.bing.com/th/id/OIP.sGpPNLl05CAXgEY5bGguOgHaE8 /app/ss.img
代码语言：javascript
复制
FROM alpine:3.18.3
LABEL authors="zhangyunan"

WORKDIR /app

ADD https://th.bing.com/th/id/OIP.sGpPNLl05CAXgEY5bGguOgHaE8 /app/ss.img

RUN

运行指定的命令，此命令只有在执行docker build时才会执行，其他情况下不会执行。

指令语法

代码语言：javascript
复制
RUN <command> (如果在 linux 中入默认用 /bin/sh -c ，在 windows 中用 cmd /S /C)
RUN ["executable", "param1", "param2"]

示例

代码语言：javascript
复制
RUN apt-get update \
    && apt-get install openjdk-8-jdk --no-install-recommends -y \
    && apt-get clean all \
    && rm -rf /var/lib/apt/lists/*

CMD

该命令和 RUN 不同，该指令只有在容器运行的时候才会执行。

指令语法

代码语言：javascript
复制
CMD ["executable","param1","param2"]
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2

设置容器启动时要运行的命令只有在容器运行时命令是才会运行，其他情况下不运行。如果一个 Dockerfile 里面有多条 CMD 指令，那么只有文件最后一行的 CMD 指令才会生效，其他的全部没用，CMD 指令是可以在你执行 docker run 的时候覆盖的。

示例

代码语言：javascript
复制
CMD ["python", "app.py"]
CMD ["java", "-jar", "app.jar"]

EXPOSE

设置暴露的容器端口，注意是容器端口。

指令语法

代码语言：javascript
复制
EXPOSE <port> [<port>/<protocol>...]

默认协议为 TCP

示例

代码语言：javascript
复制
EXPOSE 9000
EXPOSE 9001/tcp
EXPOSE 9002/udp
EXPOSE 20000 20001
EXPOSE 20003/tcp 20004/udp

ENTRYPOINT

启动时的默认命令，此指令设置的命令不可修改。与CMD是有区别的。此命令在Dockerfile只能有一个，若有多个，则以文件最后一个出现的才生效。

指令语法

代码语言：javascript
复制
ENTRYPOINT ["executable", "param1", "param2"]

示例

代码语言：javascript
复制
ENTRYPOINT ["nginx"]
CMD ["-g","daemon off;"]

如上，如果执行 docker run -d --name nginx -P nginx 则最终容器内执行的命令是nginx -g daemon off; ，如果你执行的命令是 docker run -d --name nginx -P nginx bash 则最终容器内执行的命令是nginx bash 注意区别，细心体会。

VOLUME

设置你的卷，在启动容器的时候Docker会在/var/lib/docker的下一级目录下创建一个卷，以保存你在容器中产生的数据。若没有申明则不会创建。

指令语法

代码语言：javascript
复制
VOLUME ["/path/to/directory"]

示例

代码语言：javascript
复制
VOLUME ["/data"]
VOLUME ["/data","/app/etc"]

USER

指定容器运行的用户是谁，前提条件，用户必须存在。此指令可以在构建镜像是使用或指定容器中进程的运行用户是谁。

指令语法

代码语言：javascript
复制
USER <user>[:<group>]
USER <UID>[:<GID>]

示例

代码语言：javascript
复制
USER root
本文参与 腾讯云自媒体同步曝光计划，分享自微信公众号。
原始发表：2023-09-03，如有侵权请联系 cloudcommunity@tencent.com 删除
容器镜像服务
容器
基础
镜像
语法
目录
  • Docker 摸门级简易手册
    • 使用 Docker 构建 Java 项目镜像
    • Docker 安装
      • Install on Mac
      • Install on Windows
      • Install on Linux
    • Dockerfile 说明
      • FROM
      • LABEL
      • ENV
      • WORKDIR
      • COPY
      • ADD
      • RUN
      • CMD
      • EXPOSE
      • ENTRYPOINT
      • VOLUME
      • USER

腾讯云开发者

扫码关注腾讯云开发者

扫码关注腾讯云开发者

领取腾讯云代金券

热门产品

热门推荐

更多推荐

Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有 

深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号

腾讯云计算（北京）有限责任公司 京ICP证150476号 |  京ICP备11018762号

问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档