cleanstart/step-cli

Step-Cli容器文档

Step CLI是一款用于自动化证书管理、PKI操作和OAuth工作流的命令行工具。本容器提供安全、企业级的环境，适用于容器化部署中的自动化证书生命周期管理、身份配置和加密操作。

📌 基础架构：基于Cleanstart Registry提供的安全强化、精简基础OS，专为企业容器化环境设计。

核心功能

容器的核心能力与优势

• 自动化X.509证书管理
• OAuth OIDC自动化与工作流
• 零信任安全架构支持
• 集成PKI操作与工具

常见使用场景

容器表现出色的典型场景

• 自动化证书生命周期管理
• PKI基础设施自动化
• OAuth/OIDC集成工作流
• 零信任安全实施

拉取最新镜像

从仓库下载容器镜像

bash
docker pull cleanstart/step-cli:latest

bash
docker pull cleanstart/step-cli:latest-dev

基本运行

使用基本配置运行容器

bash
docker run -it --name step-cli-test cleanstart/step-cli:latest-dev

生产环境部署

使用生产环境安全设置部署

bash
docker run -d --name step-cli-prod \
  --read-only \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  cleanstart/step-cli:latest

卷挂载

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

bash
docker run -v $(pwd)/certs:/home/step/certs cleanstart/step-cli:latest

端口转发

使用自定义端口映射运行

bash
docker run -p 9000:9000 cleanstart/step-cli:latest

环境变量

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

安全最佳实践

推荐的安全配置与实践

• 生产部署使用特定镜像标签
• 实施适当的证书存储安全措施
• 启用只读文件系统访问
• 以非root用户运行
• 保护敏感环境变量
• 定期进行安全更新与补丁
• 实施适当的访问控制
• 监控证书生命周期事件

Kubernetes安全上下文

Kubernetes部署的推荐安全上下文

yaml
securityContext:
  runAsNonRoot: true
  runAsUser: 1000
  runAsGroup: 1000
  readOnlyRootFilesystem: true
  allowPrivilegeEscalation: false
  capabilities:
    drop: ["ALL"]

文档资源

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

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

漏洞免责声明

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

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

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