ligadigital/ansible

LIGADIGITAL Docker镜像文档

镜像概述和主要用途

LIGADIGITAL Docker镜像集合是由LIGADIGITAL维护的一系列标准化Docker镜像，涵盖多种开发工具、运行环境及数据库服务。该集合旨在为开发、测试和部署流程提供一致的环境支持，减少因环境差异导致的问题，提升开发效率和流程标准化水平。

核心功能和特性

1. 工具类镜像

• ansible-lint:latest

  • 基于Ansible-lint工具，用于对Ansible剧本进行语法检查和最佳实践验证，确保剧本质量。
  • 提供Docker Hub地址：https://hub.docker.com/repository/docker/ligadigital/ansible-lint%EF%BC%8C%E5%90%AB%E8%AF%A6%E7%BB%86%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E%E3%80%82

• liquibase

  • 包含liquibase:postgres-9.6和liquibase:liquibase-4.20等标签，提供数据库版本管理功能，支持数据库变更的追踪、版本控制和自动化部署。

2. 运行环境镜像

• node

  • 提供Node.js运行环境，标签对应具体版本：node:6、node:8，适用于Node.js应用的开发和运行。

• php

  • 包含多种变体，支持不同PHP版本及用途：
    • php:5.6-cli：PHP 5.6命令行环境
    • php:7.1-catwalk：PHP 7.1定制版本
    • php:7.3-logistics-apache/php:7.3-logistics-pipeline：PHP 7.3版本，分别适用于Apache服务部署和CI/CD流水线
    • php:8.2-logistics-apache/php:8.2-logistics-pipeline：PHP 8.2版本，对应Apache服务和流水线场景
    • php:8.4-logistics-apache/php:8.4-logistics-pipeline：PHP 8.4版本，适用于Apache服务及流水线

• scala-sbt

  • 提供Scala和sbt构建环境，标签如scala-sbt:scala-2.12-none-root、scala-sbt:scala-2.12-pure-non-root，支持非root用户运行，增强安全性。

3. 数据库镜像

• postgres:9.6
  • 提供PostgreSQL 9.6数据库环境，适用于依赖该版本数据库的应用开发和测试。
  • 包含详细说明文档（README），可参考镜像路径下的README.md获取配置细节。

使用场景和适用范围

• 开发环境标准化：为团队提供统一的开发工具和运行环境，避免"本地能跑，线上报错"问题。
• CI/CD流程集成：在自动化构建、测试和部署流程中（如Jenkins、GitLab CI），作为执行环境运行代码检查（ansible-lint）、构建（scala-sbt、node、php）、数据库迁移（liquibase）等任务。
• 数据库版本管理：通过liquibase镜像实现数据库 schema 变更的版本控制和自动化部署。
• 应用测试环境：使用postgres:9.6等数据库镜像快速搭建测试数据库，或通过php/apache镜像部署应用进行功能测试。

使用方法和配置说明

通用使用方式

大部分镜像可通过docker run命令直接使用，或集成到docker-compose配置中。以下为部分典型镜像的使用示例：

1. ansible-lint:latest

用于检查Ansible剧本语法和规范：

bash
# 挂载本地Ansible剧本目录，执行lint检查
docker run --rm -v $(pwd):/app ligadigital/ansible-lint:latest ansible-lint /app/your-playbook.yml

2. postgres:9.6

启动PostgreSQL 9.6数据库服务：

bash
# 启动容器并设置初始密码
docker run -d \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_DB=your_db \
  -p 5432:5432 \
  --name postgres-9.6 \
  ligadigital/postgres:9.6

详细配置可参考镜像的README文档（postgres/9.6/README.md）。

3. php:8.2-logistics-apache

启动PHP 8.2 Apache服务：

bash
# 挂载本地PHP应用代码到容器web根目录
docker run -d \
  -v $(pwd):/var/www/html \
  -p 80:80 \
  --name php-apache \
  ligadigital/php:8.2-logistics-apache

4. liquibase:liquibase-4.20

执行数据库迁移（需挂载changelog文件及数据库配置）：

bash
docker run --rm \
  -v $(pwd)/changelog:/liquibase/changelog \
  ligadigital/liquibase:liquibase-4.20 \
  --url="jdbc:postgresql://db-host:5432/your_db" \
  --username=your_user \
  --password=your_password \
  update

注意事项

• 部分镜像（如php变体、scala-sbt）可能包含定制化配置，建议参考对应Dockerfile（路径如php/8.2-logistics-apache/Dockerfile）了解具体环境依赖和配置细节。
• 涉及数据持久化的场景（如postgres），建议通过-v挂载本地目录或使用Docker卷（volume）保存数据，避免容器删除后数据丢失。
• 生产环境使用时，需根据实际需求调整资源限制（如--memory、--cpus）及网络配置，确保安全性和稳定性。