Docker V1基础工具免费版

Docker V1基础工具 - 免费版

概述

Docker V1基础工具免费版为维护旧版Docker环境的开发者提供经典命令集支持。工具涵盖V1版本的容器生命周期管理、镜像构建管理、基础Compose编排和旧版环境兼容性检查,帮助开发者在V1环境中高效进行容器管理. 本版本适合旧版Docker环境维护、遗留系统容器管理和V1到V2迁移准备。所有命令均兼容Docker V1 API.

核心能力

1. V1容器生命周期管理

使用V1经典命令管理容器.

输入格式

# V1运行容器(经典命令格式)
docker run nginx                           # 前台运行
docker run -d nginx                        # 后台运行
docker run --name my-nginx -d nginx        # 命名运行
docker run -p 8080:80 -d nginx             # 端口映射
# V1容器管理
docker ps                                  # 查看运行中容器
docker ps -a                               # 查看所有容器
docker stop container_name                 # 停止容器
docker start container_name                # 启动容器
docker restart container_name              # 重启容器
docker rm container_name                   # 删除容器
docker rm -f container_name                # 强制删除
# V1容器清理
docker container prune                     # 清理已停止容器

处理: 解析V1容器生命周期管理的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回V1容器生命周期管理的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

2. V1镜像管理

# V1镜像构建
docker build -t myapp:1.0 .                       # 基础构建
docker build -f Dockerfile.dev -t myapp:dev .     # 指定Dockerfile
docker build --build-arg VERSION=1.0 -t myapp .   # 构建参数
docker build --no-cache -t myapp .                # 无缓存构建
# V1镜像操作
docker images                                     # 列出镜像
docker pull nginx:latest                          # 拉取镜像
docker tag myapp:1.0 myapp:latest                 # 打标签
docker push myrepo/myapp:1.0                      # 推送镜像
docker rmi image_name                             # 删除镜像
docker image prune                                # 清理悬空镜像
docker image prune -a                             # 清理所有未使用镜像

处理: 解析V1镜像管理的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回V1镜像管理的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

3. V1容器调试

# V1日志查看
docker logs container_name                        # 全部日志
docker logs -f container_name                     # 跟踪日志
docker logs --tail 100 container_name             # 最后100行
# V1执行命令
docker exec container_name ls -la                 # 执行命令
docker exec -it container_name bash               # 交互式进入
docker exec -u root -it container_name bash       # 以root进入
# V1容器检查
docker inspect container_name                     # 详细信息
docker inspect -f '{{.NetworkSettings.IPAddress}}' container_name
docker stats                                      # 资源使用
docker top container_name                         # 进程信息

处理: 解析V1容器调试的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回V1容器调试的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

4. V1 Compose编排

使用V1格式docker-compose命令进行编排.

# V1 Compose基础操作
docker-compose up                                # 启动服务
docker-compose up -d                             # 后台启动
docker-compose down                              # 停止并删除
docker-compose down -v                           # 同时删除卷
docker-compose logs                              # 查看日志
docker-compose logs -f web                       # 跟踪指定服务
docker-compose up -d --scale web=3               # 扩展服务实例
# V1 Compose服务管理
docker-compose ps                                # 查看服务状态
docker-compose exec web bash                     # 进入服务容器
docker-compose restart web                       # 重启服务
docker-compose build web                         # 重新构建
docker-compose up -d --build                     # 重建并启动

处理: 解析V1 Compose编排的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回V1 Compose编排的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

5. V1兼容性检查

#!/bin/bash
# V1环境兼容性检查脚本
echo "=== Docker V1 兼容性检查 ==="
# ...
# 1. Docker版本检查
echo "--- Docker版本 ---"
docker version
echo ""
# ...
# 2. API版本检查
echo "--- API版本 ---"
docker version --format '{{.Server.APIVersion}}'
echo ""
# ...
# 3. docker-compose版本
echo "--- docker-compose版本 ---"
docker-compose version 2>/dev/null || echo "docker-compose未安装"
echo ""
# ...
# 4. V1特性支持检查
echo "--- V1特性检查 ---"
API_VERSION=$(docker version --format '{{.Server.APIVersion}}' 2>/dev/null)
if [ -n "$API_VERSION" ]; then
    MAJOR=$(echo "$API_VERSION" | cut -d. -f1)
    if [ "$MAJOR" -ge 1 ] && [ "$MAJOR" -lt 24 ]; then
        echo "[OK] 支持V1 API (版本: $API_VERSION)"
    else
        echo "[!] API版本较高 ($API_VERSION),建议使用V2工具"
    fi
