bitnamicharts/mysql Docker 镜像
Bitnami提供的MySQL Helm chart,用于在Kubernetes环境中简化MySQL数据库的部署、配置与管理,遵循开源最佳实践。
Bitnami MySQL Helm Chart 文档
镜像概述和主要用途
Bitnami MySQL Helm Chart 用于在 Kubernetes 集群上快速部署和管理 MySQL 数据库。MySQL 是一款快速、可靠、可扩展且易于使用的开源关系型数据库系统,专为处理关键任务、高负载的生产应用而设计。本 Chart 基于 Bitnami 优化的 MySQL 容器镜像,支持单机(standalone)和主从复制(replication)两种架构,提供自动化配置、持久化存储、安全加固等企业级特性,适用于开发、测试及生产环境(生产环境推荐使用 Bitnami Secure Images)。
核心功能和特性
- 灵活架构:支持单机(standalone)和主从复制(replication)模式,满足不同可用性需求
- 安全加固:遵循 Bitnami 安全最佳实践,未来将迁移至 Bitnami Secure Images(2025年8月28日起),提供更小***面、CVE 透明度(VEX/KEV)、SBOM 等特性
- 自动化配置:支持初始化脚本(.sh、.sql、.sql.gz)、自定义用户/数据库创建、凭据管理
- 监控集成:可与 Prometheus 集成,通过 mysqld_exporter 暴露指标,支持 Prometheus Operator 的 ServiceMonitor
- 持久化存储:默认使用动态 PV 配置,支持现有 PVC 挂载,确保数据持久化
- 网络策略:可配置网络策略限制Pod间通信,增强安全性
- TLS 加密:支持通过现有证书或自动生成(Helm/CertManager)启用 TLS 通信加密
- 凭据管理:支持手动或自动更新数据库凭据(root密码、用户密码、复制密码)
使用场景和适用范围
适用场景
- 开发/测试环境:快速搭建 MySQL 实例,支持自定义初始化脚本和配置
- CI/CD 流水线:作为应用测试的数据库依赖,通过 Helm 实现自动化部署
- 生产环境(需注意):社区版镜像将于2025年8月28日后逐步迁移至 Legacy 仓库(不再更新),生产环境建议使用 Bitnami Secure Images,获取长期支持和安全加固
适用范围
- Kubernetes 集群(1.23+版本)
- Helm 3.8.0+ 客户端
- 需要可靠关系型数据库的应用(如Web应用、企业系统、数据分析平台等)
核心功能和特性详情
| 功能 | 描述 |
|---|---|
| 多架构支持 | 支持 standalone(单机)和 replication(主从复制)两种部署架构 |
| 安全凭据管理 | 通过 Kubernetes Secret 存储密码,支持自动/手动更新凭据 |
| 初始化脚本 | 支持 .sh、.sql、.sql.gz 类型的初始化脚本,主节点仅执行 SQL 脚本 |
| 监控集成 | 内置 mysqld_exporter,支持 Prometheus 指标采集和 ServiceMonitor 配置 |
| 持久化存储 | 支持动态 PV 配置或现有 PVC 挂载,数据路径 /bitnami/mysql |
| 网络隔离 | 可配置 NetworkPolicy 限制端口访问(默认3306) |
| 灵活的镜像管理 | 支持自定义镜像仓库、标签、拉取策略,兼容不可变标签(推荐生产使用) |
详细使用方法和配置说明
前提条件
- Kubernetes 集群版本 ≥ 1.23
- Helm 版本 ≥ 3.8.0
- 集群支持 PV 动态供应(或手动创建 PVC)
快速安装(TL;DR)
consolehelm install my-release oci://registry-1.docker.io/bitnamicharts/mysql
重要通知:Bitnami 目录即将变更(2025年8月28日起)
Bitnami 将升级公共目录,推出 Bitnami Secure Images 计划,具体变更如下:
- 社区用户首次可访问安全优化镜像:提供加固版容器镜像,减少***面
- 非加固镜像逐步淘汰:免费 tier 将停止支持 Debian 基础的非加固镜像,仅保留 "latest" 标签(用于开发)
- 旧镜像迁移:所有现有镜像(含历史版本标签,如 10.6、2.50.0)将迁移至
docker.io/bitnamilegacy仓库,不再更新 - 生产环境建议:生产 workload 需使用 Bitnami Secure Images,包含加固容器、CVE 透明度(VEX/KEV)、SBOM 和企业支持
详情见 https://github.com/bitnami/containers/issues/83267
安装 Helm Chart
标准安装
指定发布名称(如 my-release)安装:
consolehelm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/mysql
替换
REGISTRY_NAME和REPOSITORY_NAME,Bitnami 官方仓库为registry-1.docker.io/bitnamicharts
自定义安装(通过 values 文件)
创建 values.yaml 配置文件,例如:
yamlarchitecture: "replication" # 启用主从复制 auth: rootPassword: "StrongRootPass123" password: "UserPass456" replicationPassword: "ReplPass789" persistence: size: "10Gi" # PV 存储大小
执行安装:
consolehelm install my-release oci://registry-1.docker.io/bitnamicharts/mysql -f values.yaml
配置详情
资源请求与限制
建议为生产环境配置资源请求和限制,避免资源竞争:
yamlresources: requests: cpu: "500m" memory: "512Mi" limits: cpu: "1000m" memory: "1Gi"
也可通过
resourcesPreset使用预设配置(如small、medium),但生产环境建议手动调整
Prometheus 监控集成
启用 metrics 采集:
yamlmetrics: enabled: true # 部署 mysqld_exporter 边车容器 serviceMonitor: enabled: true # 创建 ServiceMonitor(需 Prometheus Operator)
- 依赖:集群需已安装 Prometheus 或 Prometheus Operator(推荐 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus)
使用不同 MySQL 版本
通过 image.tag 指定版本(需对应 Bitnami 镜像标签):
yamlimage: repository: "bitnami/mysql" tag: "8.0.36" # 自定义版本标签
自定义初始化脚本
通过 initdbScripts 添加初始化脚本(支持 .sh、.sql、.sql.gz):
yamlinitdbScripts: create_database.sh: | #!/bin/bash # 仅主节点执行(主机名含 "primary") if [[ $(hostname) == *primary* ]]; then mysql -uroot -p"${MYSQL_ROOT_PASSWORD}" -e "CREATE DATABASE IF NOT EXISTS app_db;" fi
.sh脚本在所有节点执行(需自行判断节点类型),.sql/.sql.gz仅在主节点执行
TLS 加密通信
启用 TLS 需创建证书 Secret 并配置:
yamltls: enabled: true existingSecret: "mysql-tls-secret" # 包含 tls.crt、tls.key、ca.crt 的 Secret
自动生成证书(二选一):
- Helm 生成:
tls.autoGenerated.enabled: true+tls.autoGenerated.engine: helm - CertManager 生成:
tls.autoGenerated.engine: cert-manager(需指定 Issuer)
更新数据库凭据
方法1:手动更新
- 通过 MySQL 命令更新密码(参考 https://dev.mysql.com/doc/refman/8.4/en/set-password.html)
- 更新 Secret:
shellkubectl create secret generic my-release-mysql --from-literal=root-password=NewRootPass --from-literal=password=NewUserPass --dry-run -o yaml | kubectl apply -f -
方法2:自动更新(推荐)
启用密码更新 Job:
yamlpasswordUpdateJob: enabled: true # helm upgrade 时自动执行密码更新 auth: rootPassword: "NewRootPass123" password: "NewUserPass456"
持久化存储配置
默认使用动态 PV,可自定义存储类或使用现有 PVC:
yamlpersistence: enabled: true storageClass: "fast-sc" # 自定义存储类 size: "20Gi" # existingClaim: "mysql-pvc" # 使用现有 PVC(需提前创建)
Docker 部署示例(非 Helm)
Bitnami MySQL 镜像也可直接通过 Docker 运行(非 Kubernetes 环境):
docker run 命令
shelldocker run -d \ --name mysql \ -e MYSQL_ROOT_PASSWORD=root123 \ -e MYSQL_DATABASE=app_db \ -e MYSQL_USER=app_user \ -e MYSQL_PASSWORD=user123 \ -p 3306:3306 \ -v mysql-data:/bitnami/mysql \ docker.xuanyuan.run/bitnami/mysql:latest
docker-compose 配置
yamlversion: '3' services: mysql: image: docker.xuanyuan.run/bitnami/mysql:latest ports: - "3306:3306" environment: - MYSQL_ROOT_PASSWORD=root123 - MYSQL_DATABASE=app_db - MYSQL_USER=app_user - MYSQL_PASSWORD=user123 volumes: - mysql-data:/bitnami/mysql volumes: mysql-data:
配置参数说明
全局参数
| 参数名 | 描述 | 默认值 |
|---|---|---|
global.imageRegistry | 全局 Docker 镜像仓库 | "" |
global.imagePullSecrets | 全局镜像拉取密钥(数组) | [] |
global.defaultStorageClass | 全局默认存储类 | "" |
global.security.allowInsecureImages | 是否允许不安全镜像(跳过验证) | false |
global.compatibility.openshift.adaptSecurityContext | 是否适配 OpenShift 安全上下文(auto/force/disabled) | auto |
MySQL 核心参数
| 参数名 | 描述 | 默认值 |
|---|---|---|
architecture | 部署架构:standalone(单机)或 replication(主从复制) | standalone |
image.registry | MySQL 镜像仓库 | REGISTRY_NAME |
image.repository | MySQL 镜像名称 | REPOSITORY_NAME/mysql |
image.tag | 镜像标签(版本) | latest |
auth.rootPassword | root 用户密码(若使用现有 Secret 则忽略) | "" |
auth.database | 自动创建的数据库名称 | my_database |
auth.username | 自定义用户名 | "" |
auth.replicationUser | 复制用户名称(replication 架构需配置) | replicator |
persistence.enabled | 是否启用持久化存储 | true |
resources.requests.cpu | CPU 请求 | 250m |
resources.requests.memory | 内存请求 | 256Mi |
完整参数列表
更多参数(如网络策略、Sidecar、备份配置等)请参考 https://github.com/bitnami/charts/blob/main/bitnami/mysql/README.md。
备份与恢复
生产环境建议使用 Velero 备份 PV 数据:
- 安装 Velero(参考 https://techdocs.broadcom.com/us/en/vmware-tanzu/application-catalog/tanzu-application-catalog/services/tac-doc/apps-tutorials-backup-restore-deployments-velero-index.html)
- 备份命令:
shellvelero backup create mysql-backup --include-resources=pvc,pv --selector app.kubernetes.io/name=mysql
- 恢复命令:
shellvelero restore create --from-backup mysql-backup
注意事项
- 生产环境镜像:2025年8月28日后,非加固镜像将迁移至
bitnamilegacy仓库且不再更新,生产环境需迁移至 Bitnami Secure Images - 不可变标签:推荐使用具体版本标签(如
8.0.36)而非latest,避免自动更新导致不一致 - 持久化问题:若 PV 挂载失败,参考 https://docs.bitnami.com/kubernetes/faq/troubleshooting/troubleshooting-persistence-volumes/
bitnamicharts 命名空间的其他可用镜像:
bitnamicharts/kafka
bitnamicharts/etcd
bitnamicharts/postgresql
bitnamicharts/harbor
bitnamicharts/milvus
bitnamicharts/cadvisor
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务