Bitnami HashiCorp Vault CSI Provider 镜像文档

镜像概述和主要用途

Bitnami HashiCorp Vault CSI Provider镜像是Bitnami Secure Images计划下的安全容器镜像，用于部署HashiCorp Vault CSI Provider。该工具通过集成HashiCorp Vault与Kubernetes的Secrets Store CSI驱动接口，使Kubernetes Pod能够安全地访问和管理Vault中的密钥，实现密钥的安全注入和生命周期管理。

核心功能和特性

HashiCorp Vault CSI Provider 功能

• 与Kubernetes Secrets Store CSI驱动无缝集成，支持密钥通过CSI接口注入Pod
• 安全管理Vault中的密钥，实现Pod级别的密钥访问控制
• 符合Kubernetes CSI规范，兼容标准CSI驱动部署流程

Bitnami安全镜像特性

• 安全加固：基于Photon Linux最小化操作系统，减少***面
• CVE透明度：通过VEX/KEV标准提供漏洞可利用性信息，附EPSS风险评分
• 供应链安全：提供SBOM（软件物料清单）、签名验证（Notation）和病毒扫描报告
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全性
• 跨格式一致性：与Bitnami虚拟机、云镜像使用相同组件和配置，便于多环境切换

使用场景和适用范围

• Kubernetes环境中需要安全管理密钥的Pod部署
• 开发环境中集成Vault进行密钥管理的测试和验证
• 生产环境中需要最小***面和合规性的密钥注入场景
• 需满足供应链安全要求（如SLSA-3合规）的企业级部署

快速开始

console
docker run -it --name vault-csi-provider bitnami/vault-csi-provider

重要通知：Bitnami Catalog即将变更

自2025年8月28日起，Bitnami将升级其公共镜像目录，推出基于Bitnami Secure Images计划的精选安全加固镜像。变更要点：

• 社区用户首次可访问安全优化版本的容器镜像
• 免费 tier 将逐步弃用非加固的Debian基础镜像，仅保留"latest"标签的加固镜像（用于开发目的）
• 所有现有镜像（包括历史版本标签，如2.50.0、10.6）将在两周内迁移至docker.io/bitnamilegacy仓库，不再接收更新
• 生产环境建议采用Bitnami Secure Images，包含加固容器、CVE透明度、企业支持等特性

更多详情请查看Bitnami Secure Images公告。

支持的标签和Dockerfile链接

Bitnami镜像采用滚动标签和不可变标签策略，详情参见标签策略文档。不同标签的对应关系可查看分支目录下的tags-info.yaml文件（如bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）。

订阅bitnami/containers GitHub仓库获取更新通知。

获取镜像

推荐方式：拉取预构建镜像

从Docker Hub拉取最新版：

console
docker pull bitnami/vault-csi-provider:latest

拉取特定版本（查看可用版本）：

console
docker pull bitnami/vault-csi-provider:[TAG]

手动构建镜像

console
git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM  # 替换为实际路径
docker build -t bitnami/APP:latest .

维护与升级

升级镜像

步骤1：获取更新镜像

console
docker pull bitnami/vault-csi-provider:latest

步骤2：移除当前运行容器

console
docker rm -v vault-csi-provider

步骤3：运行新镜像

console
docker run --name vault-csi-provider bitnami/vault-csi-provider:latest

配置说明

运行命令

执行容器内命令（如查看帮助）：

console
docker run --rm --name vault-csi-provider bitnami/vault-csi-provider:latest --help

更多使用方法参见***文档。

FIPS配置

Bitnami Secure Images支持FIPS模式配置，通过环境变量控制：

• OPENSSL_FIPS：是否启用OpenSSL FIPS模式，可选值：yes（默认）、no

重要变更

2024年1月16日起

• 移除docker-compose.yaml文件，该文件仅用于内部测试。

贡献与反馈

• 提交新功能需求或贡献代码：GitHub Issues 或 Pull Requests
• 运行容器时遇到问题：提交Issue（请按模板填写信息）

许可证

Copyright © 2025 Broadcom。"Broadcom"指代Broadcom Inc.及其子公司。

本软件基于Apache License 2.0许可发布，详情参见：<[***]>

除非***要求或书面同意，软件按"原样"分发，不提供任何明示或暗示的担保。