fi
# ...
# 5. 检查docker-compose V1
if command -v docker-compose &> /dev/null; then
    echo "[OK] docker-compose V1已安装"
else
    echo "[!] docker-compose V1未安装,建议安装或使用 docker compose V2"
fi

处理: 解析V1兼容性检查的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回V1兼容性检查的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：经典命令集与基础、适合维护旧版、环境的开发者、面向旧版、环境的容器管理工、经典命令集、基础容器生命周期、与镜像管理、核心能力、经典命令支持、镜像构建与标签管、旧版环境兼容性检等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景一:旧版环境容器管理

在旧版Docker环境中管理容器.

#!/bin/bash
# 旧版环境容器管理脚本
echo "=== 旧版Docker环境管理 ==="
# ...
# 检查Docker版本
echo "Docker版本:"
docker version --format 'Client: {{.Client.Version}} / Server: {{.Server.Version}}'
# ...
# 列出所有容器
echo -e "\n运行中容器:"
docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}"
# ...
# 列出所有镜像
echo -e "\n本地镜像:"
docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"
# ...
# 磁盘使用
echo -e "\n磁盘使用:"
docker system df

场景二:V1 Compose服务管理

使用V1格式Compose文件管理服务.

# docker-compose.yml (V1格式)
version: '2'  # V1常用版本号
services:
  web:
    image: nginx:1.19
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
    restart: always
# ...
  db:
    image: postgres:13
    environment:
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: mydb
    volumes:
      - db-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
# ...
volumes:
  db-data:

# V1 Compose操作
docker-compose up -d                    # 启动服务
docker-compose ps                       # 查看状态
docker-compose logs -f web              # 查看日志
docker-compose down                     # 停止服务

场景三:迁移前环境评估

评估V1环境,为迁移到V2做准备.

#!/bin/bash
# V1到V2迁移前评估
echo "=== V1到V2迁移评估 ==="
# ...
# 1. 当前环境信息
echo "--- 当前环境 ---"
echo "Docker版本: $(docker version --format '{{.Server.Version}}')"
echo "API版本: $(docker version --format '{{.Server.APIVersion}}')"
# ...
# 2. Compose版本检查
echo -e "\n--- Compose检查 ---"
if docker-compose version &>/dev/null; then
    COMPOSE_V1=$(docker-compose version --short)
    echo "docker-compose V1: $COMPOSE_V1"
fi
# ...
if docker compose version &>/dev/null; then
    COMPOSE_V2=$(docker compose version --short)
    echo "docker compose V2: $COMPOSE_V2"
fi
# ...
# 3. Compose文件版本扫描
echo -e "\n--- Compose文件版本 ---"
find . -name "docker-compose*.yml" -exec sh -c '
    echo "文件: $1"
    grep "^version:" "$1" | head -1
' _ {} \;
# ...
# 4. 已弃用特性检查
echo -e "\n--- 弃用特性检查 ---"
find .yml" -exec grep -l "links:" {} \; | \
    while read f; do
        echo "[!] $f 使用了已弃用的 links 特性"
    done
# ...
find . -name "Dockerfile*" -exec grep -l "MAINTAINER " {} \; | \
    while read f; do
        echo "[!] $f 使用了已弃用的 MAINTAINER 指令"
    done
# ...
echo -e "\n评估完成"

不适用场景

以下场景Docker V1基础工具免费版不适合处理：

• 无明确技术栈的模糊需求
• 纯架构设计决策
• 运维部署管理

触发条件

需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于非本工具能力范围的需求.

快速开始

Step 1:检查环境兼容性

