Docker 基础命令介绍和常见报错解决

embedded/2024/11/18 18:33:50/

介绍一些 docker 可能用到的基础命令，并解决三个常见报错：

  • 权限被拒绝（Permission Denied）
  • 无法连接到 Docker 仓库（Timeout Exceeded）
  • 磁盘空间不足（No Space Left on Device）

命令以适用于深度学习的 dl 镜像为例进行演示。

Docker 安装见《用两行命令快速搭建深度学习环境（Docker/torch2.5.1+cu118/命令行美化+插件），包含完整的 Docker 安装步骤》

文章目录

  • 镜像管理
    • 查看本地镜像
    • 拉取镜像
    • 删除镜像
  • 创建容器
    • 挂载
    • 在容器中启动 Jupyter Lab
  • 停止容器
  • 重新连接到已存在的容器
  • 命名容器
    • 使用 `--name` 参数
    • 使用容器名称的命令示例
  • 复制文件
    • 从主机复制文件到容器
    • 从容器复制文件到主机
  • 删除容器
  • 解决常见报错
    • 报错 1：权限被拒绝（Permission Denied）
      • 方法 1：使用 `sudo`
      • 方法 2：将用户添加到 `docker` 用户组
    • 报错 2：无法连接到 Docker 仓库（Timeout Exceeded）
      • 方法一：配置镜像
      • 方法二：设置 HTTP/HTTPS 代理
    • 报错 3: 磁盘空间不足（No Space Left on Device）
      • 更改 Docker 的数据目录
  • 参考链接

镜像管理

写在前面

如果不想每次运行都使用 sudo 开头，使用以下命令：

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

查看本地镜像

docker images

列出本地所有的 Docker 镜像，包括仓库名、标签、镜像 ID、创建时间和大小。

image-20241112223609346

拉取镜像

docker pull <image_name>:<tag>

例如：

docker pull hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

docker pull 可以更新镜像，此时下载数据量较小，不严谨地类比为 git pull 进行理解。

删除镜像

docker rmi <image_id_or_name>

注意： 删除镜像前，确保没有容器正在使用它。

创建容器

以当前使用的命令为例：

docker run --gpus all -it hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

先来解释一下 --gpus all 和 -it 的作用：

  • --gpus all：允许容器使用主机的所有 GPU 资源。
  • -it：这是两个参数的组合，-i 表示“交互式”（interactive），-t 表示为容器分配一个伪终端（pseudo-TTY）。-it 组合使用可以获得完整的交互式终端体验。

使用 docker run --help 可以查看更多参数的用法。

如果在执行 Docker 命令时遇到权限问题，可以在命令前加上 sudo。

挂载

如果需要在容器内访问主机的文件，可以使用 -v 参数。

  1. 卷挂载

    docker run --gpus all -it -v my_volume:container_path hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel
    • my_volume：Docker 卷的名称。
    • container_path：容器中的路径。

    这样，保存在该路径的数据在容器删除后仍会保存在 my_volume 中。

  2. 绑定主机目录到容器中

    docker run --gpus all -it -v /home/your_username/data:/workspace/data hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel
    • /home/your_username/data：主机上的目录路径。
    • /workspace/data：容器内的挂载点。

在容器中启动 Jupyter Lab

如果需要在容器内启动 Jupyter Lab，并通过主机的浏览器进行访问，可以使用 -p 参数映射端口。Jupyter Lab 默认使用 8888 端口，使用以下命令：

docker run --gpus all -it -p 8888:8888 hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel
  • -p 8888:8888 将容器内的 8888 端口映射到主机的 8888 端口。

然后在容器内运行：

jupyter lab --ip=0.0.0.0 --port=8888 --no-browser --allow-root

现在可以在主机浏览器中访问 http://localhost:8888。

停止容器

在容器终端内

  • 使用 Ctrl+D 或输入 exit：退出并停止容器（适用于通过 docker run 启动的情况）。
  • 使用 Ctrl+P 然后 Ctrl+Q：仅退出容器的终端（detach），让容器继续在后台运行。

以上的“停止”行为适用于通过 docker run 启动的容器。如果容器是通过 docker start 启动的，Ctrl+D 或 exit 只会退出终端，而不会停止容器。通过 docker ps 可以察觉到这一点。

从主机停止容器

如果你想从主机停止正在运行的容器，可以使用：

docker stop <container_id_or_name>

替换 <container_id_or_name> 为容器的 ID 或名称。

重新连接到已存在的容器

在使用一段时间后，你可能会发现每次使用 docker run 去“运行”容器时，之前所做的改变都“没有”保存。

这是因为每次运行 docker run 创建了新的容器。

要找回在容器中的更改，需要重新连接到之前创建的容器。

查看所有容器

docker ps -a
  • docker ps：默认只显示正在运行的容器。
  • -a：显示所有容器，包括已停止的。

启动已停止的容器

如果目标容器已停止，可以使用以下命令将其重新启动：

docker start <container_id_or_name>

替换 <container_id_or_name> 为容器的 ID 或名称。

重新连接到运行中的容器

使用 docker exec：

docker exec -it <container_id_or_name> /bin/bash
  • /bin/bash：在容器内启动一个 Bash Shell。
  • 在 docker run 命令末尾也可添加 /bin/bash。

在之前的命令中，我们使用了 /bin/zsh，这是因为该容器中已安装了 zsh。而在大多数容器中，默认的行为通常是 /bin/bash 或 /bin/sh。

命名容器

有没有什么方法可以指定名称呢？每次通过 docker ps -a 复制 id 太不优雅了。

使用 --name 参数

在创建容器时，可以使用 --name 参数为容器指定一个名称。例如：

docker run --gpus all -it --name ai hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

容器被命名为 ai，以后可通过该名称管理容器，不需要记住容器的 ID。

运行 docker ps -a：

image-20241112215358397

使用容器名称的命令示例

复制文件

从主机复制文件到容器

docker cp /path/on/host <container_id_or_name>:/path/in/container

从容器复制文件到主机

docker cp <container_id_or_name>:/path/in/container /path/on/host

删除容器

删除指定的容器

如果想删除一个容器，可以使用 docker rm 命令：

docker rm <container_id_or_name>

例如，删除名为 ai 的容器：

docker rm ai

注意： 需要先停止容器才能删除。

删除所有未使用的容器

我们可以使用以下命令来删除所有处于“已退出”状态的容器：

docker container prune

这将删除所有已停止的容器（请谨慎使用，因为删除后无法恢复，适用于刚安装 Docker “不小心”创建了一堆容器）。

解决常见报错

介绍在新环境中使用 Docker 时，可能会遇到的报错。

推荐阅读，特别是报错 2。

报错 1：权限被拒绝（Permission Denied）

当运行命令：

docker ps

可能会遇到以下报错：

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get “http://%2Fvar%2Frun%2Fdocker.sock/v1.45/containers/json”: dial unix /var/run/docker.sock: connect: permission denied

解决方法：

方法 1：使用 sudo

在 Docker 命令前加上 sudo：

sudo docker ps

docker__283">方法 2：将用户添加到 docker 用户组

  1. 创建 docker 用户组

    sudo groupadd docker

  2. 将当前用户添加到 docker 组

    sudo usermod -aG docker $USER

  3. 重新加载用户组设置

    newgrp docker

  4. 验证

    运行 Docker 命令，如果不提示权限错误（permission denied），说明配置成功。

    docker ps

报错 2：无法连接到 Docker 仓库（Timeout Exceeded）

Error response from daemon: Get “https://registry-1.docker.io/v2/”: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

原因： 由于国内网络限制，无法直接连接到 Docker Hub。

解决方法：

方法一：配置镜像

镜像参考：目前国内可用Docker镜像源汇总（截至2024年11月）

临时使用：

直接在原 <image_name>:<tag> 前增加网址，比如：

docker pull dockerpull.org/<image_name>:<tag>

快速测试可用性：

docker pull dockerpull.org/hello-world

永久使用：

运行以下命令配置文件，如果有一天突然拉（pull）不动了，说明链接挂了需要更新。

# 创建目录
sudo mkdir -p /etc/docker# 写入配置文件
sudo tee /etc/docker/daemon.json > /dev/null <<-'EOF'
{"registry-mirrors": ["https://docker.unsee.tech","https://dockerpull.org","https://docker.1panel.live","https://dockerhub.icu"]
}
EOF# 重启 Docker 服务
sudo systemctl daemon-reload
sudo systemctl restart docker

方法二：设置 HTTP/HTTPS 代理

这一项提供给🪜科学上网的同学进行配置。对于本项目来说，所有文件都会提供网盘链接和对应的国内镜像命令。

  1. 创建并编辑 Docker 的系统服务配置文件

    sudo mkdir -p /etc/systemd/system/docker.service.d
sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf

  2. 添加代理配置

    在 http-proxy.conf 文件中添加以下内容（将 http://localhost:7890/ 替换为你自己的代理地址）：

    [Service]
Environment="HTTP_PROXY=http://localhost:7890/"
Environment="HTTPS_PROXY=http://localhost:7890/"

    使用 ESC + :wq 回车保存配置。

    如果不熟悉 vim 的操作，也可以使用直接运行（将 http://localhost:7890/ 替换为你自己的代理地址）：

    sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf > /dev/null <<EOF
[Service]
Environment="HTTP_PROXY=http://localhost:7890/"
Environment="HTTPS_PROXY=http://localhost:7890/"
EOF

  3. 重新加载配置并重启 Docker 服务

    sudo systemctl daemon-reload
sudo systemctl restart docker

报错 3: 磁盘空间不足（No Space Left on Device）

write /var/lib/docker/tmp/…: no space left on device

原因： Docker 默认使用 /var/lib/docker 作为数据存储目录，如果该分区空间不足，就会出现此错误。

解决方法：

更改 Docker 的数据目录

  1. 查看当前的磁盘空间

    检查 /var/lib/docker 所在分区的剩余空间：

    sudo df -h /var/lib/docker

    image-20241113155339843

    2.3G 显然不够。

  2. 选择具有足够空间的目录

    假设将 Docker 的数据目录移动到 ~/Downloads 下，先看看剩余空间：

    image-20241112100834923

    显示还有 53G，绰绰有余，接着创建文件夹：

    mkdir -p ~/Downloads/Docker && cd ~/Downloads/Docker && pwd

    image-20241112105217964

    复制输出。

  3. 修改 Docker 的配置文件

    编辑 /etc/docker/daemon.json 文件（如果不存在会自动创建）：

    sudo vim /etc/docker/daemon.json

    添加或修改以下内容（将 Path/to/Docker 替换为你的新数据目录的绝对路径，也就是刚刚复制的输出）：

    { "data-root": "Path/to/Docker"
}

    ESC + :wq保存并退出。

    image-20241113195541233

  4. 重启 Docker 服务并验证

    sudo systemctl restart docker
docker info -f '{{ .DockerRootDir}}'

    输出：image-20241112101614536

参考链接

How to Fix Docker’s No Space Left on Device Error


http://www.ppmy.cn/embedded/138606.html

相关文章

Vue3 provide 和 inject的使用

Vue3 provide 和 inject的使用

在 Vue 中&#xff0c;provide 和 inject 是 Composition API 的一对功能&#xff0c;用于父子组件之间的依赖注入。它们的作用是让父组件可以向其所有子组件提供数据或方法&#xff0c;而不需要通过逐层传递 props。 1. provide provide 用于父组件中&#xff0c;提供数据或…
阅读更多...
多目标优化算法：多目标鹅算法(MOGOOSE)求解UF1-UF10，提供完整MATLAB代码

多目标优化算法：多目标鹅算法(MOGOOSE)求解UF1-UF10，提供完整MATLAB代码

一、鹅算法GOOSE 鹅算法&#xff08;Goose Algorithm&#xff0c;简称GOOSE&#xff09;是一种新型的元启发式算法&#xff0c;灵感来源于鹅在休息和觅食时的行为。GOOSE算法由Rebwar Khalid Hamad等人于2024年1月发表在Springer旗下的非开源SCI期刊《Evolving Systems》上。该…
阅读更多...
Redis 持久化机制 RDB 和 AOF 区别

Redis 持久化机制 RDB 和 AOF 区别

Redis 是一个开源的内存数据结构存储系统&#xff0c;广泛应用于缓存、会话存储、实时分析等场景。虽然 Redis 本质上是内存数据库&#xff0c;但它支持持久化机制&#xff0c;将数据保存在磁盘中以防止数据丢失。在 Redis 中&#xff0c;主要有两种持久化机制&#xff1a;RDB(…
阅读更多...
前端隐藏元素的方式有哪些？HTML 和 CSS 中隐藏元素的多种方法

前端隐藏元素的方式有哪些？HTML 和 CSS 中隐藏元素的多种方法

当面试官突然问你&#xff1a;“前端隐藏元素的方式有哪些&#xff1f;”你还是只知道 display: none 吗&#xff1f; 其实&#xff0c;在前端开发的世界里&#xff0c;隐藏元素的方法非常多。每种方法都有自己的小技巧和使用场景&#xff0c;了解它们不仅能让你应对自如&…
阅读更多...
【Python系列】Python中打印详细堆栈信息的技巧

【Python系列】Python中打印详细堆栈信息的技巧

&#x1f49d;&#x1f49d;&#x1f49d;欢迎来到我的博客&#xff0c;很高兴能够在这里和您见面&#xff01;希望您在这里可以感受到一份轻松愉快的氛围&#xff0c;不仅可以获得有趣的内容和知识&#xff0c;也可以畅所欲言、分享您的想法和见解。 推荐:kwan 的首页,持续学…
阅读更多...
elementUI input 禁止内容两端存在空格，或者是自动去除两端空格

elementUI input 禁止内容两端存在空格，或者是自动去除两端空格

需求 项目中有需求&#xff1a;输入框中禁止内容两端存在空格&#xff0c;或者是自动去除两端空格。 解决方法 vue的api文档中有过介绍&#xff0c;使用.trim可以去掉用户输入内容中两端的空格&#xff0c;如下图 代码 <el-input v-model.trim"name" cleara…
阅读更多...
Rust：原子操作 AtomicBool

Rust：原子操作 AtomicBool

在 Rust 中&#xff0c;你可以使用 std::sync::atomic 模块来进行原子操作。原子操作在多线程环境中特别有用&#xff0c;因为它们可以确保操作的原子性和可见性&#xff0c;从而避免数据竞争和其他并发问题。 为了读取和设置布尔值&#xff0c;你可以使用 AtomicBool 类型。以…
阅读更多...
8. 基于 Redis 实现限流

8. 基于 Redis 实现限流

在高并发的分布式系统中&#xff0c;限流是保证服务稳定性的重要手段之一。通过限流机制&#xff0c;可以控制系统处理请求的频率&#xff0c;避免因瞬时流量过大导致系统崩溃。Redis 是一种高效的缓存数据库&#xff0c;具备丰富的数据结构和原子操作&#xff0c;适合用来实现…
阅读更多...
最新文章

Copyright @ 2022~2023