docker/cruise-user-shell Docker Image

Docker EE托管演示管理shell镜像文档

1. 镜像概述和主要用途

本镜像为Docker EE（Docker Enterprise Edition）托管演示环境设计，核心功能是暴露一个管理shell，供用户通过交互式命令行界面对Docker EE演示环境进行配置、监控和管理操作。

2. 核心功能和特性

• 交互式管理shell：提供bash/sh交互式终端，支持标准Linux命令及Docker EE管理操作
• 预装工具集：内置Docker EE环境管理所需工具（如docker、docker-compose、kubectl等）
• 环境适配：默认配置与Docker EE托管演示环境的网络及权限模型兼容
• 轻量级设计：基于Alpine或Debian Slim基础镜像，镜像体积小，启动速度快

3. 使用场景和适用范围

适用场景

• Docker EE产品演示：快速进入管理界面，实时展示环境配置、容器编排等功能
• 技术培训：指导学员通过命令行操作Docker EE环境，实践容器部署、资源管理等操作
• 演示环境维护：对Docker EE托管演示环境进行日常配置调整、日志查看、故障排查

适用用户

• 系统管理员：管理Docker EE演示环境基础设施
• 开发人员：测试Docker EE环境中的应用部署流程
• 技术讲师：在培训/研讨会中演示Docker EE功能

4. 使用方法和配置说明

4.1 前提条件

• 已安装Docker Engine（版本≥1.13.0）
• 可访问Docker EE托管演示环境（需提前获取环境访问权限及网络连通性）

4.2 获取镜像

假设镜像托管于私有仓库（如docker-ee-demo/admin-shell），通过以下命令拉取：

bash
docker pull docker.xuanyuan.run/docker-ee-demo/admin-shell:latest

4.3 启动容器并进入管理shell

通过docker run命令启动容器，使用-it参数开启交互式终端：

bash
docker run -it \
  --name demo-admin-shell \
  --network demo-network  # 需与Docker EE演示环境网络连通（根据实际环境调整） \
  docker-ee-demo/admin-shell:latest

执行后将直接进入容器内的管理shell，终端提示符类似：

admin@demo-shell:/# 

4.4 环境变量配置

可通过-e参数传递环境变量，自定义shell行为或演示环境连接信息：

示例（指定演示环境URL和管理员用户）：

bash
docker run -it \
  -e DEMO_ENV_URL="https://my-demo-ee.env" \
  -e ADMIN_USER="demo-admin" \
  docker.xuanyuan.run/docker-ee-demo/admin-shell:latest

4.5 常用操作示例

进入shell后，可执行以下典型操作：

查看Docker EE环境信息

bash
docker info  # 查看Docker EE引擎信息
kubectl get nodes  # 若启用Kubernetes，查看节点状态

部署测试容器

bash
docker run -d --name demo-app docker.xuanyuan.run/nginx:alpine # 在演示环境启动Nginx测试容器

查看演示环境日志

bash
docker logs -f demo-app  # 实时查看测试容器日志

4.6 退出shell

在shell中执行exit命令退出交互式终端，容器将自动停止：

bash
admin@demo-shell:/# exit

如需保留容器（下次可通过docker start -ai demo-admin-shell重新进入），启动时可添加--rm=false参数（默认不自动删除容器）。