apecloud/openconsole

openconsole Docker镜像文档

概述

openconsole是一个轻量级开源控制台应用Docker镜像，基于主流Linux发行版构建，提供基础命令行操作环境。该镜像为开发人员和系统管理员提供便捷、一致的命令行工作环境，适用于软件开发、系统测试、服务器管理等多种场景。

核心功能和特性

• 基于轻量级Linux发行版，镜像体积小，启动速度快
• 包含常用命令行工具，如bash、ls、cp、mv、rm等基础命令
• 支持标准输入输出交互，提供完整终端体验
• 可扩展性强，支持通过自定义配置和额外安装软件扩展功能
• 跨平台兼容，可在任何支持Docker的操作系统上运行

使用场景和适用范围

• 开发环境：为开发人员提供一致的命令行开发环境
• 测试环境：用于运行自动化测试脚本和命令行测试工具
• 服务器管理：作为轻量级管理工具，执行服务器维护任务
• 学习环境：供初学者学习Linux命令行操作
• CI/CD流程：集成到持续集成和部署流程中执行命令行任务

使用方法和配置说明

基本使用方法

简单运行

bash
docker run -it --rm openconsole

参数说明：

• -it：启用交互式终端模式
• --rm：容器退出后自动删除容器文件

挂载本地目录

将本地目录挂载到容器中实现文件共享：

bash
docker run -it --rm -v /本地目录:/容器目录 openconsole

挂载当前目录到容器的/workspace目录：

bash
docker run -it --rm -v $(pwd):/workspace openconsole

高级配置

自定义命令启动

启动时指定要执行的命令：

bash
docker run -it --rm openconsole [command]

示例：执行ls -l命令

bash
docker run -it --rm openconsole ls -l

环境变量配置

通过-e参数设置环境变量：

bash
docker run -it --rm -e "ENV_NAME=value" openconsole

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  console:
    image: openconsole
    tty: true
    stdin_open: true
    volumes:
      - ./workspace:/workspace
    environment:
      - ENV_NAME=value

启动服务：

bash
docker-compose up -d

进入容器：

bash
docker-compose exec console bash

扩展和自定义

构建自定义镜像

创建自定义Dockerfile：

dockerfile
FROM openconsole
RUN apt-get update && apt-get install -y [需要安装的软件]

构建自定义镜像：

bash
docker build -t my-openconsole .

运行自定义镜像：

bash
docker run -it --rm my-openconsole

注意事项

• 默认以非root用户运行，如需root权限，请使用--user root参数
• 容器内数据默认非持久化，重启后丢失，建议使用挂载卷存储重要数据
• 持久化配置可通过挂载配置文件或构建自定义镜像实现