rosti/runtime

admin-app-runtime 镜像文档

镜像概述和主要用途

admin-app-runtime 是专为生产环境设计的管理应用运行时镜像，提供稳定、安全且高效的执行环境，用于部署和运行企业级管理应用（如后台管理系统、运维平台、配置中心等）。该镜像封装了应用运行所需的基础依赖、运行时环境及优化配置，确保管理应用在生产环境中具备高可用性和可维护性。

核心功能和特性

1. 稳定的运行时环境

• 内置应用依赖的基础运行时（如特定版本的 JRE/Node.js/Python 等，根据应用类型适配），确保依赖版本一致性，避免环境差异导致的运行异常。
• 基于官方稳定基础镜像（如 debian:slim/alpine）构建，经过兼容性测试，支持主流 Linux 内核版本。

2. 安全加固

• 采用非 root 用户运行应用，限制容器权限，降低安全风险。
• 集成基础安全补丁，定期更新底层依赖以修复已知漏洞。
• 支持容器镜像签名验证，确保镜像完整性。

3. 资源与性能优化

• 内置资源限制适配逻辑，支持通过环境变量或 Docker 配置限制 CPU/内存使用，避免资源滥用。
• 优化进程启动参数，减少冷启动时间，提升应用响应速度。

4. 可观测性支持

• 标准输出日志集成，支持与 ELK、Prometheus 等监控系统对接。
• 内置健康检查接口（/health），支持 Docker 原生健康检查机制，便于容器编排平台（如 Kubernetes）进行实例自愈。

5. 灵活配置能力

• 支持通过环境变量、配置文件挂载等方式注入应用配置，适配不同部署场景。
• 兼容主流容器编排工具（Docker Compose、Kubernetes），支持集群化部署。

使用场景和适用范围

使用场景

• 生产环境管理应用部署：作为管理应用的基础运行容器，承载日常业务逻辑执行。
• 后台管理系统运行：支持企业内部管理平台（如用户管理、权限控制、数据监控等模块）的稳定运行。
• 运维自动化支持：为运维工具（如配置推送、日志查询、服务启停等功能）提供运行环境。
• 多实例集群部署：配合负载均衡组件（如 Nginx、Traefik），实现管理应用的高可用集群部署。

适用范围

• 企业级后台管理系统、内部运维平台。
• 需要稳定运行环境的生产级管理应用。
• 对安全性、可观测性有较高要求的管理工具。

使用方法和配置说明

拉取镜像

通过 Docker Hub 或私有仓库拉取镜像（以下以 Docker Hub 为例）：

bash
docker pull docker.xuanyuan.run/[仓库地址]/admin-app-runtime:[版本标签]
# 示例：拉取 1.0.0 版本
docker pull example.com/admin-app-runtime:1.0.0

基本运行命令

最简启动

bash
docker run -d --name admin-app \
  -p 8080:8080 \
  docker.xuanyuan.run/[仓库地址]/admin-app-runtime:1.0.0

带环境变量与数据卷的启动

bash
docker run -d --name admin-app \
  -p 8080:8080 \
  -e "PORT=8080" \
  -e "LOG_LEVEL=info" \
  -e "DB_HOST=mysql-service" \
  -e "DB_PORT=3306" \
  -v /host/path/logs:/app/logs \  # 挂载日志目录
  -v /host/path/config:/app/config \  # 挂载配置文件
  --network=backend-network \  # 连接到后端服务网络
  --restart=always \  # 配置容器自动重启
  [仓库地址]/admin-app-runtime:1.0.0

Docker Compose 配置

创建 docker-compose.yml 文件，定义多容器部署（如包含应用和数据库）：

yaml
version: '3.8'
services:
  admin-app:
    image: docker.xuanyuan.run/[仓库地址]/admin-app-runtime:1.0.0
    container_name: admin-app
    restart: always
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - LOG_LEVEL=info
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=admin
      - DB_PASSWORD=secret
    volumes:
      - ./logs:/app/logs
      - ./config:/app/config
    networks:
      - admin-network
    depends_on:
      - mysql

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    container_name: admin-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=admin_db
      - MYSQL_USER=admin
      - MYSQL_PASSWORD=secret
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - admin-network

networks:
  admin-network:
    driver: bridge

volumes:
  mysql-data:

启动服务：

bash
docker-compose up -d

环境变量说明

数据卷与配置挂载

• 日志目录：建议挂载 /app/logs 到宿主机目录，避免容器重启导致日志丢失。
• 配置文件：通过挂载 /app/config 目录，可注入自定义配置文件（如 app.properties、config.yaml），优先级高于环境变量配置。
• 持久化数据：若应用需本地存储数据（如缓存、临时文件），可挂载 /app/data 目录。

注意事项

1. 版本选择：生产环境建议使用固定版本标签（如 1.0.0），避免使用 latest 标签导致版本不可控。
2. 资源限制：通过 --memory、--cpus 参数限制容器资源使用，避免影响宿主机其他服务。

   bash
   docker run -d --name admin-app --memory=2g --cpus=1 ...
   

3. 安全配置：禁用 --privileged 权限，避免挂载敏感宿主机目录（如 /etc、/proc）。
4. 健康检查：在容器编排平台中配置健康检查策略（如 Kubernetes 的 livenessProbe/readinessProbe），确保实例异常时自动重启或隔离。
5. 镜像更新：定期更新镜像以获取安全补丁和功能优化，更新前建议在测试环境验证兼容性。