LIGADIGITAL Docker镜像文档

镜像概述和主要用途

LIGADIGITAL Docker镜像集合是由LIGADIGITAL维护的一系列标准化Docker镜像，涵盖多种主流技术栈及版本，旨在为开发、测试和生产环境提供一致性的运行时环境。该集合包含代码检查、数据库迁移、编程语言运行时、数据库服务及开发工具链等多种类型镜像，满足不同场景下的技术需求。

核心功能和特性

涵盖技术栈及版本

• Ansible Lint：ansible-lint:latest，用于Ansible Playbook代码规范性检查，支持自动化代码质量管控。
• Liquibase：提供liquibase:postgres-9.6（适配PostgreSQL 9.6的数据库迁移工具）和liquibase:liquibase-4.20（Liquibase 4.20版本），支持数据库版本管理与迁移。
• Node.js：包含node:6、node:8，提供Node.js运行时环境，支持JavaScript应用开发与运行。
• PHP：提供多版本及场景化配置，包括基础CLI环境（php:5.6-cli）、专用场景配置（php:7.1-catwalk）、物流系统Apache服务环境（php:7.3-logistics-apache、php:8.2-logistics-apache、php:8.4-logistics-apache）及流水线环境（php:7.3-logistics-pipeline、php:8.2-logistics-pipeline、php:8.4-logistics-pipeline）。
• PostgreSQL：postgres:9.6，提供PostgreSQL 9.6数据库服务，适用于依赖该版本数据库的应用。
• Scala-SBT：包含scala-sbt:scala-2.12-none-root和scala-sbt:scala-2.12-pure-non-root，提供基于Scala 2.12的非root用户开发环境，集成SBT构建工具。

核心特性

• 版本多样性：各技术栈提供多个版本标签，适配不同项目的版本依赖需求。
• 场景化配置：PHP镜像针对Apache服务、CI/CD流水线等场景提供专用配置，减少环境配置复杂度。
• 标准化构建：所有镜像基于***或稳定基础镜像构建，确保安全性与可靠性。

使用场景和适用范围

开发环境

为开发团队提供一致的本地开发环境，避免"本地可运行，部署后异常"的环境差异问题。

CI/CD流水线集成

作为CI/CD流程中的执行环境，支持代码检查（ansible-lint）、数据库迁移（liquibase）、应用构建（scala-sbt、php）等自动化步骤。

测试环境部署

快速搭建包含特定版本依赖的测试环境，如PostgreSQL 9.6数据库、PHP 7.3 Apache服务等，确保测试环境与目标生产环境一致。

生产环境运行时

提供标准化的生产级运行时环境（如php:8.2-logistics-apache），降低环境配置差异导致的生产故障风险。

使用方法和配置说明

通用使用步骤

1. 拉取镜像

通过Docker命令拉取所需镜像：

bash
docker pull ligadigital/[镜像名称]:[标签]
# 示例：拉取ansible-lint最新版
docker pull ligadigital/ansible-lint:latest

2. 运行容器

根据镜像用途执行相应命令，以下为部分镜像示例：

• ansible-lint代码检查：

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

  （挂载当前目录至容器/workspace，对playbook.yml执行检查）

• PostgreSQL数据库启动：

  bash
  docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword ligadigital/postgres:9.6
  

  （后台运行PostgreSQL 9.6，映射端口5432，设置数据库密码）

详细配置参考

部分镜像提供专用文档，可通过以下方式获取：

• ansible-lint:latest：参考Docker Hub文档或镜像内置README
• postgres:9.6：参考镜像关联的README文档

注意事项

• 特定场景镜像（如php:*logistics-apache）可能包含项目专用配置，使用前建议参考项目内部文档确认环境变量、挂载路径等要求。
• 非root用户镜像（如scala-sbt:scala-2.12-pure-non-root）需注意容器内文件权限，避免因权限不足导致操作失败。