4. 安装与配置环境：安装 Cosign CLI、配置环境变量、验证安装

在开始使用 Sigstore 进行配置准入证据之前，必须正确安装 Cosign CLI 并配置好运行环境。Cosign 是 Sigstore 生态中最核心的客户端工具，负责签名、验证和存储操作。本章将指导你完成从下载安装到环境验证的全过程。

4.1 安装 Cosign CLI

Cosign 支持多平台安装，包括 Linux、macOS 和 Windows。根据你的操作系统选择以下一种方式：

curl -O https://github.com/sigstore/cosign/releases/latest/download/cosign-linux-amd64
sudo mv cosign-linux-amd64 /usr/local/bin/cosign
sudo chmod +x /usr/local/bin/cosign

brew install cosign

curl -O https://github.com/sigstore/cosign/releases/latest/download/cosign-darwin-arm64
sudo mv cosign-darwin-arm64 /usr/local/bin/cosign
sudo chmod +x /usr/local/bin/cosign

# 使用 PowerShell 下载
Invoke-WebRequest -Uri "https://github.com/sigstore/cosign/releases/latest/download/cosign-windows-amd64.exe" -OutFile "cosign.exe"
# 将 cosign.exe 添加到 PATH 环境变量

4.2 配置环境变量

安装完成后，需要配置以下关键环境变量，以确保 Cosign 能够正确与 Sigstore 基础设施通信：

• COSIGN_PASSWORD：用于保护私钥的密码（如果使用密钥对模式）。
• SIGSTORE_REKOR_URL：Rekor 透明日志的地址，默认值为 https://rekor.sigstore.dev。
• SIGSTORE_OIDC_ISSUER：OIDC 身份提供者，默认值为 https://oauth2.sigstore.dev/auth。
• COSIGN_EXPERIMENTAL：启用实验性功能（如密钥less 模式），建议设置为 1。

在 Linux/macOS 的 ~/.bashrc 或 ~/.zshrc 中添加以下内容：

# Cosign 环境变量配置
export COSIGN_PASSWORD="your-strong-password-here"
export SIGSTORE_REKOR_URL="https://rekor.sigstore.dev"
export SIGSTORE_OIDC_ISSUER="https://oauth2.sigstore.dev/auth"
export COSIGN_EXPERIMENTAL=1

执行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

4.3 验证安装

完成安装和环境配置后，执行以下命令验证 Cosign 是否正常工作：

# 检查版本信息
cosign version

# 查看帮助文档
cosign help

# 测试签名流程（使用内置测试密钥）
cosign generate-key-pair

# 验证环境变量是否生效
echo $COSIGN_PASSWORD
echo $SIGSTORE_REKOR_URL

如果 cosign version 正确输出版本号、Git 提交和构建时间，则说明安装成功。以下是一个典型的输出示例：

  ______   ______        ______   ______   ______   ______
 /      \ /      \      /      \ /      \ /      \ /      \
|  C O  | |  S I  |    |  G N  | |  S T  | |  O R  | |  E   |
 \______/ \______/      \______/ \______/ \______/ \______/
cosign: 2.2.3
GitVersion:    v2.2.3
GitCommit:     abc123def456
BuildDate:     2024-01-15T10:30:00Z

4.4 安装验证流程图

下图展示了从下载 Cosign 到验证完成的完整流程，帮助你理解每一步的依赖关系：

4.5 常见问题排查

安装过程中可能遇到以下问题，请对照排查：