bitnamicharts/wordpress

Bitnami WordPress Helm Chart

镜像概述和主要用途

WordPress 是全球最流行的博客和内容管理平台。它功能强大且简单易用，从学生到跨国公司，都使用它来构建美观、实用的网站。

Bitnami WordPress Helm Chart 用于在 Kubernetes 集群上通过 Helm 包管理器引导 WordPress 部署。该 Chart 还集成了 Bitnami MariaDB Chart（满足 WordPress 的数据库需求）和 Bitnami Memcached Chart（用于缓存数据库查询）。

WordPress 官方概述

核心功能和特性

• 完整依赖集成：默认包含 MariaDB 数据库和 Memcached 缓存服务，也支持连接外部数据库和缓存
• 生产级配置：支持资源请求/限制、Pod 亲和性/反亲和性、节点亲和性配置
• 安全增强：支持 TLS 加密、安全上下文适配（兼容 OpenShift）、禁止不安全镜像
• 可观测性：集成 Prometheus 指标（通过 apache-exporter），支持 ServiceMonitor 对接 Prometheus Operator
• 灵活的网络配置：支持 Ingress 资源，可配置主机名、路径和 TLS 证书
• 外部服务支持：可对接外部数据库（禁用内置 MariaDB）和外部缓存（禁用内置 Memcached）
• 持久化存储：使用 Persistent Volume Claims 持久化 WordPress 数据和配置
• 配置定制：支持自定义环境变量、Sidecar 容器、Init 容器和 .htaccess 配置

使用场景和适用范围

• 开发环境：快速部署 WordPress 进行功能测试和插件开发，利用 "latest" 标签镜像
• 生产环境：建议使用 Bitnami Secure Images（提供硬化容器、CVE 透明度、SBOM 和企业支持）
• 规模化部署：通过 Kubernetes 实现 WordPress 多副本扩展，结合 Ingress 和负载均衡
• 混合架构：适用于需要对接外部托管数据库（如 AWS RDS、Azure Database）的场景
• 安全敏感场景：需满足软件供应链安全要求，需要最小***面和定期安全更新的部署

详细使用方法和配置说明

前置要求

• Kubernetes 集群版本 1.23+
• Helm 版本 3.8.0+
• 底层基础设施支持 PV 供应器
• 支持 ReadWriteMany 卷（用于部署扩展）

安装 Chart

快速安装（TL;DR）

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/wordpress

详细安装步骤

1. 使用指定发布名称安装：

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

   需替换占位符：REGISTRY_NAME（如 registry-1.docker.io）和 REPOSITORY_NAME（如 bitnamicharts）

2. 查看所有发布：

   console
   helm list
   

配置与管理

资源请求和限制

Bitnami Charts 允许为所有容器设置资源请求和限制，通过 resources 参数配置。生产环境必须设置资源请求，并根据实际需求调整。示例：

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

也可使用 resourcesPreset 预设（如 small、medium、large），但生产环境建议手动配置以适配具体需求。

凭证更新

Bitnami Charts 在首次启动时配置凭证，后续更新需手动操作：

1. 参考 WordPress 官方文档 更新用户密码
2. 更新 Kubernetes Secret（替换 SECRET_NAME、PASSWORD 和 SMTP_PASSWORD）：

   shell
   kubectl create secret generic SECRET_NAME \
     --from-literal=wordpress-password=PASSWORD \
     --from-literal=smtp-password=SMTP_PASSWORD \
     --dry-run -o yaml | kubectl apply -f -
   

Prometheus 指标集成

1. 启用指标：设置 metrics.enabled=true，将部署包含 apache-exporter 的 Sidecar 容器和 metrics Service
2. 对接 Prometheus Operator：设置 metrics.serviceMonitor.enabled=true，自动创建 ServiceMonitor 资源
3. 前置条件：集群需已安装 Prometheus 或 Prometheus Operator（推荐使用 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%89

外部数据库支持

禁用内置 MariaDB 并连接外部数据库：

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/wordpress \
  --set mariadb.enabled=false \
  --set externalDatabase.host=myexternalhost \
  --set externalDatabase.user=myuser \
  --set externalDatabase.password=mypassword \
  --set externalDatabase.database=mydatabase \
  --set externalDatabase.port=3306

若数据库包含现有 WordPress 数据，需设置 wordpressSkipInstall=true 跳过安装向导

Memcached 配置

启用内置 Memcached

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/wordpress \
  --set wordpressConfigureCache=true \
  --set memcached.enabled=true

对接外部 Memcached

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/wordpress \
  --set wordpressConfigureCache=true \
  --set memcached.enabled=false \
  --set externalCache.host=myexternalcachehost \
  --set externalCache.port=11211

Ingress 配置

启用 Ingress 以通过域名访问 WordPress：

yaml
ingress:
  enabled: true
  hostname: wordpress.example.com
  tls: true
  annotations:
    kubernetes.io/ingress.class: nginx
    cert-manager.io/cluster-issuer: letsencrypt-prod  # 若使用 cert-manager
  # 额外主机配置（可选）
  extraHosts:
    - name: blog.example.com
      path: /blog
      annotations: {}

需确保集群已安装 Ingress 控制器（如 https://github.com/bitnami/charts/tree/main/bitnami/nginx-ingress-controller%EF%BC%89

TLS 安全配置

支持多种 TLS 证书管理方式：

1. 手动创建 TLS Secret：

   console
   kubectl create secret tls wordpress-tls \
     --cert=path/to/certificate.pem \
     --key=path/to/private-key.pem
   

   （Secret 名称需为 <ingress.hostname>-tls，如 wordpress.example.com-tls）

