kubeshop/testkube-sandbox

沙箱镜像Docker仓库

镜像概述

该Docker仓库主要用于存储各类沙箱环境镜像，作为开发、测试阶段的镜像资源库。沙箱镜像通常用于隔离的开发测试环境，避免影响生产系统，支持API服务、UI应用、OSS（对象存储服务）等多种组件类型的镜像存储与管理。

核心功能与特性

多类型镜像支持

• 兼容API服务镜像：可存储用于后端接口测试的API服务沙箱镜像
• 支持UI应用镜像：包含前端界面组件的沙箱镜像，适用于界面功能验证
• 集成OSS组件镜像：提供对象存储服务的沙箱版本，用于数据存储测试场景

沙箱环境适配

• 镜像配置针对开发测试场景优化，资源占用低，启动速度快
• 支持隔离运行模式，与生产环境完全隔离，避免测试数据污染生产系统
• 内置基础测试工具集成，便于快速验证功能

镜像管理能力

• 提供基础镜像版本控制功能，支持多版本镜像存储与切换
• 支持镜像元数据管理，包含镜像类型、适用场景、依赖关系等描述信息
• 兼容标准Docker镜像格式，可直接与Docker CLI、Docker Compose等工具集成

使用场景与适用范围

开发团队测试环境

• 开发人员本地功能验证：拉取沙箱镜像搭建本地测试环境，验证代码变更
• 跨团队协作测试：统一沙箱镜像版本，确保团队成员使用一致的测试环境

多组件应用沙箱部署

• 微服务架构测试：同时部署API、UI、OSS等多组件沙箱镜像，验证服务间交互
• 集成测试环境搭建：快速构建包含完整依赖的临时测试集群

临时功能验证

• 新功能原型验证：基于沙箱镜像部署临时环境，验证新功能可行性
• 问题复现与修复：使用特定版本沙箱镜像复现线上问题，测试修复方案

使用方法与配置说明

前提条件

• 已安装Docker Engine（建议版本20.10及以上）
• 已获取仓库访问权限（如为私有仓库，需配置认证信息）
• 网络环境可访问目标Docker仓库地址

基础操作示例

登录仓库（如需要认证）

bash
docker login [仓库地址]
# 示例：登录私有沙箱仓库
docker login sandbox-registry.example.com

拉取沙箱镜像

bash
# 基本语法
docker pull [仓库地址]/[镜像类型]/[镜像名称]:[版本标签]

# 示例1：拉取API服务沙箱镜像
docker pull sandbox-registry.example.com/api/user-service:v1.2.0

# 示例2：拉取UI应用沙箱镜像
docker pull sandbox-registry.example.com/ui/admin-panel:latest

上传自定义沙箱镜像

1. 为本地镜像打标签

bash
docker tag local-sandbox-image:test sandbox-registry.example.com/oss/storage-service:v0.1

2. 上传镜像至仓库

bash
docker push sandbox-registry.example.com/oss/storage-service:v0.1

典型部署配置（Docker Compose）

以下为使用沙箱镜像部署多组件测试环境的示例配置：

yaml
version: '3.8'
services:
  api-service:
    image: sandbox-registry.example.com/api/order-service:v2.1.0
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=sandbox
      - DB_HOST=mock-db
    depends_on:
      - mock-db

  ui-application:
    image: sandbox-registry.example.com/ui/order-portal:v1.5.2
    ports:
      - "80:80"
    environment:
      - API_BASE_URL=http://api-service:8080

  oss-service:
    image: sandbox-registry.example.com/oss/test-storage:v3.0
    ports:
      - "9000:9000"
    volumes:
      - ./sandbox-data:/data
    environment:
      - MINIO_ROOT_USER=testuser
      - MINIO_ROOT_PASSWORD=testpass

  mock-db:
    image: sandbox-registry.example.com/database/mock-mysql:latest
    ports:
      - "3306:3306"

配置参数说明

注意事项

• 沙箱镜像仅用于开发测试环境，禁止直接部署至生产系统
• 定期清理不再使用的沙箱镜像版本，避免仓库存储空间占用过大
• 敏感信息（如测试环境密钥）建议通过环境变量注入，而非固化在镜像中