psprings/grafeas

docker-grafeas

镜像概述和主要用途

docker-grafeas是Grafeas服务器的非官方Docker镜像。Grafeas是一个开源的元数据API服务器，主要用于管理软件供应链中的元数据，包括漏洞信息、构建详情、来源信息等。该镜像提供了便捷的部署方式，可快速启动Grafeas服务并通过环境变量灵活配置。

核心功能和特性

• 多存储后端支持：兼容memstore（内存存储，适用于测试环境）和postgres（PostgreSQL数据库，适用于生产环境）
• 灵活的API配置：可自定义API端点地址、端口及CORS允许的源域名
• PKI支持：可选配置CA文件、密钥文件和证书文件，实现安全通信
• 环境变量驱动配置：通过环境变量直接修改Grafeas的config.yaml配置，无需手动编辑配置文件

使用场景和适用范围

• 本地开发与测试Grafeas API功能
• 搭建软件供应链元数据管理系统
• 与容器镜像扫描工具、CI/CD流水线集成，收集和管理软件构建元数据
• 作为安全合规审计工具的元数据存储后端

使用方法和配置说明

基本运行（默认memstore存储）

使用以下命令启动Grafeas服务器，默认使用内存存储（memstore）：

bash
docker run --name grafeas -p 8080:8080 psprings/grafeas

服务启动后，可通过http://localhost:8080访问Grafeas API。

使用PostgreSQL存储（生产环境）

若需使用PostgreSQL作为持久化存储，需配置相应环境变量。以下是使用Docker Compose部署Grafeas与PostgreSQL的示例：

yaml
version: '3'
services:
  postgres:
    image: postgres:13
    environment:
      POSTGRES_DB: grafeas_db
      POSTGRES_USER: grafeas_user
      POSTGRES_PASSWORD: secure_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - grafeas_network

  grafeas:
    image: psprings/grafeas
    ports:
      - "8080:8080"
    environment:
      GRAFEAS_STORAGE_TYPE: postgres
      GRAFEAS_POSTGRES_HOST: postgres:5432
      GRAFEAS_POSTGRES_DBNAME: grafeas_db
      GRAFEAS_POSTGRES_USER: grafeas_user
      GRAFEAS_POSTGRES_PASSWORD: secure_password
      GRAFEAS_POSTGRES_SSLMODE: disable  # 开发环境可禁用SSL
    depends_on:
      - postgres
    networks:
      - grafeas_network

networks:
  grafeas_network:

volumes:
  postgres_data:

环境变量配置说明

通过以下环境变量可修改Grafeas的config.yaml配置，命名规则基于config.yaml结构，由confd解析：