LIGADIGITAL Docker镜像集合

概述

LIGADIGITAL Docker镜像集合是一套用于开发、测试和生产环境的标准化容器镜像，包含多种工具链、运行时和服务环境。该集合旨在简化开发流程、确保环境一致性，并支持自动化部署和持续集成/持续部署(CI/CD)流水线。

核心功能和特性

包含的镜像类型

• 自动化与代码质量工具
  ansible-lint:latest：Ansible剧本静态分析工具，用于检查语法错误、最佳实践合规性，提升Ansible代码质量。

• 数据库迁移工具
  liquibase:postgres-9.6 和 liquibase:liquibase-4.20：数据库版本控制与迁移工具，支持PostgreSQL等数据库的模式变更管理，确保数据库结构变更可追溯、可回滚。

• JavaScript运行时
  node:6、node:8：Node.js运行时环境，提供JavaScript服务端执行能力，适用于运行基于Node.js的应用或构建流程。

• PHP环境
  多版本、多配置PHP镜像，覆盖从5.6到8.4的版本，满足不同项目兼容性需求：

  • php:5.6-cli：PHP 5.6命令行版本，适用于脚本执行
  • php:7.1-catwalk：PHP 7.1版本，包含特定业务模块（catwalk）
  • php:7.3/8.2/8.4-logistics-apache：针对logistics项目优化的Apache+PHP环境，用于Web应用部署
  • php:7.3/8.2/8.4-logistics-pipeline：logistics项目CI/CD流水线专用版本，集成构建工具

• 数据库服务
  postgres:9.6：PostgreSQL 9.6数据库服务器，提供关系型数据库服务，支持数据持久化和事务处理。

• Scala开发环境
  scala-sbt:scala-2.12-none-root、scala-sbt:scala-2.12-pure-non-root：Scala 2.12开发环境，集成sbt构建工具，默认以非root用户运行，增强容器安全性。

使用场景和适用范围

• 本地开发：快速搭建与团队一致的开发环境，避免"在我电脑上能运行"问题
• 自动化测试：在CI/CD流水线中提供标准化依赖环境，执行单元测试、集成测试
• 代码质量检查：通过ansible-lint在提交或构建阶段自动检查Ansible代码
• 数据库管理：使用liquibase执行数据库迁移脚本，确保开发/测试/生产环境数据库结构一致
• 应用部署：通过php:*logistics-apache等镜像部署Web应用，或使用postgres提供数据库服务

使用方法和配置说明

基础使用流程

1. 拉取镜像
   从Docker Hub或私有仓库拉取指定镜像：

   bash
   # 拉取ansible-lint
   docker pull ligadigital/ansible-lint:latest
   
   # 拉取PostgreSQL 9.6
   docker pull ligadigital/postgres:9.6
   

2. 运行容器
   根据镜像类型执行对应命令，以下为典型场景示例：

   ansible-lint检查Ansible剧本

   bash
   # 挂载当前目录的Ansible剧本到容器，执行lint检查
   docker run --rm -v $(pwd):/workspace ligadigital/ansible-lint:latest \
     ansible-lint /workspace/playbooks/
   

   启动PostgreSQL数据库

   bash
   # 启动PostgreSQL 9.6，映射端口5432，持久化数据到本地目录
   docker run -d \
     -p 5432:5432 \
     -v postgres_data:/var/lib/postgresql/data \
     -e POSTGRES_PASSWORD=mysecretpassword \
     -e POSTGRES_DB=appdb \
     --name postgres-9.6 \
     ligadigital/postgres:9.6
   

   部署PHP Web应用（logistics项目）

   bash
   # 运行PHP 8.2 + Apache环境，挂载应用代码到Web根目录
   docker run -d \
     -p 80:80 \
     -v $(pwd)/app:/var/www/html \
     --name logistics-web \
     ligadigital/php:8.2-logistics-apache
   

   在CI流水线中使用PHP构建环境

   bash
   # 在GitLab CI中执行PHP构建命令
   docker run --rm -v $(pwd):/app ligadigital/php:8.4-logistics-pipeline \
     bash -c "composer install && phpunit"
   

配置参数说明

• 环境变量
  postgres:9.6 支持标准PostgreSQL环境变量：

  • POSTGRES_PASSWORD：数据库管理员密码（必填）
  • POSTGRES_USER：默认管理员用户名（默认postgres）
  • POSTGRES_DB：初始数据库名称

• 挂载目录

  • 代码/配置文件：通过-v挂载本地目录到容器内应用路径（如PHP的/var/www/html）
  • 数据持久化：PostgreSQL数据目录/var/lib/postgresql/data建议挂载到宿主机或数据卷，避免容器删除导致数据丢失

注意事项

• 部分镜像提供详细配置文档（如postgres:9.6的README），复杂场景建议参考原始文档
• PHP镜像版本需与项目兼容性匹配（如旧项目使用5.6，新项目推荐8.2+）
• scala-sbt镜像默认非root用户运行，挂载目录时需确保宿主机目录权限允许容器用户访问
• 生产环境使用时，建议结合Docker Compose或Kubernetes进行编排，配置资源限制、健康检查等