docker note

Docker Note

Docker

容器化: 是一种 轻量级 的操作系统虚拟化方法。将应用、依赖、配置等集成为一个专有环境
具有:

  • 可移植性
    • 在一次构建与配置后,可以在任何装有Docker引擎的环境中一致运行
  • 更轻量化
    • 通过直接共享主机的操作系统内核,达到了相对于完整的虚拟机模拟程序, 更快的启动速度 、 更低的资源占用 的效果
    • 一台物理机可同时运行上千个容器
  • 资源隔离
    • 每个容器都拥有其自己独立的文件系统、网络和进程空间,互不干扰,安全性更高

Docker 的三个核心概念

  • 镜像 (Image)
    • 一个只读的模板,用于创建容器
  • 容器 (Container)
    • 镜像的运行实例,是运行实际应用的环境
  • 仓库 (Repository)
    • 集中存放和分享镜像的存储区域 如 Docker Hub

构建自己的容器镜像

为构建自己项目的一份镜像,需要编写 Dockerfile 与 .dockerignore 文件 控制镜像容器的构建
详细内容,请参考 官方教程

如 github.com/iLogIng/http_server 中的 Dockerfile 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# 构建

FROM ubuntu:24.04 AS builder

RUN apt-get update \
&& apt-get install -y --no-install-recommends \
g++ cmake make \
libboost-system-dev libboost-thread-dev \
libboost-filesystem-dev libboost-log-dev \
libboost-program-options-dev libboost-json-dev \
&& rm -rf /var/lib/apt/lists/*

COPY . /src
WORKDIR /src/build

RUN cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTING=OFF \
&& cmake --build . --parallel $(nproc) \
&& ls -la /src/build/

# 运行

FROM ubuntu:24.04

# 仅安装运行时库
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
libboost-system1.83.0 \
libboost-thread1.83.0 \
libboost-filesystem1.83.0 \
libboost-log1.83.0 \
libboost-program-options1.83.0 \
libboost-json1.83.0 \
&& rm -rf /var/lib/apt/lists/*

# 从构建阶段拷贝编译好的二进制 根据CMakeLists.txt构建规则
COPY --from=builder /src/build/src/http_server /usr/local/bin/http_server

# 创建工作目录
WORKDIR /srv

# 仅拷贝静态资源目录
COPY ./app ./app

# 创建非 root 用户 授权工作目录用于写日志
RUN useradd -m -s /bin/bash http_server_user \
&& chown -R http_server_user:http_server_user /srv
USER http_server_user

EXPOSE 8080

ENTRYPOINT ["http_server"]
CMD ["--address", "0.0.0.0", "--port", "8080", "--doc_root", "./app", "--threads", "2"]
  • FROM
    • 指定基础镜像,用于后续的指令构建
  • RUN
    • RUN <shell>
    • RUN ["exec", "arg1", "arg2", ...]
    • docker build 时运行
    • 在构建过程中在 镜像中 执行命令
    • 注意:Dockerfile的指令每执行一次都会在docker上新建一层,会导致镜像膨胀,可使用 && 符号连接命令
  • CMD
    • CMD <shell>
    • CMD ["exec", "arg1", "arg2", ...]
    • ENTRYPOINT ["exec", "arg1", "arg2", ...] \ CMD ["arg1", "arg2", ...]
    • docker run 时运行
    • 指定容器创建时的主要命令(可被覆盖)
  • ENTRYPOINT
    • ENTRYPOINT ["exec", "arg1", "arg2", ...]
    • 设置为固定参数
    • 设置容器创建时的主要命令(不可被覆盖)
  • EXPOSE
    • EXPOSE <port1> [port2, ...]
    • 指定容器运行时监听的特定网络端口
  • ENV
    • 在容器内部设置环境变量
  • ADD
    • 将文件、目录或远程URL复制到镜像中
  • COPY
    • COPY <host> <image>
    • 将文件或目录复制到镜像中
  • USER
    • USER <username>[:usergrade]
    • 指定后续指令的用户上下文

运行容器镜像

构建

docker build

1
2
3
docker build -t my-http-server:v2 .

# docker 在当前目录下 构建(build) 名为 my-http-server 的镜像 版本标签为 v2 默认为 latest

部署运行

docker run

1
2
3
docker run --rm -p 8080:8080 my-http-server:v2

# docker 镜像创建并启动名为 my-http-server:v2 的容器 映射端口为<host-port 8080>:<container-port 8080> 当容器停止/退出时,自动删除该容器实例