codesignal/ubuntu-base

基础Docker镜像文档

镜像概述

本镜像基于Ubuntu 20.04构建，是一个集成多种开发、运行时及工具链的基础容器。通过预装Node.js、数据库服务、版本控制工具等核心组件，为多环境开发、测试和部署提供统一的底层支持，简化环境配置流程并提升一致性。

核心功能与特性

预装组件及功能说明

• Node.js：提供JavaScript运行时环境，支持前后端应用开发与运行。
• NVM（Node Version Manager）：灵活管理和切换多版本Node.js，适配不同项目的运行时需求。
• MySQL Server：关系型数据库服务，支持结构化数据存储、事务处理及复杂查询。
• MongoDB：文档型非关系数据库，适用于处理非结构化/半结构化数据及高并发读写场景。
• Git：分布式版本控制系统，支持代码管理、分支协作及版本追踪。
• PostgreSQL：高级关系型数据库，支持JSON数据类型、复杂查询及扩展性插件。
• PowerShell：跨平台命令行工具，提供强大的脚本自动化与系统管理能力。

使用场景与适用范围

• 多语言开发环境：集成Node.js及多种数据库，满足前后端、数据层协同开发需求。
• 数据库应用测试：快速搭建包含MySQL、MongoDB、PostgreSQL的多数据库测试环境，验证应用兼容性。
• CI/CD基础镜像：作为持续集成/部署流水线的底层镜像，减少工具安装步骤，加速构建流程。
• 学习与演示环境：适合开发者学习多技术栈集成，或快速演示依赖多种服务的应用原型。

使用方法与配置说明

基础使用流程

1. 拉取镜像
   从镜像仓库拉取（假设镜像标签为base-ubuntu-dev:latest）：

   bash
   docker pull base-ubuntu-dev:latest
   

2. 启动容器
   根据需求配置端口映射、数据卷及环境变量：

   bash
   docker run -d \
     --name dev-base-container \
     -p 3306:3306 \  # MySQL默认端口
     -p 27017:27017 \  # MongoDB默认端口
     -p 5432:5432 \  # PostgreSQL默认端口
     -v ./project:/workspace \  # 挂载开发目录
     -v mysql-data:/var/lib/mysql \  # MySQL数据持久化
     -v mongodb-data:/data/db \  # MongoDB数据持久化
     -e MYSQL_ROOT_PASSWORD=your_mysql_pw \  # MySQL根密码
     -e POSTGRES_PASSWORD=your_postgres_pw \  # PostgreSQL密码
     -e NODE_VERSION=18.18.0 \  # 指定Node.js版本
     base-ubuntu-dev:latest
   

关键配置参数

• 环境变量

  • MYSQL_ROOT_PASSWORD：必填，设置MySQL root用户密码（未设置时容器启动失败）。
  • POSTGRES_PASSWORD：必填，设置PostgreSQL默认用户（postgres）密码。
  • NODE_VERSION：可选，通过NVM指定Node.js版本（默认安装最新LTS版本）。

• 数据持久化
  建议为数据库服务挂载独立数据卷，避免容器重启导致数据丢失，如示例中的mysql-data、mongodb-data。

部署示例

Docker Compose配置

以下为多服务协同的docker-compose.yml示例：

yaml
version: '3.8'
services:
  base-dev:
    image: base-ubuntu-dev:latest
    container_name: multi-service-dev-env
    ports:
      - "3306:3306"   # MySQL
      - "27017:27017" # MongoDB
      - "5432:5432"   # PostgreSQL
      - "8080:8080"   # 预留应用端口
    volumes:
      - ./code:/workspace  # 开发代码目录
      - mysql-data:/var/lib/mysql
      - mongodb-data:/data/db
      - postgres-data:/var/lib/postgresql/data
    environment:
      - MYSQL_ROOT_PASSWORD=dev_mysql_2024
      - POSTGRES_PASSWORD=dev_postgres_2024
      - NODE_VERSION=20.10.0
    restart: unless-stopped

volumes:
  mysql-data:
  mongodb-data:
  postgres-data:

启动命令：

bash
docker-compose up -d

服务验证

容器启动后，可通过以下命令验证组件状态：

bash
# 检查Node版本
docker exec -it multi-service-dev-env node -v

# 验证MySQL连接
docker exec -it multi-service-dev-env mysql -u root -p

# 验证MongoDB版本
docker exec -it multi-service-dev-env mongosh --eval "db.version()"