2. 通过 cert-manager 自动签发： 在 Ingress 注解中添加：

   yaml
   annotations:
     cert-manager.io/cluster-issuer: "letsencrypt-prod"
     acme.cert-manager.io/http01-ingress-class: "nginx"
   

3. Helm 管理证书：

   yaml
   ingress:
     tls: true
     secrets:
       - name: wordpress-tls
         certificate: |
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         key: |
           -----BEGIN RSA PRIVATE KEY-----
           ...
           -----END RSA PRIVATE KEY-----
   

.htaccess 文件管理

• 默认配置：容器内置 wordpress-htaccess.conf（位于 /opt/bitnami/wordpress/），Apache 配置为 AllowOverride None（禁用 .htaccess）
• 启用插件 .htaccess：部分插件依赖 .htaccess，需：

  yaml
  allowOverrideNone: false
  htaccessPersistenceEnabled: true  # 持久化 .htaccess 编辑
  

• 自定义配置：创建包含自定义指令的 ConfigMap（如 custom-htaccess），并配置：

  yaml
  allowOverrideNone: true
  customHTAccessCM: custom-htaccess
  

备份与恢复

使用 Velero 备份和恢复 WordPress 部署：

1. 备份持久卷（PV）和部署配置
2. 恢复时将备份的 PV 挂载到新部署

详细步骤参考 Bitnami Velero 备份指南

持久化存储

WordPress 数据和配置存储在容器的 /bitnami 路径，通过 Persistent Volume Claim 持久化：

• 默认使用 storageClass: ""（依赖集群默认 StorageClass）
• 自定义存储配置：

  yaml
  persistence:
    enabled: true
    storageClass: "fast-storage"
    size: 10Gi
    accessMode: ReadWriteOnce
  

额外环境变量

添加自定义环境变量：

yaml
wordpress:
  extraEnvVars:
    - name: LOG_LEVEL
      value: "error"
    - name: WP_DEBUG
      value: "false"

或通过 ConfigMap/Secret 注入：

yaml
wordpress:
  extraEnvVarsCM: custom-env-cm  # 从 ConfigMap 注入
  extraEnvVarsSecret: custom-env-secret  # 从 Secret 注入

Sidecar 和 Init 容器

添加 Sidecar 容器（如日志收集器）：

yaml
sidecars:
  - name: log-exporter
    image: busybox:1.35
    command: ["tail", "-f", "/var/log/wordpress/access.log"]
    volumeMounts:
      - name: logs
        mountPath: /var/log/wordpress

添加 Init 容器（如文件权限配置）：

yaml
initContainers:
  - name: fix-permissions
    image: busybox:1.35
    command: ["chmod", "-R", "755", "/bitnami/wordpress"]
    volumeMounts:
      - name: wordpress-data
        mountPath: /bitnami/wordpress

Pod 亲和性配置

自定义 Pod 亲和性规则：

yaml
affinity:
  podAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      - labelSelector:
          matchExpressions:
            - key: app.kubernetes.io/name
              operator: In
              values:
                - mariadb
        topologyKey: "kubernetes.io/hostname"

或使用预设亲和性（来自 https://github.com/bitnami/charts/tree/main/bitnami/common#affinities%EF%BC%89%EF%BC%9A

yaml
podAffinityPreset: soft  # 软亲和性
podAntiAffinityPreset: hard  # 硬反亲和性
nodeAffinityPreset:
  type: required
  key: workload
  values: ["wordpress"]

⚠️ 重要通知：Bitnami 镜像仓库即将变更

自 2025 年 8 月 28 日起，Bitnami 将升级其公共镜像仓库，推出Bitnami Secure Images计划，主要变更包括：

核心变更

• 安全镜像开放：首次向社区用户提供安全优化版容器镜像
• 非硬化镜像弃用：免费 tier 将逐步淘汰基于 Debian 的非硬化镜像，仅保留少量硬化镜像（仅 latest 标签，用于开发）
• 旧镜像迁移：所有现有容器镜像（含历史版本标签，如 2.50.0、10.6）将在两周内迁移至 docker.io/bitnamilegacy（不再更新）
• 生产环境建议：生产工作负载需使用 Bitnami Secure Images（提供硬化容器、最小***面、CVE 透明度、SBOM 和企业支持）

影响与建议

• 开发环境：可继续使用 latest 标签的硬化镜像
• 生产环境：迁移至 Bitnami Secure Images 以获取长期支持
• 历史版本依赖：需将镜像源从 docker.io/bitnami 切换至 docker.io/bitnamilegacy

更多详情见 https://github.com/bitnami/containers/issues/83267

参数说明

全局参数

通用参数

WordPress 镜像参数

已知限制

• 多副本维护模式问题：执行需要维护模式的管理操作（如插件更新）时，仅会在一个副本上激活维护模式，其他副本可能继续处理请求导致不可预测结果。

  解决方法：通过 WP CLI 在所有副本上手动激活/停用维护模式（假设发布名为 wordpress，3 个副本）：

  console
  # 激活维护模式
  for i in 0 1 2; do
    kubectl exec $(kubectl get pods -l app.kubernetes.io/name=wordpress -o jsonpath="{.items[$i].metadata.name}") -c wordpress -- wp maintenance-mode activate
  done
  
  # 停用维护模式
  for i in 0 1 2; do
    kubectl exec $(kubectl get pods -l app.kubernetes.io/name=wordpress -o jsonpath="{.items[$i].metadata.name}") -c wordpress -- wp maintenance-mode deactivate
  done
  

完整参数列表请参见 https://github.com/bitnami/charts/blob/main/bitnami/wordpress/README.md