bitnamicharts/apache

Bitnami Apache 软件包

Apache HTTP Server是一款开源HTTP服务器。该项目旨在提供安全、高效且可扩展的服务器，以同步当前HTTP标准提供HTTP服务。

Apache概述

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

快速入门

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

希望在生产环境中使用Apache？请尝试VMware Tanzu Application Catalog，即Bitnami目录的商业版。

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

自2025年8月28日起，Bitnami将升级其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦镜像集。作为此过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本访问权限。
• 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%E3%80%82

简介

Bitnami的Helm图表经过精心设计、积极维护，是在Kubernetes集群上部署容器的最快、最简单方式，可直接用于处理生产工作负载。

本图表使用Helm包管理器在Kubernetes集群上引导https://github.com/bitnami/containers/tree/main/bitnami/apache%E9%83%A8%E7%BD%B2%E3%80%82

Apache HTTP Server（“httpd”）于1995年启动，自1996年4月起一直是互联网上最受欢迎的Web服务器。2015年2月，该项目庆祝了其20周年纪念日。

先决条件

• Kubernetes 1.23+
• Helm 3.8.0+

安装图表

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

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

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

这些命令以默认配置在Kubernetes集群上部署Apache。

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

配置和安装详情

资源请求和限制

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

为简化此过程，图表包含resourcesPreset值，可根据不同预设自动设置resources部分。有关这些预设，请查看https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%E3%80%82%E4%BD%86%E5%9C%A8%E7%94%9F%E4%BA%A7%E5%B7%A5%E4%BD%9C%E8%B4%9F%E8%BD%BD%E4%B8%AD%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%60resourcesPreset%60%EF%BC%8C%E5%9B%A0%E4%B8%BA%E5%AE%83%E5%8F%AF%E8%83%BD%E6%97%A0%E6%B3%95%E5%AE%8C%E5%85%A8%E9%80%82%E5%BA%94%E6%82%A8%E7%9A%84%E5%85%B7%E4%BD%93%E9%9C%80%E6%B1%82%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90%E7%AE%A1%E7%90%86%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81Kubernetes%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E3%80%82

滚动标签与不可变标签

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

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

备份和恢复

要在Kubernetes上备份和恢复Helm图表部署，需使用Velero（Kubernetes备份/恢复工具）备份源部署的持久卷，并将其附加到新部署。有关使用Velero的说明，请参见本指南。

部署自定义Web应用

Apache图表允许通过以下方法之一部署自定义Web应用：

• 从Git仓库克隆：将cloneHtdocsFromGit.enabled设为true，并使用cloneHtdocsFromGit.repository和cloneHtdocsFromGit.branch参数设置仓库和分支。Sidecar容器还将按cloneHtdocsFromGit.interval设置的间隔拉取最新更改。
• 提供ConfigMap：设置htdocsConfigMap值以在Apache htdocs文件夹中挂载ConfigMap。
• 使用现有PVC：设置htdocsPVC值以挂载包含Web应用内容的PersistentVolumeClaim。

以下是使用第一种方法从Git仓库部署Web应用的示例：

text
cloneHtdocsFromGit.enabled=true
cloneHtdocsFromGit.repository=https://github.com/mdn/beginner-html-site-styled.git
cloneHtdocsFromGit.branch=master

要使用自定义httpd.conf文件，可使用httpdConfConfigMap参数挂载，该参数引用包含httpd.conf文件内容的Kubernetes ConfigMap。或者，将httpd.conf文件复制到当前工作目录的files/httpd.conf以在容器中挂载。

要挂载不同的虚拟主机配置，使用vhostsConfigMap值。这是指向包含所需Apache虚拟主机配置的Kubernetes ConfigMap的指针。您还可以将虚拟主机配置复制到当前工作目录的files/vhosts/目录下，以将其作为ConfigMap挂载到容器中。

设置Pod亲和性

本图表允许使用affinity参数设置自定义亲和性。有关Pod亲和性的更多信息，请参见Kubernetes文档。

作为替代方案，您可以使用https://github.com/bitnami/charts/tree/main/bitnami/common#affinities%E5%9B%BE%E8%A1%A8%E4%B8%AD%E6%8F%90%E4%BE%9B%E7%9A%84Pod%E4%BA%B2%E5%92%8C%E6%80%A7%E3%80%81Pod%E5%8F%8D%E4%BA%B2%E5%92%8C%E6%80%A7%E5%92%8C%E8%8A%82%E7%82%B9%E4%BA%B2%E5%92%8C%E6%80%A7%E9%A2%84%E8%AE%BE%E9%85%8D%E7%BD%AE%E3%80%82%E4%B8%BA%E6%AD%A4%EF%BC%8C%E8%AE%BE%E7%BD%AE%60podAffinityPreset%60%E3%80%81%60podAntiAffinityPreset%60%E6%88%96%60nodeAffinityPreset%60%E5%8F%82%E6%95%B0%E3%80%82

Prometheus指标

通过将metrics.enabled设为true，本图表可与Prometheus集成。这将在所有Pod中部署带有https://github.com/Lusitaniae/apache_exporter%E7%9A%84sidecar%E5%AE%B9%E5%99%A8%E5%92%8C%60metrics%60%E6%9C%8D%E5%8A%A1%EF%BC%8C%E5%8F%AF%E5%9C%A8%60metrics.service%60%E9%83%A8%E5%88%86%E4%B8%8B%E9%85%8D%E7%BD%AE%E3%80%82%E6%AD%A4%60metrics%60%E6%9C%8D%E5%8A%A1%E5%B0%86%E5%85%B7%E6%9C%89%E5%BF%85%E8%A6%81%E7%9A%84%E6%B3%A8%E8%A7%A3%EF%BC%8C%E4%BB%A5%E8%A2%ABPrometheus%E8%87%AA%E5%8A%A8%E6%8A%93%E5%8F%96%E3%80%82

Prometheus要求

要使集成正常工作，需安装Prometheus或Prometheus Operator。安装https://github.com/bitnami/charts/tree/main/bitnami/prometheus%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E5%8F%AF%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E8%BD%BB%E6%9D%BE%E8%8E%B7%E5%BE%97%E5%8F%AF%E7%94%A8%E7%9A%84Prometheus%E3%80%82

与Prometheus Operator集成

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

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

安装https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%BF%85%E8%A6%81%E7%9A%84CRD%E5%92%8CPrometheus Operator。

参数

全局参数

通用参数

Apache参数

注意：本图表的README超出了DockerHub 25000字符的长度限制，因此已被截断。完整README可在https://github.com/bitnami/charts/blob/main/bitnami/apache/README.md%E6%9F%A5%E7%9C%8B%E3%80%82