ccitest/mysql

CircleCI MySQL 测试镜像

镜像概述与主要用途

CircleCI MySQL 测试镜像是 CircleCI 官方提供的针对 MySQL 的专用测试镜像，基于官方 MySQL 镜像扩展优化，旨在提升其在 CircleCI 环境中的兼容性和易用性。主要用于在 CircleCI CI/CD 流程中支持 MySQL 相关的测试、构建验证及应用集成测试等任务。

核心功能与特性

• 扩展官方镜像：基于 Docker 官方 MySQL 镜像构建，保留原生功能的同时增加 CircleCI 环境适配特性。
• 优化环境兼容性：针对 CircleCI 运行环境进行定制，确保在 CI/CD 流程中稳定运行。
• 简化采用流程：降低 Docker 和 CircleCI 技术的使用门槛，帮助用户快速上手并成功应用于项目。

适用场景与范围

适用于所有基于 CircleCI 进行 CI/CD 的项目，特别是需要在自动化流程中进行以下操作的场景：

• MySQL 数据库相关的单元测试、集成测试
• 依赖 MySQL 的应用程序构建与验证
• 数据库迁移脚本测试

镜像变体与标签说明

注意：受 Docker Hub 功能限制，标签页可能未显示所有可用镜像变体。完整的变体列表及对应 Dockerfile，请参见 https://github.com/CircleCI-Public/circleci-dockerfiles%E3%80%82

• Docker Hub circleci 命名空间下的镜像（hub.docker.com/r/circleci）由 https://github.com/circleci-public/circleci-dockerfiles 跟踪。
• Docker Hub ccistaging 命名空间下的镜像（hub.docker.com/r/ccistaging）由 https://github.com/CircleCI-Public/circleci-dockerfiles/tree/staging 跟踪。

使用方法与配置说明

基本使用

在 CircleCI 配置或本地环境中，可通过以下方式使用该镜像：

Docker 运行示例

bash
docker run -d --name circleci-mysql-test circleci/mysql:<tag>

注：<tag> 需替换为具体版本标签，完整标签列表可参考 https://github.com/CircleCI-Public/circleci-dockerfiles%E3%80%82

CircleCI 配置示例

在 .circleci/config.yml 中指定镜像时，建议固定镜像版本（如使用 SHA256 摘要）以避免非预期变更：

yaml
docker:
  - image: circleci/mysql@sha256:54057dd7e125ca41afe526a877e8bd35ec2cdd33b9217e022ed37bdcf7d09673

注意事项

实验阶段说明

当前镜像处于实验阶段，CircleCI 可能在未来对其进行不兼容变更。为确保构建稳定性，建议：

• 固定使用特定版本的 SHA256 摘要（如上述配置示例）
• 或根据项目需求自建镜像并维护

变更通知

CircleCI 会定期对镜像进行维护更新（如内容更新、标签规则调整等）。除紧急 bug 修复或安全补丁外，所有变更将提前在 CircleCI Discuss 论坛的 Announcements 版块发布通知，相关帖子将带有 convenience-images 标签：

• 通知地址：CircleCI Discuss Announcements
• 标签筛选：convenience-images 标签

用户可注册 Discuss 账号并订阅相关帖子，以接收邮件通知。

用户反馈

如遇镜像使用问题或有疑问，请通过 CircleCI Discuss 论坛 environment 版块 联系官方支持。

源码地址

镜像源码及构建脚本托管于 GitHub：https://github.com/circleci/circleci-images