cleanstart/vault-k8s

Vault-K8S容器文档

HashiCorp Vault Kubernetes集成容器，支持原生Kubernetes认证和密钥管理。在Kubernetes集群内提供基于安全身份的Vault资源访问，支持动态密钥、加密即服务和自动证书管理。

📌 基础架构：基于Cleanstart Registry提供的企业级容器环境专用最小化安全加固基础OS。

核心功能

容器的核心能力与优势

• 原生Kubernetes认证与集成
• 自动将密钥注入Kubernetes Pod
• 动态密钥管理与轮换
• 企业级安全与合规特性

常见使用场景

容器适用的典型场景

• Kubernetes密钥管理与分发
• 动态数据库凭证管理
• SSL/TLS证书自动化
• 云凭证与API密钥管理

拉取最新镜像

从仓库下载容器镜像

bash
docker pull cleanstart/vault-k8s:latest

bash
docker pull cleanstart/vault-k8s:latest-dev

基本运行

使用基本配置运行容器

bash
docker run -it --name vault-k8s \
  -e VAULT_ADDR=http://vault:8200 \
  -e VAULT_SKIP_VERIFY=true \
  cleanstart/vault-k8s:latest

生产环境部署

使用生产级安全设置部署

bash
docker run -d --name vault-k8s-prod \
  --read-only \
  --security-opt=no-new-privileges \
  --user 100:100 \
  -e VAULT_ADDR=https://vault:8200 \
  -e VAULT_CACERT=/vault/tls/ca.crt \
  cleanstart/vault-k8s:latest

卷挂载

挂载本地目录用于持久化数据

bash
docker run -v $(pwd)/config:/vault/config \
  -v $(pwd)/tls:/vault/tls \
  cleanstart/vault-k8s:latest

端口转发

使用自定义端口映射运行

bash
docker run -p 8200:8200 cleanstart/vault-k8s:latest

环境变量

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

安全最佳实践

推荐的安全配置和实践

• 生产部署始终使用TLS
• 实施适当的基于角色的访问控制（RBAC）
• 定期轮换Vault令牌和凭证
• 为所有操作启用审计日志
• 为不同环境使用单独的命名空间
• 实施网络策略以限制流量

Kubernetes安全上下文

Kubernetes部署的推荐安全上下文

yaml
securityContext:
  runAsNonRoot: true
  runAsUser: 100
  runAsGroup: 100
  readOnlyRootFilesystem: true
  allowPrivilegeEscalation: false
  capabilities:
    drop: ["ALL"]
  seccompProfile:
    type: RuntimeDefault

多平台镜像

bash
docker pull --platform linux/amd64 cleanstart/vault-k8s:latest
docker pull --platform linux/arm64 cleanstart/vault-k8s:latest

文档资源

重要链接和进一步信息资源

• 容器仓库：[***]
• HashiCorp Vault文档：[***]
• CleanStart社区镜像：https://hub.docker.com/u/cleanstart
• 如何运行CleanStart镜像及示例项目：https://github.com/cleanstart-dev/cleanstart-containers%EF%BC%8C
  • 如何使用Dockerfile运行示例项目
  • 如何通过Kubernetes YAML部署
  • 如何从公共镜像迁移到CleanStart镜像

漏洞免责声明

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

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

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