docker/demo

demo-app-delivery-repo 镜像文档

镜像概述和主要用途

demo-app-delivery-repo 是一个用于存储和展示不同类型应用交付内容的演示性 Docker 镜像。该镜像旨在提供一个轻量级的环境，用于管理、展示各类应用交付资产（如配置文件、部署脚本、容器镜像描述文件等），适用于技术演示、学习和测试场景。

核心功能和特性

核心功能

• 支持多种应用交付内容类型管理，包括但不限于：
  • Docker 相关文件（Dockerfile、.dockerignore）
  • Kubernetes 部署配置（YAML/JSON 清单）
  • Helm Chart 包及配置文件
  • 应用部署脚本（Shell、Python 等）
• 提供基础的内容浏览和访问能力，支持通过 Web 界面或 CLI 工具查看存储的交付内容。

特性

• 轻量级设计：基于 Alpine 或类似基础镜像构建，镜像体积小，启动速度快，适合演示环境。
• 灵活的内容挂载：支持通过容器卷挂载本地目录，自定义存储的应用交付内容。
• 可配置化：通过环境变量自定义服务端口、存储路径、日志级别等参数。
• 演示友好：内置简单的内容索引功能，便于快速展示不同类型交付内容的组织结构。

使用场景和适用范围

典型使用场景

• 技术演示：在会议、培训或产品展示中，快速搭建应用交付内容的展示环境，直观呈现交付资产的组织方式。
• 学习环境：供开发者或运维人员学习不同应用交付内容（如 Kubernetes 配置、Helm Chart）的存储和管理方法。
• 测试环境：临时存储和管理测试阶段的应用交付资产，避免直接修改生产环境配置。

适用范围

• 环境限制：仅适用于开发、演示和测试环境，不建议用于生产环境（缺乏生产级别的安全和高可用机制）。
• 用户群体：开发者、运维工程师、技术培训师及需要展示应用交付流程的相关人员。

详细的使用方法和配置说明

1. 获取镜像

从 Docker Hub 获取（假设镜像已发布）

bash
docker pull demo-app-delivery-repo:latest

本地构建（如需修改镜像内容）

bash
# 克隆仓库（假设存在源码仓库）
git clone https://github.com/example/demo-app-delivery-repo.git
cd demo-app-delivery-repo

# 构建镜像
docker build -t demo-app-delivery-repo:local .

2. 基本运行示例

基础命令（默认配置）

bash
docker run -d \
  --name demo-delivery-repo \
  -p 8080:8080 \
  -v $(pwd)/delivery-content:/app/content \
  demo-app-delivery-repo:latest

• 说明：
  • -p 8080:8080：将容器内 8080 端口映射到主机 8080 端口，用于访问 Web 界面。
  • -v $(pwd)/delivery-content:/app/content：挂载主机当前目录下的 delivery-content 目录到容器内 /app/content（默认内容存储路径），实现内容持久化和自定义。

3. Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  delivery-repo:
    image: demo-app-delivery-repo:latest
    container_name: demo-delivery-repo
    ports:
      - "8080:8080"  # Web 访问端口
    volumes:
      - ./delivery-content:/app/content  # 挂载本地内容目录
      - ./logs:/app/logs  # 挂载日志目录（可选）
    environment:
      - CONTENT_DIR=/app/content  # 内容存储目录（容器内路径）
      - PORT=8080  # 服务监听端口
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    restart: unless-stopped  # 容器退出时自动重启（演示环境可选）

启动服务：

bash
docker-compose up -d

4. 环境变量说明

5. 数据持久化

为避免容器重启后内容丢失，需通过卷挂载持久化存储应用交付内容：

bash
# 方法1：挂载主机目录（推荐，便于直接操作内容）
docker run -d \
  -v /path/on/host/delivery-content:/app/content \
  demo-app-delivery-repo:latest

# 方法2：使用 Docker 命名卷（适合不需要直接操作主机文件的场景）
docker volume create delivery-content-vol
docker run -d \
  -v delivery-content-vol:/app/content \
  demo-app-delivery-repo:latest

6. 访问和使用

服务启动后，通过以下方式访问内容：

• Web 界面：访问 http://<主机IP>:8080，通过页面浏览和管理交付内容（需 AUTO_INDEX=true）。
• CLI 访问：进入容器内部查看内容：

  bash
  docker exec -it demo-delivery-repo ls /app/content  # 列出内容
  docker exec -it demo-delivery-repo cat /app/content/example.yaml  # 查看文件
  

注意事项

• 该镜像为演示用途，未包含身份认证、数据加密等安全机制，请勿在生产环境使用。
• 挂载本地目录时，确保主机目录有适当权限（容器内用户通常为非 root，建议设置目录权限为 755）。
• 如需自定义内容类型支持，可通过修改镜像源码（如添加解析脚本）并重新构建实现。