bitnami/vault-k8s

Bitnami HashiCorp Vault K8s Integration 镜像

镜像概述与主要用途

HashiCorp Vault K8s Integration 是 HashiCorp Vault 与 Kubernetes API 交互的工具组件。Vault 是一款用于安全管理和访问密钥（如密码、证书、API 密钥）的工具，而该集成组件允许 Vault 与 Kubernetes 集群进行通信，实现基于 Kubernetes 的认证、密钥注入等功能。Bitnami 镜像提供了该集成组件的容器化版本，简化部署与管理流程。

https://github.com/hashicorp/vault-k8s

商标说明：本软件列表由 Bitnami 打包。所提及的商标分属各自公司所有，使用此类商标不意味着任何关联或背书。

核心功能与特性

集成工具特性

• 支持 Vault 与 Kubernetes API 交互，实现 Kubernetes 环境下的 Vault 集成场景（如 Pod 认证、密钥自动注入）。

Bitnami 镜像特性

• 安全强化：基于 Bitnami Secure Images 标准构建，包含硬化容器、最小化***面、CVE 透明度（通过 VEX/KEV 标准）。
• FIPS 支持：可配置 OpenSSL FIPS 模式，满足安全合规需求。
• 最小化操作系统：采用 Photon Linux 作为基础镜像，减少***面的同时保持扩展性。
• 供应链安全：提供软件物料清单（SBOM）、病毒扫描报告、SLSA-3 合规的构建元数据及签名验证（Notation）。
• 配置一致性：与 Bitnami 虚拟机、云镜像使用相同组件和配置方式，便于跨格式迁移。

使用场景与适用范围

适用于在 Kubernetes 集群中部署和使用 HashiCorp Vault 的场景，具体包括：

• Kubernetes Pod 通过 Vault 进行身份认证。
• 基于 Kubernetes 角色的 Vault 访问控制。
• 密钥（如数据库凭证、TLS 证书）从 Vault 自动注入到 Kubernetes Pod。
• 开发环境中快速验证 Vault 与 Kubernetes 集成功能。

获取镜像

推荐通过 Docker Hub 拉取预构建镜像：

console
docker pull bitnami/vault-k8s:latest

如需指定版本，可使用标签（参考 支持的标签）：

console
docker pull bitnami/vault-k8s:[TAG]

也可手动构建镜像（需替换 APP、VERSION、OPERATING-SYSTEM 占位符）：

console
git clone https://github.com/bitnami/containers.git
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

使用方法

快速启动 (TL;DR)

console
docker run -it --name vault-k8s bitnami/vault-k8s

运行容器

启动容器并保持交互模式：

console
docker run -it --name vault-k8s bitnami/vault-k8s:latest

执行命令

在容器内执行 vault-k8s 命令（如查看帮助）：

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

更多命令用法参考 https://github.com/hashicorp/vault-k8s%E3%80%82

配置说明

FIPS 配置

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

• OPENSSL_FIPS：是否启用 OpenSSL FIPS 模式。
  取值：yes（默认）、no。

示例：禁用 FIPS 模式启动容器：

console
docker run -it --name vault-k8s -e OPENSSL_FIPS=no bitnami/vault-k8s:latest

维护与升级

升级镜像

1. 拉取最新镜像：

   console
   docker pull bitnami/vault-k8s:latest
   

2. 停止并删除当前容器：

   console
   docker rm -v vault-k8s
   

3. 使用新镜像重建容器：

   console
   docker run --name vault-k8s bitnami/vault-k8s:latest
   

支持的标签

Bitnami 镜像标签遵循 滚动标签与不可变标签策略。可在 https://hub.docker.com/r/bitnami/vault-k8s/tags/ 查看所有可用标签。

标签信息（如版本对应关系）可通过 tags-info.yaml 文件查看，路径为 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml（需替换占位符）。

重要通知：Bitnami 镜像目录变更

自 2025 年 8 月 28 日起，Bitnami 将调整公共镜像目录，推出 Bitnami Secure Images 计划，主要变更包括：

• 镜像迁移：现有所有镜像（含历史版本标签，如 2.50.0、10.6）将在两周内从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy，且不再更新。
• 免费版镜像调整：免费用户仅可访问少量硬化镜像（仅 latest 标签），适用于开发环境；非硬化 Debian 镜像将逐步弃用。
• 生产环境推荐：生产环境建议使用 Bitnami Secure Images，包含硬化容器、CVE 透明度、SBOM、企业支持等特性。

详情见 https://github.com/bitnami/containers/issues/83267%E3%80%82

问题与贡献

• 问题反馈：如运行容器时遇到问题，可通过 https://github.com/bitnami/containers/issues/new/choose 提交。
• 贡献：欢迎通过 https://github.com/bitnami/containers/pulls 贡献代码或改进建议。

许可

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

本镜像基于 Apache License 2.0 许可发布。详情见 Apache License 2.0。