Bitnami MetalLB 软件包

MetalLB是裸金属Kubernetes集群的负载均衡器实现，使用标准路由协议。

MetalLB概述

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

快速入门

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

希望在生产环境中使用MetalLB？请尝试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用户的安全态势。更多详情，请访问Bitnami Secure Images公告。

介绍

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

此Chart使用Helm包管理器在Kubernetes集群上引导MetalLB Controller部署和MetalLB Speaker守护进程集。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• Layer 2所需的虚拟IP或BGP设置所需的Route Reflector。

安装Chart

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

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/metallb

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

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

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

配置和安装详情

资源请求和限制

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

为简化此过程，Chart包含resourcesPreset值，可根据不同预设自动设置resources部分。可在bitnami/common chart中查看这些预设。但在生产工作负载中，不建议使用resourcesPreset，因其可能无法完全适应具体需求。有关容器资源管理的更多信息，请参阅Kubernetes官方文档。

Prometheus指标

通过将*.metrics.enabled（在controller、speaker和speaker.frr部分下）设置为true，可将此Chart与Prometheus集成。这将在容器和服务中暴露MetalLB原生Prometheus端口，服务还将包含必要的注解以被Prometheus自动抓取。

Prometheus要求

集成需确保集群中已安装Prometheus或Prometheus Operator。可安装Bitnami Prometheus helm chart或Bitnami Kube Prometheus helm chart以快速获得可用的Prometheus。

与Prometheus Operator集成

通过设置*.metrics.serviceMonitor.enabled=true（在controller、speaker和speaker.frr部分下），Chart可部署ServiceMonitor对象以与Prometheus Operator集成。需确保集群中已安装Prometheus Operator的自定义资源定义（CRD），否则将失败并显示以下错误：

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

安装Bitnami Kube Prometheus helm chart以获取必要的CRD和Prometheus Operator。

滚动标签与不可变标签

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

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

要配置MetalLB，请参阅配置部分MetalLB配置。

备份和恢复

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

分配给Load***配置的IP地址示例

# address-pools列出MetalLB允许分配的IP地址。可根据需要创建多个地址池。
apiVersion: metallb.io/v1beta1
kind: IPAddressPool
metadata:
  # 地址池名称。服务可使用此名称请求从特定地址池分配。
  name: first-pool
  namespace: metallb-system
spec:
  # MetalLB有权限管理的IP地址范围列表。可在单个池中列出多个范围，它们将共享相同的设置。每个范围可以是CIDR前缀或显式的IP起止范围。
  addresses:
  - 192.168.10.0/24
  - 192.168.9.1-192.168.9.5
  - fc00:f853:0ccd:e799::/124

参数

全局参数

通用参数

MetalLB参数

Controller参数

注意：此Chart的README超出DockerHub 25000字符限制，已被截断。完整README可在[***]