mysql

bitnamicharts/mysql Docker 镜像

Bitnami提供的MySQL Helm chart,用于在Kubernetes环境中简化MySQL数据库的部署、配置与管理,遵循开源最佳实践。

1 次收藏下载次数: 0状态:社区镜像维护者:bitnamicharts仓库类型:镜像最近更新:
下载命令
点击查看

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)

console
helm 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)安装:

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/mysql

替换 REGISTRY_NAME 和 REPOSITORY_NAME,Bitnami 官方仓库为 registry-1.docker.io/bitnamicharts

自定义安装(通过 values 文件)

创建 values.yaml 配置文件,例如:

yaml
architecture: "replication"  # 启用主从复制
auth:
  rootPassword: "StrongRootPass123"
  password: "UserPass456"
  replicationPassword: "ReplPass789"
persistence:
  size: "10Gi"  # PV 存储大小

执行安装:

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/mysql -f values.yaml

配置详情

资源请求与限制

建议为生产环境配置资源请求和限制,避免资源竞争:

yaml
resources:
  requests:
    cpu: "500m"
    memory: "512Mi"
  limits:
    cpu: "1000m"
    memory: "1Gi"

也可通过 resourcesPreset 使用预设配置(如 small、medium),但生产环境建议手动调整

Prometheus 监控集成

启用 metrics 采集:

yaml
metrics:
  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 镜像标签):

yaml
image:
  repository: "bitnami/mysql"
  tag: "8.0.36"  # 自定义版本标签

自定义初始化脚本

通过 initdbScripts 添加初始化脚本(支持 .sh、.sql、.sql.gz):

yaml
initdbScripts:
  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 并配置:

yaml
tls:
  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:手动更新

  1. 通过 MySQL 命令更新密码(参考 https://dev.mysql.com/doc/refman/8.4/en/set-password.html)
  2. 更新 Secret:
shell
kubectl create secret generic my-release-mysql --from-literal=root-password=NewRootPass --from-literal=password=NewUserPass --dry-run -o yaml | kubectl apply -f -

方法2:自动更新(推荐)
启用密码更新 Job:

yaml
passwordUpdateJob:
  enabled: true  #  helm upgrade 时自动执行密码更新
auth:
  rootPassword: "NewRootPass123"
  password: "NewUserPass456"

持久化存储配置

默认使用动态 PV,可自定义存储类或使用现有 PVC:

yaml
persistence:
  enabled: true
  storageClass: "fast-sc"  # 自定义存储类
  size: "20Gi"
  # existingClaim: "mysql-pvc"  # 使用现有 PVC(需提前创建)

Docker 部署示例(非 Helm)

Bitnami MySQL 镜像也可直接通过 Docker 运行(非 Kubernetes 环境):

docker run 命令

shell
docker 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 配置

yaml
version: '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.registryMySQL 镜像仓库REGISTRY_NAME
image.repositoryMySQL 镜像名称REPOSITORY_NAME/mysql
image.tag镜像标签(版本)latest
auth.rootPasswordroot 用户密码(若使用现有 Secret 则忽略)""
auth.database自动创建的数据库名称my_database
auth.username自定义用户名""
auth.replicationUser复制用户名称(replication 架构需配置)replicator
persistence.enabled是否启用持久化存储true
resources.requests.cpuCPU 请求250m
resources.requests.memory内存请求256Mi

完整参数列表

更多参数(如网络策略、Sidecar、备份配置等)请参考 https://github.com/bitnami/charts/blob/main/bitnami/mysql/README.md。

备份与恢复

生产环境建议使用 Velero 备份 PV 数据:

  1. 安装 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)
  2. 备份命令:
shell
velero backup create mysql-backup --include-resources=pvc,pv --selector app.kubernetes.io/name=mysql
  1. 恢复命令:
shell
velero 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/

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 mysql 镜像标签

docker pull docker.xuanyuan.run/bitnamicharts/mysql:<标签>

DockerHub 原生拉取命令

docker pull bitnamicharts/mysql:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告