digitalpulp/cli

Drush and Composer Docker镜像文档

镜像概述

该Docker镜像（digitalpulp/cli）是专为Drupal项目设计的命令行服务镜像，集成了Drush和Composer工具。支持多种PHP版本标签，旨在简化Drupal项目的依赖管理和日常命令行操作，提供便捷的开发和维护环境。

核心功能与特性

• 工具集成：内置Drush和Composer，满足Drupal项目的依赖管理及命令行操作需求
• PHP版本支持：提供多个PHP版本标签，包括7.3.27、7.4.16及codeship-7.3、codeship-7.4等特定环境版本
• 路径配置：将项目挂载目录/var/www/vendor/bin添加至环境变量PATH，可直接执行Drush和Drupal Console命令
• 项目挂载：默认期望Drupal项目挂载于/var/www目录，符合常规Drupal项目结构

使用场景

适用于Drupal项目的开发、测试和维护阶段，主要应用场景包括：

• 使用Composer管理Drupal核心及模块的依赖关系
• 执行Drush命令进行站点管理（如数据库导入/导出、模块启用/禁用、缓存清除等）
• 在CI/CD环境（如Codeship）中集成Drupal项目的自动化命令行操作

使用方法与配置说明

基本运行方式

容器要求将Drupal项目目录挂载至/var/www。基本运行命令格式：

bash
docker run -v /本地/drupal项目路径:/var/www digitalpulp/cli:[标签] [命令]

标签选择

根据项目PHP版本需求选择合适的镜像标签，主要可用标签包括：

• 7.3.27：PHP 7.3.27版本
• 7.4.16：PHP 7.4.16版本
• codeship-7.3：适用于Codeship CI环境的PHP 7.3版本
• codeship-7.4：适用于Codeship CI环境的PHP 7.4版本

常用命令示例

1. 查看Drush状态

bash
docker run -v /path/to/drupal/project:/var/www digitalpulp/cli:7.4.16 drush status

2. 使用Composer安装依赖

bash
docker run -v /path/to/drupal/project:/var/www digitalpulp/cli:7.4.16 composer install

3. 执行Drupal Console命令

bash
docker run -v /path/to/drupal/project:/var/www digitalpulp/cli:7.4.16 drupal site:status

CI/CD集成示例（Codeship）

在codeship-services.yml中配置：

yaml
drupal-cli:
  image: digitalpulp/cli:codeship-7.4
  volumes:
    - ./:/var/www
  command: /bin/bash

在codeship-steps.yml中使用：

yaml
- name: 安装依赖
  service: drupal-cli
  command: composer install

- name: 执行数据库迁移
  service: drupal-cli
  command: drush updb -y

路径说明

• 项目挂载点：必须将Drupal项目根目录挂载至/var/www，确保Drush和Composer能正确识别项目结构
• 命令路径：/var/www/vendor/bin已添加至系统PATH，可直接调用该目录下的Drush、Composer等可执行文件