cleanstart/metallb-controller

Metallb-Controller 容器文档

镜像概述

MetalLB控制器容器为裸金属Kubernetes集群提供基于Layer 2和BGP的负载均衡功能，使无云提供商集成的环境能够使用Load***服务类型，提供企业级网络负载均衡能力，具备高可用性和自动故障转移特性。

基础架构：基于Cleanstart Registry提供的安全加固、最小化基础OS，专为企业容器化环境设计。

镜像路径：Cleanstart/metallb-controller
仓库：Cleanstart Registry

核心功能

容器的核心能力与优势：

• 支持Layer 2和BGP模式的网络负载均衡
• 自动IP地址管理与分配
• 具备领导者选举的高可用配置
• 原生Kubernetes Load***服务集成

使用场景

容器的典型应用场景：

• 裸金属Kubernetes集群负载均衡
• 本地数据中心服务暴露
• 边缘计算网络管理
• 多集群服务负载均衡

使用方法

拉取最新镜像

从仓库下载容器镜像：

bash
docker pull docker.xuanyuan.run/Cleanstart/metallb-controller:latest

开发版本：

bash
docker pull docker.xuanyuan.run/Cleanstart/metallb-controller:latest-dev

基本运行

使用基础配置运行容器：

bash
docker run -it --name metallb-controller-test docker.xuanyuan.run/Cleanstart/metallb-controller:latest-dev

生产部署

使用生产级安全设置部署：

bash
docker run -d --name metallb-controller-prod \
  --read-only \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  docker.xuanyuan.run/Cleanstart/metallb-controller:latest

卷挂载

挂载本地目录以持久化数据：

bash
docker run -v $(pwd)/config:/etc/metallb docker.xuanyuan.run/Cleanstart/metallb-controller:latest

端口转发

使用自定义端口映射运行：

bash
docker run -p 7472:7472 docker.xuanyuan.run/Cleanstart/metallb-controller:latest

环境变量

通过环境变量进行配置的选项：

安全最佳实践

推荐的安全配置与实践：

• 使用RBAC策略限制控制器权限
• 启用网络策略进行控制器访问控制
• 使用BGP模式时配置安全BGP认证
• 实施适当的IP地址池分段
• 定期对MetalLB配置进行安全审计
• 监控控制器日志以发现安全事件
• 对指标端点通信使用TLS
• 实施Pod安全策略

Kubernetes安全上下文

Kubernetes部署推荐的安全上下文：

yaml
securityContext:
  runAsNonRoot: true
  runAsUser: 65534
  runAsGroup: 65534
  readOnlyRootFilesystem: true
  allowPrivilegeEscalation: false
  capabilities:
    drop: ["ALL"]
    add: ["NET_ADMIN", "NET_RAW"]

文档资源

重要链接与参考资源：

• 容器仓库：[***]
• MetalLB官方文档：[***]
• CleanStart社区镜像：https://hub.docker.com/u/cleanstart
• CleanStart镜像使用指南及示例项目：https://github.com/cleanstart-dev/cleanstart-containers
  • 使用Dockerfile运行示例项目
  • 通过Kubernetes YAML部署
  • 从公共镜像迁移到CleanStart镜像

漏洞声明

CleanStart提供的Docker镜像包含由独立贡献者维护的第三方开源库和软件包。尽管CleanStart维护这些镜像并应用行业标准安全实践，但无法保证超出其控制范围的上游组件的安全性或完整性。

用户确认并同意，开源软件可能包含未发现的漏洞或通过更新引入新风险。CleanStart不对源自第三方库的安全问题负责，包括但不限于零日漏洞、供应链***或贡献者引入的风险。

安全是共同责任：CleanStart在可能的情况下提供更新的镜像和指导，而用户负责评估部署并实施适当的控制措施。