bitphy/argo-cron

ArgoCron

ArgoCron是一个轻量Pod，通过Kubernetes CronJobs触发Argo Workflows，可作为Argo Events日历系统的替代方案，简化定时工作流的管理流程。

镜像概述

ArgoCron专注于解决Argo Workflows的定时触发需求，相比Argo Events具有部署配置更简洁、支持Kubernetes原生并发控制、自动清理旧资源等优势，适合轻量级定时工作流场景。

核心功能

• 简化部署与配置：无需复杂的Argo Events组件依赖
• 并发控制：通过Kubernetes的concurrencyPolicy禁止并发运行
• 资源清理：启动新Workflow前自动删除指定时间前的旧Workflow Pods
• Git集成：克隆指定仓库与分支，提交预设的Workflow文件

使用场景

• 需要定时执行Argo Workflows的Kubernetes集群
• 希望替代Argo Events实现轻量定时触发的场景
• 需要自动清理旧Workflow资源以优化集群资源的环境

配置说明

前提条件

已在Kubernetes集群中安装Argo（参考https://github.com/argoproj/argo/blob/master/demo.md%EF%BC%89

使用步骤

1. 创建包含Workflow文件的Git仓库
2. 下载并配置https://github.com/bitphy/argo-cron/blob/master/argo.cronjob.yaml%EF%BC%9A
   • 设置Git仓库的SSH密钥Secret
   • 设置known_hosts Secret（用于验证Git服务器身份）
   • 指定仓库中的Workflow文件名
3. 生成known_hosts指纹：使用ssh-keyscan github.com或ssh-keyscan bitbucket.com获取对应Git服务器的指纹
4. 将容器参数设置为Workflow文件的名称

环境变量

• NAMESPACE（默认：default）：Workflow运行的Kubernetes命名空间
• OLDER（默认：5d）：清理指定时间前的旧Workflow记录（例如3d表示3天前）
• GIT_BRANCH（默认：master）：需要检出的Git分支

部署示例

以下是ArgoCron作为Kubernetes CronJob的部署示例：

yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: argo-cron-demo
spec:
  schedule: "0 0 * * *" # 每天凌晨执行
  concurrencyPolicy: Forbid
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: argo-cron
            image: bitphy/argo-cron
            args: ["daily-workflow.yaml"]
            env:
            - name: NAMESPACE
              value: "argo-workflows"
            - name: OLDER
              value: "7d"
            - name: GIT_BRANCH
              value: "main"
            volumeMounts:
            - name: git-ssh-key
              mountPath: /root/.ssh/id_rsa
              subPath: id_rsa
            - name: git-known-hosts
              mountPath: /root/.ssh/known_hosts
              subPath: known_hosts
          volumes:
          - name: git-ssh-key
            secret:
              secretName: git-repo-ssh-key
          - name: git-known-hosts
            secret:
              secretName: git-known-hosts
          restartPolicy: OnFailure

贡献指南

请参考https://gist.github.com/PurpleBooth/b24679402957c63ec426%E4%BA%86%E8%A7%A3%E4%BB%A3%E7%A0%81%E8%A7%84%E8%8C%83%E4%B8%8EPR%E6%8F%90%E4%BA%A4%E6%B5%81%E7%A8%8B%E3%80%82

版本控制

采用SemVer进行版本管理，可通过https://github.com/bitphy/argo-cron/tags%E6%9F%A5%E7%9C%8B%E5%8F%AF%E7%94%A8%E7%89%88%E6%9C%AC%E3%80%82

作者

• Erik Berdonces - 初始开发 - BitPhy

许可证

本项目基于MIT许可证发布，详情见LICENSE.md。

致谢

• BitPhy团队
• Argo项目社区