LIGADIGITAL Docker镜像文档

简介

本文档提供LIGADIGITAL维护的Docker镜像集合说明，涵盖基础工具、编程语言环境、数据库等多种类型，适用于开发、测试及CI/CD流水线场景。部分镜像提供官方README或Docker Hub链接，建议结合对应文档获取详细配置信息。

1. 基础工具类镜像

1.1 ansible-lint:latest

概述

基于Ansible Lint工具的镜像，用于Ansible项目的代码质量检查与静态分析。

核心功能

• 支持Ansible剧本（playbook）、角色（role）的语法校验
• 提供代码风格检查、最佳实践建议
• 集成Ansible核心依赖，无需额外安装环境

使用场景

• Ansible项目开发阶段的本地代码检查
• CI/CD流水线中自动化剧本质量管控

使用方法

Docker Run示例：

docker run --rm -v $(pwd):/workspace ligadigital/ansible-lint:latest ansible-lint /workspace/playbook.yml

说明：

• 挂载本地Ansible项目目录至容器/workspace
• 通过命令行参数指定需要检查的剧本文件路径
• 详细配置可参考官方README及Docker Hub

1.2 liquibase:postgres-9.6

概述

集成Liquibase数据库版本管理工具与PostgreSQL 9.6驱动的镜像，用于PostgreSQL数据库 schema 迁移。

核心功能

• 支持PostgreSQL 9.6数据库的变更集（changeset）管理
• 提供数据库版本追踪、回滚及迁移自动化能力
• 内置PostgreSQL JDBC驱动，无需额外配置驱动依赖

使用场景

• 基于PostgreSQL 9.6的项目开发/测试环境数据库迁移
• 生产环境PostgreSQL schema变更的自动化执行

使用方法

Docker Run示例（执行迁移）：

docker run --rm \
  -v $(pwd)/changelog:/changelog \
  ligadigital/liquibase:postgres-9.6 \
  --url=jdbc:postgresql://db-host:5432/dbname \
  --username=dbuser \
  --password=dbpass \
  update

说明：

• 挂载本地变更集目录至容器/changelog（存放changelog.xml等文件）
• 通过--url、--username、--password指定数据库连接信息
• 支持update/rollback/status等Liquibase核心命令

1.3 liquibase:liquibase-4.20

概述

基于Liquibase 4.20版本的通用数据库版本管理工具镜像，支持多数据库类型的schema迁移。

核心功能

• 兼容Liquibase 4.20特性，如增强的变更集校验、并行迁移支持
• 支持多种数据库（需自行挂载对应JDBC驱动）
• 提供命令行与配置文件两种迁移方式

使用场景

• 多数据库环境（如MySQL、Oracle等）的schema版本管理
• 需要使用Liquibase 4.20新特性的迁移任务

2. 编程语言环境类镜像

2.1 node:6 / node:8

概述

基于Node.js 6.x/8.x版本的运行时环境镜像，用于兼容旧版Node.js项目的开发与运行。

核心功能

• 提供Node.js 6.x/8.x运行时及npm包管理工具
• 支持JavaScript/TypeScript项目的依赖安装与执行
• 轻量级基础镜像，适合作为构建或运行阶段基础层

使用场景

• 依赖旧版Node.js API的遗留项目开发
• 旧版npm包兼容性测试环境

使用方法

Docker Run示例（安装依赖并执行脚本）：

# Node.js 8示例
docker run --rm -v $(pwd):/app -w /app ligadigital/node:8 \
  sh -c "npm install && node index.js"

2.2 PHP环境镜像

2.2.1 php:5.6-cli

概述

基于PHP 5.6命令行（CLI）版本的运行环境，无Web服务器，适用于脚本执行。

核心功能

• PHP 5.6运行时及核心扩展（如json、mbstring等）
• 支持CLI模式下的PHP脚本执行、依赖管理（Composer）

使用场景

• 旧版PHP脚本（如定时任务、数据处理脚本）的运行
• 依赖PHP 5.6的遗留项目构建流程

2.2.2 php:7.1-catwalk

概述

基于PHP 7.1的定制化环境镜像，名称“catwalk”可能对应特定项目（如内部“Catwalk”系统）的运行依赖。

核心功能

• PHP 7.1运行时，含项目特定扩展及配置
• 可能集成内部工具链或依赖库，适配“Catwalk”项目需求

使用场景

• LIGADIGITAL内部“Catwalk”项目的开发与部署

2.2.3 php:7.3-logistics-apache / php:7.3-logistics-pipeline

概述

针对“logistics”（物流）类项目的PHP 7.3环境镜像，分两种变体：

• logistics-apache：集成Apache Web服务器，用于Web应用部署
• logistics-pipeline：优化CI/CD流水线使用，含构建工具（如Composer、PHPUnit）

核心功能

• PHP 7.3运行时及物流项目所需扩展（如pdo_mysql、redis等）
• Apache变体支持虚拟主机配置、.htaccess解析；流水线变体支持代码构建、测试自动化

使用场景

• 物流类Web项目的开发/生产环境部署（logistics-apache）
• 物流项目CI/CD流水线中的代码构建、单元测试（logistics-pipeline）

2.2.4 php:8.2-logistics-apache / php:8.2-logistics-pipeline

2.2.5 php:8.4-logistics-apache / php:8.4-logistics-pipeline

（结构同2.2.3，版本分别为PHP 8.2/8.4，针对物流项目的Web部署与流水线构建，支持PHP 8.x新特性及性能优化，适用于升级至PHP 8.x的物流项目。）

2.3 scala-sbt镜像

2.3.1 scala-sbt:scala-2.12-none-root

2.3.2 scala-sbt:scala-2.12-pure-non-root

概述

基于Scala 2.12及sbt构建工具的环境镜像，以非root用户运行，提供Scala项目构建能力。标签“pure”可能表示精简版（移除非必要依赖）。

核心功能

• Scala 2.12运行时及sbt构建工具
• 非root用户运行，增强容器安全性
• “pure”变体可能移除调试工具或文档，减小镜像体积

使用场景

• Scala 2.12项目的本地构建与测试
• CI/CD流水线中Scala代码的编译、打包

3. 数据库类镜像

3.1 postgres:9.6

概述

基于PostgreSQL 9.6的数据库服务镜像，用于提供PostgreSQL 9.6兼容的数据库环境。

核心功能

• 完整PostgreSQL 9.6数据库服务，支持标准SQL及事务
• 支持数据持久化存储、用户权限管理、备份恢复
• 兼容PostgreSQL 9.6原生配置参数

使用场景

• 依赖PostgreSQL 9.6的旧版项目开发/测试环境
• 需要低版本PostgreSQL兼容的集成测试

使用方法

Docker Run示例：

docker run -d \
  --name postgres-9.6 \
  -e POSTGRES_USER=dbuser \
  -e POSTGRES_PASSWORD=dbpass \
  -e POSTGRES_DB=logistics_db \
  -v postgres-data:/var/lib/postgresql/data \
  ligadigital/postgres:9.6

环境变量说明：

• POSTGRES_USER：默认数据库用户（必填）
• POSTGRES_PASSWORD：用户密码（必填）
• POSTGRES_DB：初始化数据库名称（可选，默认与用户名相同）

数据持久化：

• 挂载卷至/var/lib/postgresql/data（PostgreSQL数据存储目录）
• 详细配置可参考官方README

说明

本文档基于镜像名称及常规Docker镜像特性整理，具体功能、配置及扩展可能因Dockerfile定制有所差异。建议通过对应镜像的Dockerfile路径或官方README获取完整信息。