bitnamicharts/memcached

Bitnami Memcached 图表

Memcached是一个高性能的分布式内存对象缓存系统，通用性强，主要用于加速动态Web应用，减轻数据库负载。

http://memcached.org

商标声明：本软件列表由Bitnami打包。所提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

快速入门

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

希望在生产环境中使用Memcached？请尝试https://bitnami.com/enterprise，即Bitnami目录的商业版。

⚠️ 重要通知：Bitnami目录即将发生的变更

自2025年8月28日起，Bitnami将升级其公共目录，在新的https://news.broadcom.com/app-dev/broadcom-introduces-bitnami-secure-images-for-production-ready-containerized-applications下提供精选的强化、安全聚焦镜像集。作为此过渡的一部分：

• 首次向社区用户开放流行容器镜像的安全优化版本访问权限。
• Bitnami将开始在其免费层级中弃用对非强化、基于Debian的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以“latest”标签发布，适用于开发目的。
• 自8月28日起，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，包括强化容器、更小的***面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有Bitnami用户的安全态势。更多详情，请访问https://github.com/bitnami/containers/issues/83267。

介绍

此图表使用https://helm.sh包管理器在https://kubernetes.io集群上引导https://github.com/bitnami/containers/tree/main/bitnami/memcached部署。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+

安装图表

要使用发布名称“my-release”安装图表：

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

注意：您需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm图表仓库和仓库名称的引用。例如，对于Bitnami，需使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

这些命令使用默认配置在Kubernetes集群上部署Memcached。参数部分列出了安装期间可配置的参数。

提示：使用helm list列出所有发布。

配置和安装详情

资源请求与限制

Bitnami图表允许为图表部署内的所有容器设置资源请求和限制。这些配置位于resources值中（参见参数表）。为生产工作负载设置请求至关重要，且应根据您的具体用例进行调整。

为简化此过程，图表包含resourcesPreset值，可根据不同预设自动设置resources部分。请在https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15中查看这些预设。但在生产工作负载中，不建议使用`resourcesPreset`，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参阅https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/。

Prometheus指标

通过将metrics.enabled设置为true，此图表可与Prometheus集成。这将在所有Pod中部署带有https://github.com/prometheus/memcached_exporter的sidecar容器以及`metrics`服务，可在`metrics.service`部分下进行配置。此`metrics`服务将具有必要的注解，以便被Prometheus自动抓取。

Prometheus要求

要实现集成，需要安装Prometheus或Prometheus Operator。安装https://github.com/bitnami/charts/tree/main/bitnami/prometheus或https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus，可轻松在集群中部署可用的Prometheus。

与Prometheus Operator集成

通过将值metrics.serviceMonitor.enabled=true设置为true，图表可以部署ServiceMonitor对象，以与Prometheus Operator安装集成。确保集群中已安装Prometheus OperatorCustomResourceDefinitions，否则将失败并显示以下错误：

text
no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus以获取必要的CRD和Prometheus Operator。

https://techdocs.broadcom.com/us/en/vmware-tanzu/application-catalog/tanzu-application-catalog/services/tac-doc/apps-tutorials-understand-rolling-tags-containers-index.html

强烈建议在生产环境中使用不可变标签。这可确保如果同一标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大变更或存在严重漏洞，Bitnami将发布新图表以更新其容器。

更新凭证

Bitnami Memcached图表在升级时，会重用之前由图表渲染的密钥或在auth.existingPasswordSecret中指定的密钥。要更新凭证，请使用以下方法之一：

• 运行helm upgrade，在auth.password中指定新密码
• 运行helm upgrade，在auth.existingPasswordSecret中指定新密钥

使用Sidecar和Init容器

如果同一Pod中需要额外容器（如额外的指标或日志导出器），可使用sidecars配置参数定义。

yaml
sidecars:
- name: your-image-name
  image: docker.xuanyuan.run/your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

如果这些sidecar导出额外端口，可使用service.extraPorts参数（如可用）添加额外端口定义，如下例所示：

yaml
service:
  extraPorts:
  - name: extraPort
    port: 11311
    targetPort: 11311

注意：此Helm图表已包含Prometheus导出器的sidecar容器（如适用）。可在部署时添加--enable-metrics=true参数激活这些容器。因此，sidecars参数应仅用于任何额外的sidecar容器。

如果同一Pod中需要额外的init容器，可使用initContainers参数定义。示例如下：

yaml
initContainers:
  - name: your-image-name
    image: docker.xuanyuan.run/your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于https://kubernetes.io/docs/concepts/workloads/pods/和https://kubernetes.io/docs/concepts/workloads/pods/init-containers/的信息。

设置Pod亲和性

此图表允许使用affinity参数设置自定义亲和性。有关Pod亲和性的更多信息，请参阅https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity。

作为替代方案，可使用https://github.com/bitnami/charts/tree/main/bitnami/common#affinities图表中提供的Pod亲和性、Pod反亲和性和节点亲和性预设配置。为此，设置`podAffinityPreset`、`podAntiAffinityPreset`或`nodeAffinityPreset`参数。

备份与恢复

要在Kubernetes上备份和恢复Helm图表部署，需要使用https://velero.io/（Kubernetes备份/恢复工具）备份源部署的持久卷，并将其附加到新部署。有关使用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。

持久化

当使用architecture: "high-availability"时，如果启用，https://github.com/bitnami/containers/tree/main/bitnami/memcached镜像会将缓存状态存储在容器的`/cache-state`路径下。

持久卷声明（PVCs）用于跨部署保留数据。已知在GCE、AWS和minikube上可用。

请参阅参数部分配置PVC或禁用持久化。

如果使用持久卷时遇到错误，请参考我们的https://docs.bitnami.com/kubernetes/faq/troubleshooting/troubleshooting-persistence-volumes/。

参数

全局参数

通用参数

Memcached参数

部署/有状态集参数

注意：此图表的README超出了DockerHub的25000字符限制，因此已被截断。完整README可在https://github.com/bitnami/charts/blob/main/bitnami/memcached/README.md查看。