evicertia/mono-service

mono-docker 镜像文档

镜像概述

mono-docker 是一个基于 Mono 框架的基础 Docker 镜像，旨在为运行基于 Mono 开发的守护进程（daemons）和微服务（micro-services）提供标准化的运行环境。Mono 作为 .NET 框架的开源跨平台实现，使得 .NET 应用程序能够在非 Windows 系统上运行，本镜像则进一步简化了此类应用的容器化部署流程。

核心功能和特性

• 内置 Mono 运行时：包含完整的 Mono 运行时环境，满足基于 .NET 框架开发的应用程序的运行需求。
• 基础依赖集成：预装运行 Mono 应用所需的基础系统依赖，减少上层应用镜像的配置复杂度。
• 轻量级设计：优化镜像体积，适合构建轻量级容器，降低资源占用。
• 标准化基础：提供统一的基础环境，便于团队协作和应用部署的一致性。

使用场景和适用范围

• 开发基于 Mono 的微服务：作为基础镜像构建和运行采用 Mono 开发的微服务架构应用。
• 部署跨平台 .NET 守护进程：支持将 .NET 框架开发的后台服务（如定时任务、数据处理服务）容器化，实现跨平台部署。
• CI/CD 流程集成：在持续集成/持续部署流程中作为基础镜像，简化应用构建和测试环境的配置。

使用方法和配置说明

基础使用方式

作为基础镜像构建应用

在 Dockerfile 中使用 mono-docker 作为基础镜像，添加自定义应用代码：

dockerfile
# 基于 mono-docker 构建应用镜像
FROM mono-docker

# 设置工作目录
WORKDIR /app

# 复制应用程序文件到容器
COPY ./your-app /app

# 运行应用（示例：启动守护进程）
CMD ["mono", "your-daemon.exe"]

直接运行示例

若需快速测试 Mono 运行环境，可通过以下命令启动容器并进入交互模式：

bash
docker run -it --rm mono-docker mono --version

配置说明

• 环境变量：可根据应用需求自定义环境变量，例如设置应用日志级别、配置文件路径等，通过 -e 参数传递：

  bash
  docker run -e "LOG_LEVEL=info" -e "CONFIG_PATH=/app/config" mono-docker
  

• 端口映射：若应用需要对外提供服务，通过 -p 参数映射容器端口到主机：

  bash
  docker run -p 8080:8080 mono-docker mono your-service.exe
  

• 数据持久化：使用 -v 参数挂载主机目录，实现应用数据持久化：

  bash
  docker run -v /host/data:/app/data mono-docker
  

注意事项

• 本镜像为基础镜像，不含具体业务逻辑，需结合实际应用代码构建上层镜像使用。
• 请根据应用所需的 Mono 版本选择对应标签的 mono-docker 镜像（如未指定标签，默认使用最新稳定版）。
• 运行前确保应用程序已针对 Mono 环境进行适配，避免出现兼容性问题。