yurimatoslima/phoenix-backend

后端集成环境Docker镜像文档

镜像概述和主要用途

本Docker镜像旨在提供一个集成后端开发、测试及运行所需各类工具与环境的统一工作平台。通过整合后端开发常用组件，简化开发流程，确保团队开发环境一致性，适用于后端应用从开发阶段到部署环节的全生命周期管理。

核心功能和特性

1. 多环境支持

• 兼容开发、测试、生产等多种环境需求，可通过配置快速切换环境模式。
• 内置环境隔离机制，避免不同项目间的依赖冲突。

2. 常用工具集成

• 包含数据库客户端（如MySQL、PostgreSQL客户端）、API测试工具（如curl、httpie）、日志分析工具（如tail、grep增强版）等后端开发必备工具。
• 集成版本控制工具（Git）及构建工具（Maven、Gradle），支持后端项目的源码管理与构建。

3. 轻量级与可扩展性

• 基于精简基础镜像构建，减少冗余依赖，降低镜像体积。
• 支持通过自定义配置文件或环境变量扩展功能，满足个性化需求。

4. 易用性设计

• 提供默认配置模板，开箱即用，减少初始配置成本。
• 内置帮助文档与工具使用说明，便于快速上手。

使用场景和适用范围

适用场景

• 后端开发：作为本地开发环境，统一团队开发工具版本，避免"本地可运行，部署即报错"问题。
• 测试验证：在CI/CD流程中作为测试环境，运行单元测试、接口测试等验证环节。
• 快速部署：作为小型后端服务的运行容器，简化部署流程。

适用范围

• 后端开发人员、测试工程师及DevOps工程师。
• 基于Java、Python、Node.js等主流后端语言开发的应用。
• 需要统一开发环境的中小型开发团队。

使用方法和配置说明

基本使用（docker run）

bash
# 拉取镜像（假设镜像名称为backend-env:latest）
docker pull backend-env:latest

# 启动交互式容器，挂载本地项目目录
docker run -it --name backend-workspace \
  -v /本地项目路径:/app \
  -e BACKEND_ENV=development \
  backend-env:latest /bin/bash

docker-compose配置示例

yaml
version: '3'
services:
  backend-env:
    image: backend-env:latest
    container_name: backend-workspace
    volumes:
      - ./local-project:/app  # 挂载本地项目目录
      - ./custom-config:/etc/backend-config  # 挂载自定义配置文件
    environment:
      - BACKEND_ENV=development  # 指定环境模式（development/test/production）
      - LOG_LEVEL=info  # 设置日志级别
    ports:
      - "8080:8080"  # 映射应用端口（如需运行Web服务）

关键配置说明

环境变量

卷挂载

• /app：默认项目工作目录，建议挂载本地项目代码到该路径，实现代码实时同步。
• /etc/backend-config：配置文件目录，可挂载自定义配置文件覆盖默认配置。

自定义配置

1. 在本地创建配置文件目录（如./custom-config），添加自定义配置文件（如tools.conf）。
2. 通过卷挂载将该目录映射到容器内/etc/backend-config路径，容器启动时会自动加载自定义配置。

常用命令（容器内）

• backend-help：查看镜像内置工具列表及使用说明。
• env-check：检查当前环境配置是否正常。
• tool-update：更新内置工具至最新版本。