banzaicloud/vault-operator

Bank-Vaults 镜像文档

镜像概述和主要用途

Bank-Vaults是一个伞形项目，提供多种工具以简化Hashicorp Vault的使用和操作。作为Banzai Cloud Pipeline平台的核心组件，它旨在解决Vault在实际应用中的各类挑战，包括客户端集成、Kubernetes环境适配、密钥管理自动化等。该项目可独立使用，提供CLI工具、Golang库、Helm chart、Kubernetes operator及mutating webhook等，适用于需要安全管理密钥和凭证的各类场景。

核心功能和特性

• Vault客户端包装器：基于官方Vault客户端，支持自动令牌续期，内置Kubernetes认证集成
• 动态数据库凭证提供器：为Golang database/sql客户端提供动态数据库凭证管理
• CLI工具：支持Vault的自动初始化、 unseal（解封）和配置
• Kubernetes Operator：用于Vault实例的自动化部署和管理
• Mutating Webhook：在Kubernetes环境中实现密钥的动态注入
• 多环境支持：适用于单节点和高可用（HA）Vault集群，支持多数据中心复制

使用场景和适用范围

• Kubernetes环境中的Vault部署：通过operator和webhook实现Vault的自动化管理和密钥注入
• 动态密钥管理：为数据库、SSH等服务提供动态生成和轮换的凭证
• 安全的密钥注入：将Vault中的密钥直接注入Kubernetes Pod，避免密钥明文存储
• 多数据中心Vault复制：支持跨多个数据中心的Vault实例复制，确保高可用性
• Vault监控与备份：集成云原生监控工具（如Grafana），支持通过Velero进行备份

使用方法和配置说明

安装方式

通常无需直接使用CLI，建议通过Helm chart安装相关组件，创建Vault实例并使用webhook在Kubernetes中进行资源转换。如需获取bank-vaults和vault-env CLI二进制文件，可从https://github.com/banzaicloud/bank-vaults/releases%E4%B8%8B%E8%BD%BD%E3%80%82

Kubernetes部署示例

使用Helm安装Vault Operator

bash
# 添加Helm仓库
helm repo add banzaicloud-stable https://kubernetes-charts.banzaicloud.com
helm repo update

# 安装Vault Operator
helm install vault-operator banzaicloud-stable/vault-operator

创建Vault实例

创建自定义资源（CR）以部署Vault集群：

yaml
apiVersion: vault.banzaicloud.com/v1alpha1
kind: Vault
metadata:
  name: vault
spec:
  size: 3
  image: vault:1.11.0
  bankVaultsImage: banzaicloud/bank-vaults:latest
  # 配置存储、认证等参数
  storage:
    raft:
      path: /vault/data
  serviceAccount:
    create: true

应用配置：

bash
kubectl apply -f vault-cr.yaml

核心配置参数

支持与许可

社区支持

• 文档：详细文档
• 问题反馈：https://github.com/banzaicloud/bank-vaults/issues
• Slack交流：Banzai Cloud Slack #Bank-Vaults频道

商业支持

如需生产环境中的商业支持，可联系Banzai Cloud。

许可

Bank-Vaults基于Apache License 2.0许可发布，详细许可信息见LICENSE。