# 验证Docker V1环境
docker version
docker-compose version

Step 2:触发容器操作

在 AI Agent 中输入:

当前环境使用Docker V1,请帮我管理容器和镜像.

Step 3:执行操作

Agent 会使用V1兼容命令执行容器管理操作. 响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

V1环境配置

# .docker-v1.yml - V1环境配置
version: "1.0"
edition: free
# ...
# V1兼容设置
compatibility:
  api_version: "1.39"      # V1 API版本
  compose_version: "2"      # Compose文件版本
  use_v1_compose: true      # 使用docker-compose(V1)命令
# 容器默认配置
defaults:
  restart_policy: always
  network_mode: bridge
# ...
# 常用镜像
images:
  web: nginx:1.19
  db: postgres:13
  cache: redis:6

V1 Dockerfile示例

# V1兼容Dockerfile
FROM node:14
# ...
# V1兼容:使用MAINTAINER(已弃用但V1支持)
LABEL maintainer="dev@company.com"
# ...
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
# ...
EXPOSE 3000
CMD ["npm", "start"]

最佳实践

1. 版本固定:在V1环境中固定镜像版本,避免自动更新

# 固定版本(不使用latest)
FROM node:14.21.3
FROM nginx:1.19.10

1. 兼容性测试:新镜像在V1环境测试后再部署

# 在V1环境测试镜像
docker run --rm myapp:1.0 echo "兼容性测试通过"

1. 渐进迁移:逐步将服务从V1迁移到V2

# 检查哪些Compose文件使用了V1特性
grep -rn "version: '2'" . --include="docker-compose*.yml"

1. 备份配置:迁移前备份所有V1配置

# 备份V1配置
tar -czf docker-v1-backup-$(date +%Y%m%d).tar.gz \
    docker-compose*.yml \
    Dockerfile* \
    .dockerignore

1. 文档化:记录V1环境的特殊配置和已知问题

常见问题

Q1:如何判断当前是否为V1环境?

# 检查API版本
Server.APIVersion}}' 2>/dev/null)
echo "API版本: $API_VERSION"
# ...
# V1 API版本范围: 1.0 - 1.39
# V2 API版本范围: 1.40+
# 检查docker-compose vs docker compose
which docker-compose   # V1命令
docker compose version # V2命令

已知限制

Q3:如何从V1迁移到V2?

# 依赖说明
# 参考 docs.docker.com 安装最新版
# 2. 安装Compose V2插件
sudo apt install docker-compose-plugin  # Debian/Ubuntu
# 3. 验证V2
docker compose version
# ...
# 4. 测试V1配置兼容性
docker compose config  # 验证V1的compose文件
# 5. 逐步替换命令
# 旧: docker-compose up -d
# 新: docker compose up -d

Q4:V1环境镜像构建注意事项?

# V1兼容Dockerfile注意事项:
# 1. 不使用BuildKit特性(如--mount)
# 2. 不使用多平台构建(如--platform)
# 3. LABEL替代MAINTAINER(虽然V1支持MAINTAINER)
# 4. 确保基础镜像版本兼容
FROM node:14  # 使用V1兼容的版本

Q5:免费版与专业版有何区别?

依赖说明

运行环境

• Agent 平台:支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统:Windows / macOS / Linux
• 运行时:Docker Engine 1.0+ (V1 API)
• 可选:docker-compose V1

第三方依赖

API Key 配置

• 本 Skill 基于 Markdown 指令,无需额外 API Key
• 如需访问私有仓库,需配置认证:

# V1私有仓库认证
docker login registry.example.com

可用性分类

• 分类:MD+EXEC(纯 Markdown 指令,需要 exec 命令行执行能力)
• 说明:基于 Markdown 的 AI Skill,通过自然语言指令驱动 Agent 执行V1 Docker管理任务
• 适用规模:单机环境,适合旧版Docker维护场景
• 兼容性:兼容Docker V1 API,可后续升级到V2工具

错误处理

输出格式

{
  "success": true,
  "data": {
    "result": "Docker V1基础工具免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "docker essentials v1"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}