Docker 指南 - 须臾自省

898 字

4 分钟

Docker 指南

2025-02-16

工具

Docker 常用指令#

镜像管理类指令#

docker images：列出本地存储的镜像。
docker pull [image_name]：从仓库拉取镜像。
docker rmi [image_name]：删除一个或多个镜像。
docker search [image_name]：在 Docker Hub 上搜索镜像。
docker build [Dockerfile_path]：从 Dockerfile 构建镜

容器管理类指令#

docker ps [OPTIONS]：显示容器信息
- -a 显示所有容器的信息（包括已开启和已关闭的）
- -q 显示正在运行的容器的 ID
- -S 显示正在运行的容器所占用的磁盘空间
docker run [OPTIONS] IMAGE [COMMAND] [ARG...]：创建并运行容器
- 由 docker create 和 docker start 组成
- -p [host port]:[container port] 指定端口映射
- -v [host volume]:[container volume] 将指定宿主卷挂载到容器中
docker create IMAGE：从镜像创建一个容器
docker status [CONTAINER ID]：查看容器运行状态
docker start [CONTAINER ID]：开启容器
docker restart [CONTAINER ID]：重启容器
docker stop [CONTAINER ID]：关闭容器
docker kill [CONTAINER ID]：强制关闭容器
docker rm [CONTAINER ID]：删除容器
docker attach [CONTAINER ID]：进入已开启的容器

Docker 安装#

基础#

Install Docker Engine on Ubuntu

清理冲突的软件包:

1
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

设置 docker 仓库:

1
# Add Docker's official GPG key:
2
sudo apt update
3
sudo apt install ca-certificates curl
4
sudo install -m 0755 -d /etc/apt/keyrings
5
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
6
sudo chmod a+r /etc/apt/keyrings/docker.asc
7

8
# Add the repository to Apt sources:
9
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
10
Types: deb
11
URIs: https://download.docker.com/linux/ubuntu
12
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
13
Components: stable
14
Architectures: $(dpkg --print-architecture)
15
Signed-By: /etc/apt/keyrings/docker.asc
16
EOF
17

18
sudo apt update

安装 docker 及相关软件包:

1
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

验证:

1
sudo systemctl status docker
2
sudo docker run hello-world

镜像源#

参考: 解决docker拉取镜像报错

国内一般是连不上默认的源:

1
xxx@xxx:~$ sudo docker run hello-world
2
Unable to find image 'hello-world:latest' locally
3
docker: Error response from daemon: failed to resolve reference "docker.io/library/hello-world:latest": failed to do request: Head "https://registry-1.docker.io/v2/library/hello-world/manifests/latest": dial tcp 104.23.124.189:443: i/o timeout
4

5
Run 'docker run --help' for more information

更新镜像，

1
sudo vim /etc/docker/daemon.json

将 daemon.json 的内容替换成如下内容:

1
{
2
"registry-mirrors" : [
3
  "https://docker.registry.cyou",
4
  "https://docker-cf.registry.cyou",
5
  "https://dockercf.jsdelivr.fyi",
6
  "https://docker.jsdelivr.fyi",
7
  "https://dockertest.jsdelivr.fyi",
8
  "https://mirror.aliyuncs.com",
9
  "https://dockerproxy.com",
10
  "https://mirror.baidubce.com",
11
  "https://docker.m.daocloud.io",
12
  "https://docker.nju.edu.cn",
13
  "https://docker.mirrors.sjtug.sjtu.edu.cn",
14
  "https://docker.mirrors.ustc.edu.cn",
15
  "https://mirror.iscas.ac.cn",
16
  "https://docker.rainbond.cc",
17
  "https://do.nark.eu.org",
18
  "https://dc.j8.work",
19
  "https://dockerproxy.com",
20
  "https://gst6rzl9.mirror.aliyuncs.com",
21
  "https://registry.docker-cn.com",
22
  "http://hub-mirror.c.163.com",
23
  "http://mirrors.ustc.edu.cn/",
24
  "https://mirrors.tuna.tsinghua.edu.cn/",
25
  "http://mirrors.sohu.com/" ],
26
  "insecure-registries" : [
27
    "registry.docker-cn.com",
28
    "docker.mirrors.ustc.edu.cn"
29
  ],
30
  "debug": true,
31
  "experimental": false
32
}

重新加载并重启 docker:

1
sudo systemctl daemon-reload
2
sudo systemctl restart docker

构建 Docker 容器#

准备工作#

确定运行环境
确定依赖文件
确定启动命令
确定监听端口

编写 `.dockerignore`#

1
__pycache__
2
*.pyc
3
.git
4
.env
5
.venv
6
venv
7
*.md
8
.gitignore
9
Dockerfile
10
.dockerignore

编写 `dockerfile`#

1
# 1. 基础镜像
2
FROM python:3.9-slim
3

4
# 2. 设置工作目录
5
WORKDIR /app
6

7
# 3. 复制依赖文件（先复制，利用缓存）
8
COPY requirements.txt .
9

10
# 4. 安装依赖
11
RUN pip install --no-cache-dir -r requirements.txt
12

13
# 5. 复制代码（后复制，代码变动不影响依赖层）
14
COPY . .
15

16
# 6. 暴露端口
17
EXPOSE 8000
18

19
# 7. 启动命令
20
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

构建镜像#

1
# 1. 基本构建
2
docker build -t myapp:latest .
3

4
# 2. 指定 Dockerfile 名称（如果不是默认名）
5
docker build -f Dockerfile.dev -t myapp:dev .
6

7
# 3. 查看构建后的镜像
8
docker images

运行容器#

1
# 1. 基本运行
2
docker run -d -p 8000:8000 myapp:latest
3

4
# 2. 带环境变量运行
5
docker run -d -p 8000:8000 -e DEBUG=true myapp:latest
6

7
# 3. 挂载本地代码（开发用，热重载）
8
docker run -d -p 8000:8000 -v $(pwd):/app myapp:latest
9

10
# 4. 查看运行中的容器
11
docker ps
12

13
# 5. 查看日志
14
docker logs -f <容器ID>

多容器需要编写 `docker-compose.yml`#

1
services:
2
  app:
3
    build: .            # 不使用现成的容器，从当前目录的 Dockerfile 构建
4
    ports:              # 端口映射
5
      - "8000:8000"         # 宿主机端口:容器端口
6
    depends_on:         # 容器依赖
7
      - mysql               # mysql 数据库
8
    environment:        # 环境变量
9
      DB_HOST: mysql        # 用服务名作为主机名
10

11
  mysql:
12
    image: mysql:8.0    # 使用 mysql 8.0 镜像
13
    environment:
14
      MYSQL_ROOT_PASSWORD: 123456
15
    volumes:            # 把容器里的数据库文件持久化到宿主机上
16
      - mysql_data:/var/lib/mysql
17

18
volumes:
19
  mysql_data: