easycomlab/docker-cli

Docker CLI 镜像文档

概述

Docker CLI（Command Line Interface）是Docker生态系统的命令行工具，用于与Docker守护进程（Docker Engine）进行交互，实现对Docker资源的管理。通过Docker CLI，用户可执行镜像构建、容器运行、网络配置、数据卷管理等操作，是使用Docker进行应用开发、部署和运维的核心工具。

核心功能与特性

• 命令行交互：通过简洁的命令格式与Docker守护进程通信，支持丰富的子命令及参数选项。
• 全资源管理：统一管理容器、镜像、网络、数据卷等Docker核心资源。
• 镜像全生命周期操作：支持镜像拉取、推送、构建、标记、删除等完整流程。
• 容器生命周期控制：实现容器创建、启动、停止、重启、暂停、恢复及删除等操作。
• 跨平台兼容性：支持Linux、macOS、Windows等主流操作系统及x86_64、ARM等架构。

使用场景

• 开发环境管理：本地快速构建、测试容器化应用，模拟生产环境依赖。
• CI/CD流程集成：在自动化流水线中执行镜像构建、测试与推送操作。
• 服务器运维：管理生产环境中的容器集群，监控状态并执行扩缩容。
• 脚本自动化：通过Shell脚本集成Docker命令，实现批量资源管理。

使用方法与示例

基础环境准备

Docker CLI通常随Docker Engine一同安装，安装完成后可通过以下命令验证：

bash
docker --version  # 查看CLI版本
docker info       # 检查与Docker守护进程的连接状态

核心命令示例

1. 镜像操作

• 拉取镜像：从镜像仓库下载镜像

  bash
  docker pull [OPTIONS] NAME[:TAG|@DIGEST]
  # 示例：拉取nginx官方镜像（默认latest标签）
  docker pull nginx
  

• 构建镜像：基于Dockerfile创建自定义镜像

  bash
  docker build [OPTIONS] PATH | URL | -
  # 示例：在当前目录构建镜像，标签为my-app:v1
  docker build -t my-app:v1 .
  

• 列出本地镜像：查看已下载的镜像列表

  bash
  docker images [OPTIONS] [REPOSITORY[:TAG]]
  # 示例：列出所有本地镜像
  docker images
  

2. 容器操作

• 运行容器：基于镜像启动新容器

  bash
  docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
  # 示例：运行nginx容器，映射80端口，后台运行
  docker run -d -p 80:80 --name my-nginx nginx
  

• 查看容器状态：列出运行中或所有容器

  bash
  # 查看运行中容器
  docker ps
  # 查看所有容器（含已停止）
  docker ps -a
  

• 容器生命周期控制：停止、启动或重启容器

  bash
  # 停止容器
  docker stop my-nginx
  # 启动容器
  docker start my-nginx
  # 重启容器
  docker restart my-nginx
  

• 进入容器交互：在运行中的容器内执行命令

  bash
  docker exec [OPTIONS] CONTAINER COMMAND [ARG...]
  # 示例：进入my-nginx容器，启动交互式bash终端
  docker exec -it my-nginx bash
  

3. 网络与数据卷管理

• 创建自定义网络：实现容器间隔离通信

  bash
  docker network create [OPTIONS] NETWORK
  # 示例：创建名为app-network的桥接网络
  docker network create app-network
  

• 创建数据卷：持久化存储容器数据

  bash
  docker volume create [OPTIONS] VOLUME
  # 示例：创建名为app-data的数据卷
  docker volume create app-data
  

环境变量与配置

Docker CLI支持通过环境变量自定义行为，常用配置：

• DOCKER_HOST：指定Docker守护进程地址，默认通过unix:///var/run/docker.sock连接本地，远程连接时可设为tcp://<host>:<port>

  bash
  # 示例：连接远程Docker守护进程
  export DOCKER_HOST=tcp://192.168.1.100:2375
  

• DOCKER_CERT_PATH：TLS证书路径，用于加密远程连接
• DOCKER_CONFIG：自定义配置文件目录（默认~/.docker）

典型场景实践

开发环境快速部署

启动依赖服务（如MySQL），无需本地安装：

bash
# 启动MySQL容器，映射3306端口，设置root密码
docker run -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=devpass --name dev-mysql mysql:8.0

CI/CD流水线集成

在自动化流程中构建并推送镜像：

bash
# 登录镜像仓库
docker login -u $REGISTRY_USER -p $REGISTRY_PWD $REGISTRY_URL
# 构建镜像（标记包含仓库地址和构建版本）
docker build -t $REGISTRY_URL/app:${BUILD_ID} .
# 推送镜像至仓库
docker push $REGISTRY_URL/app:${BUILD_ID}

注意事项

• 需确保Docker守护进程（Docker Engine）已安装并运行（通过systemctl start docker启动服务）
• 私有镜像仓库操作需提前配置仓库地址及认证信息
• 多平台镜像管理可通过docker buildx插件实现跨架构构建
• 敏感操作（如docker rm -f、docker rmi -f）需谨慎执行，避免误删资源