Portable CLI 镜像文档

概述

Portable CLI 镜像是一个轻量级、可移植的Docker镜像，旨在提供便捷的命令行工具环境。该镜像无需本地安装依赖，可直接通过Docker容器运行，确保在不同操作系统和环境中获得一致的命令行体验，适用于快速执行命令行任务和工具调用。

核心功能与特性

• 跨平台兼容性：支持Linux、macOS、Windows等主流操作系统，通过Docker实现环境一致性
• 零本地依赖：无需在主机系统安装命令行工具依赖，所有依赖均封装在镜像内部
• 轻量级设计：基于精简基础镜像构建，减少资源占用，启动速度快
• 即开即用：无需复杂配置，通过简单Docker命令即可启动并执行命令行操作
• 工具隔离：与主机系统工具环境隔离，避免版本冲突和环境污染

使用场景

• 开发环境快速部署：为开发团队提供统一的命令行工具版本，避免"在我电脑上能运行"问题
• 自动化脚本执行：在CI/CD流水线或定时任务中作为独立命令行环境执行脚本
• 临时命令行任务：快速执行一次性命令行操作，如文件处理、数据转换、网络测试等
• 多环境一致工具版本：确保开发、测试、生产环境使用相同版本的命令行工具，提升任务可重复性

使用方法

基本使用

通过docker run命令直接启动并执行命令：

# 基本命令执行示例
docker run --rm portable-cli [命令参数]

# 示例：执行echo命令
docker run --rm portable-cli echo "Hello from Portable CLI"

挂载本地文件

如需操作本地文件，可通过-v参数挂载主机目录：

# 挂载当前目录到容器的/workspace目录
docker run --rm -v $(pwd):/workspace portable-cli ls /workspace

交互式使用

通过-it参数进入交互式命令行环境：

docker run --rm -it portable-cli /bin/sh

环境变量配置

可通过-e参数设置环境变量，自定义工具行为：

示例：设置调试日志级别

docker run --rm -e LOG_LEVEL=debug portable-cli [命令参数]

注意事项

• 镜像默认以非root用户运行，如需管理员权限，可添加--user root参数
• 长时间运行的任务建议添加--detach参数后台执行
• 敏感操作需注意数据安全，避免将包含敏感信息的目录挂载到容器中