cleanstart/argocd-extension-installer

Argo CD Extension Installer 镜像文档

概述

Argo CD Extension Installer是一个工具容器，用于管理和安装Argo CD的扩展。Argo CD是Kubernetes的声明式GitOps持续交付工具，此容器提供自动化的Argo CD插件、自定义工具及额外功能模块的安装与配置，同时保持安全与合规标准。

📌 CleanStart基础：安全加固的最小化基础OS，专为企业容器化环境设计。

核心功能

• 自动化Argo CD扩展管理与安装
• 插件生命周期管理与版本控制
• 自定义资源定义（CRD）处理
• 与现有Argo CD部署集成
• 安全加固：非root用户运行，最小***面
• FIPS合规：提供带-fips标签的版本

常见使用场景

• 安装Argo CD自定义可视化插件
• 添加新的应用部署策略
• 集成外部工具和服务与Argo CD
• 通过自定义功能扩展Argo CD原生能力

快速开始

拉取命令

bash
# 拉取镜像
docker pull cleanstart/argocd-extension-installer:latest
docker pull cleanstart/argocd-extension-installer:latest-dev

基本生产部署

标准生产部署，使用推荐设置

bash
docker run \
  -v /path/to/extensions:/extensions \
  -e ARGOCD_SERVER=argocd-server.example.com \
  -e EXTENSION_URL=https://github.com/argoproj-labs/argocd-extension-metrics/releases/download/v1.0.0/extension.tar.gz \
  cleanstart/argocd-extension-installer:latest

扩展将安装到配置的Argo CD实例中

开发/测试

带调试功能的开发环境设置

bash
docker run -it --privileged \
  -e EXTENSION_URL=https://github.com/argoproj-labs/argocd-extension-metrics/releases/download/v1.0.0/extension.tar.gz \
  --entrypoint /bin/sh \
  cleanstart/argocd-extension-installer:latest-dev

docker run -v /path/to/extensions:/extensions \
  -e ARGOCD_SERVER=localhost:8080 \
  -e EXTENSION_URL=https://github.com/argoproj-labs/argocd-extension-metrics/releases/download/v1.0.0/extension.tar.gz \
  -e DEBUG=true \
  cleanstart/argocd-extension-installer:latest-dev

Docker Compose配置

yaml
version: '3.8'

services:
  argocd-extension-installer:
    image: cleanstart/argocd-extension-installer:latest
    container_name: argocd-extension-installer
    restart: unless-stopped
    environment:
      - ARGOCD_SERVER=localhost:8080
      - EXTENSION_URL=https://github.com/argoproj-labs/argocd-extension-metrics/releases/download/v1.0.0/extension.tar.gz
      - DEBUG=true
    volumes:
      - /path/to/extensions:/extensions
      - /path/to/config:/config
    security_opt:
      - no-new-privileges:true
    read_only: true
    tmpfs:
      - /tmp

配置说明

环境变量

命令参数

常用命令行参数示例：

bash
docker run \
  -v /path/to/extensions:/extensions \
  -e EXTENSION_URL=https://github.com/argoproj-labs/argocd-extension-metrics/releases/download/v1.0.0/extension.tar.gz \
  cleanstart/argocd-extension-installer:latest \
  --dry-run --verbose

常用标志

• --dry-run: 模拟安装，不实际修改系统
• --verbose: 启用详细日志
• --skip-verify: 跳过扩展签名验证

安全与最佳实践

推荐安全上下文

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

最佳实践

• 生产环境使用特定镜像标签（避免使用latest）
• 配置资源限制：内存1Gi，CPU 500m
• 启用只读根文件系统
• 定期更新容器镜像
• 验证扩展签名后再安装
• 监控容器指标异常

架构支持

多平台镜像

bash
docker pull --platform linux/amd64 cleanstart/argocd-extension-installer:latest
docker pull --platform linux/arm64 cleanstart/argocd-extension-installer:latest

资源与文档

• CleanStart官网: [***]
• Argo CD扩展安装器官方文档: [***]
• CleanStart社区镜像: https://hub.docker.com/u/cleanstart
• CleanStart镜像运行指南与示例项目: https://github.com/cleanstart-dev/cleanstart-containers
  • 使用Dockerfile运行示例项目
  • 通过Kubernetes YAML部署
  • 从公共镜像迁移到CleanStart镜像

漏洞免责声明

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

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

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