dwpdigital/cert-retriever

ACM证书获取Docker镜像

概述

本Docker镜像专为在不同环境中获取所有AWS Certificate Manager (ACM)证书而设计，旨在简化跨环境证书管理流程，提供自动化的证书信息检索与整合能力。

核心功能与特性

• 跨环境支持：兼容开发、测试、生产等多种AWS环境的证书获取
• 自动化检索：自动获取指定环境中的所有ACM证书信息，无需手动操作
• 全面信息整合：汇总证书关键信息，包括ARN、域名、状态、到期时间及主题备用名称等
• 灵活筛选：支持按证书状态（如ISSUED、EXPIRED等）进行筛选
• 多格式输出：支持JSON、XML、文本等多种输出格式，便于集成到不同系统
• 轻量级设计：基于精简基础镜像构建，资源占用低，部署便捷

使用场景

• 多环境ACM证书集中管理与监控
• 证书到期自动提醒系统构建
• 证书合规性审计与报告生成
• CI/CD流程中证书信息自动集成
• 跨区域证书统一管理

使用方法

前提条件

• 已安装Docker引擎
• 拥有具备ACM访问权限的AWS账号（需至少包含acm:ListCertificates和acm:DescribeCertificate权限）
• AWS凭证配置（可通过环境变量、AWS配置文件或IAM角色）

基本使用（docker run）

bash
docker run -e AWS_REGION=us-east-1 -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE -e AWS_SECRET_ACCESS_KEY=secret acm-cert-fetcher:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  acm-cert-fetcher:
    image: acm-cert-fetcher:latest
    environment:
      - AWS_REGION=us-west-2
      - OUTPUT_FORMAT=text
      - FILTER_STATUS=ISSUED
      - MAX_RESULTS=50
    volumes:
      - ~/.aws/credentials:/root/.aws/credentials:ro  # 挂载本地AWS凭证文件

输出示例

JSON格式输出：

json
{
  "certificates": [
    {
      "arn": "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012",
      "domainName": "example.com",
      "status": "ISSUED",
      "notBefore": "2023-01-01T00:00:00Z",
      "notAfter": "2024-01-01T23:59:59Z",
      "subjectAlternativeNames": ["example.com", "www.example.com", "api.example.com"]
    }
  ]
}

文本格式输出：

Certificate ARN: arn:aws:acm:us-east-1:123456789012:certificate/***-1234-1234-1234-123456789012
Domain: example.com
Status: ISSUED
Valid From: 2023-01-01T00:00:00Z
Valid To: 2024-01-01T23:59:59Z
Subject Alternative Names: example.com, [***] api.example.com