communica/ci-container

communica/ci-container 镜像文档

概述

communica/ci-container 是一个基于 Ubuntu 22.04 的 Docker 镜像，专为 CI（持续集成）环境设计。该镜像集成了开发和部署工作流中常用的核心工具与服务，旨在为 CI/CD 流水线提供一致、高效的运行环境。

核心功能与特性

基础环境

• 基础镜像：Ubuntu 22.04，提供稳定的操作系统环境

开发工具

• PHP 版本：支持 PHP 8.0、PHP 8.1、PHP 8.2 和 PHP 8.3（需选择相应的 Dockerfile）
• PHP 扩展：包含 php-fpm、php-bcmath、php-cli、php-curl、php-gd、php-imagick、php-mbstring、php-mongodb、php-xml、php-zip 等常用扩展
• Node.js 与 Yarn：集成最新版本，用于前端包管理
• Composer：PHP 依赖管理工具，用于 PHP 项目依赖安装与管理

部署与监控工具

• Lagoon CLI：用于管理 Lagoon 部署的命令行工具，支持部署流程自动化
• Sentry CLI：Sentry 错误跟踪与监控工具，支持错误上报与性能监控配置

使用场景与适用范围

• CI/CD 流水线：作为 CI 环境的基础镜像，支持代码构建、测试、打包等自动化流程
• 开发环境一致性：确保开发、测试、生产环境工具版本一致，减少"在我机器上能运行"问题
• 自动化部署：结合 Lagoon CLI 实现应用自动部署到 Lagoon 平台
• 错误监控集成：通过 Sentry CLI 将构建/部署过程中的错误信息同步至 Sentry 平台

使用方法与配置说明

选择 PHP 版本

该镜像提供多个 PHP 版本，需根据项目需求选择对应的 Dockerfile 构建或拉取镜像。例如：

• PHP 8.0：使用包含 PHP 8.0 配置的 Dockerfile
• PHP 8.3：使用包含 PHP 8.3 配置的 Dockerfile

基本使用示例

拉取镜像（假设已构建特定 PHP 版本镜像）

bash
docker pull communica/ci-container:php8.2  # 示例：拉取 PHP 8.2 版本镜像

运行容器

bash
docker run -it --rm \
  -v $(pwd):/app \  # 挂载当前工作目录到容器内 /app
  communica/ci-container:php8.2 \
  /bin/bash  # 启动交互式终端

在 CI 流水线中使用（以 GitLab CI 为例）

在 .gitlab-ci.yml 中配置：

yaml
stages:
  - build

build:
  stage: build
  image: communica/ci-container:php8.2
  script:
    - composer install  # 使用 Composer 安装 PHP 依赖
    - yarn install      # 使用 Yarn 安装前端依赖
    - yarn build        # 构建前端资源
    - sentry-cli releases new $CI_COMMIT_SHA  # 通过 Sentry CLI 创建发布记录
    - lagoon deploy     # 使用 Lagoon CLI 部署应用

环境变量配置

可通过环境变量自定义工具行为，常用环境变量包括：

• COMPOSER_HOME：Composer 配置目录，默认 /root/.composer
• NODE_ENV：Node.js 环境，默认 production
• SENTRY_AUTH_TOKEN：Sentry CLI 认证令牌，用于 Sentry 操作授权
• LAGOON_API_TOKEN：Lagoon CLI 认证令牌，用于 Lagoon 部署授权

注意事项

• 不同 PHP 版本镜像需分别构建和管理，确保选择与项目兼容的版本
• 敏感信息（如 Sentry/Lagoon 令牌）建议通过 CI 环境变量注入，避免硬编码
• 首次使用时可能需要初始化工具配置（如 composer config、sentry-cli config）