Hypefactors CI Docker镜像文档

镜像概述

Hypefactors CI Docker镜像是专为CircleCI持续集成平台设计的环境镜像，旨在提供完整的开发、构建与部署工具链，支持各类项目在CircleCI上实现自动化的持续集成流程，简化环境配置并提升流程一致性。

核心功能与特性

该镜像预装以下关键组件，满足多样化CI/CD需求：

• 基础操作系统：Ubuntu 20.04
• PHP环境：PHP 8.0（含相关运行时依赖）
• PHP依赖管理：Composer 2（PHP包管理工具）
• 数据库工具：MySQL Client（数据库连接与操作客户端）
• Node.js环境：Node.js 14（JavaScript运行时）
• Node依赖管理：Yarn（Node.js包管理工具）
• CI平台工具：CircleCI CLI（与CircleCI平台交互的命令行工具）
• 云服务集成：Google Cloud SDK（Google Cloud平台操作工具集）
• 容器辅助工具：Dockerize（容器启动依赖检查工具）
• 本地化管理：Lokalise CLI v2（本地化资源管理工具）

使用场景

适用于以下持续集成与开发流程：

• 基于CircleCI的PHP项目自动化构建、单元测试与集成测试
• 前端项目（依赖Node.js）的代码检查、打包与资源构建
• 需要数据库交互的应用测试（通过MySQL Client连接测试数据库）
• 集成Google Cloud平台的项目部署流程（通过Google Cloud SDK）
• 使用Lokalise进行多语言本地化资源管理的项目构建

使用方法与配置说明

基本使用方式

在CircleCI配置文件（.circleci/config.yml）中指定该镜像作为执行环境，即可直接使用预装工具。示例配置片段：

yaml
version: 2.1
jobs:
  build-and-test:
    docker:
      - image: hypefactors/ci:latest  # 使用Hypefactors CI镜像
    steps:
      - checkout  # 拉取代码
      - run: php --version  # 验证PHP环境
      - run: composer install  # 使用Composer安装PHP依赖
      - run: node --version && yarn --version  # 验证Node.js与Yarn
      - run: yarn install  # 安装Node.js依赖
      - run: circleci config validate  # 使用CircleCI CLI验证配置
      - run: mysql --version  # 验证MySQL Client

工具调用说明

镜像中工具可直接通过命令行调用，无需额外安装：

• PHP相关操作：php [命令]（如php script.php执行脚本）
• Composer操作：composer [命令]（如composer update更新依赖）
• Node.js操作：node [脚本]或npm [命令]
• Yarn操作：yarn [命令]（如yarn build执行构建脚本）
• CircleCI交互：circleci [命令]（如circleci orb validate验证Orb配置）
• 数据库连接：mysql -h [主机] -u [用户] -p [密码] [数据库]（连接测试数据库）
• Google Cloud操作：gcloud [命令]（需先通过gcloud init配置认证）
• 本地化管理：lokalise2 [命令]（如lokalise2 project list列出项目）

环境配置注意事项

• 无需手动安装预装工具，直接调用命令即可
• 敏感信息（如数据库密码、GCP密钥）建议通过CircleCI环境变量管理
• 如需扩展工具，可在CI步骤中通过apt-get等命令临时安装额外依赖（基于Ubuntu 20.04基础）