Back to Spring Ai

Ecosystem CI Dashboard

src/ecosystem-ci/README.md

2.0.0-M42.2 KB
Original Source

Ecosystem CI Dashboard

This directory contains the configuration for the Spring AI Ecosystem CI Dashboard, which monitors the CI health of key ecosystem dependencies.

Overview

The dashboard workflow runs daily and:

  1. Queries CI status for each monitored repository
  2. Updates the Wiki Dashboard with current status
  3. Posts alerts to Issue #5334 when dependencies fail for extended periods

Subscribing to Alerts

To receive notifications when ecosystem dependencies fail CI:

  1. Go to Issue #5334
  2. Click Subscribe in the right sidebar
  3. You'll receive GitHub notifications when alerts are posted

Alert Policy

ConditionAction
Dependency fails (day 1)Dashboard updated, no alert
Dependency fails for 2+ daysAlert comment posted (triggers notification)
Dependency recoversDashboard updated, no alert

The alert_after_days setting in ci-alert-config.json controls the threshold (default: 2 days).

Adding or Removing Dependencies

Edit ci-alert-config.json:

json
{
  "dependencies": [
    { "owner": "org-name", "repo": "repo-name" },
    ...
  ]
}

Each dependency must have:

  • owner: GitHub organization or user
  • repo: Repository name

The workflow monitors the branch specified by tracked_branch (default: main).

Configuration Reference

FieldDescriptionDefault
issue_numberGitHub issue for dashboard and alerts5334
tracked_branchBranch to monitor for each repomain
alert_after_daysDays of failure before alerting2
heartbeat_daysMinimum days between repeat alerts1

Manual Trigger

To run the dashboard manually:

  1. Go to Actions > Ecosystem CI Dashboard
  2. Click Run workflow
  3. Select the main branch and click Run workflow

Files

  • ci-alert-config.json - Dashboard configuration
  • ../../.github/workflows/dependency-ci-dashboard.yml - GitHub Actions workflow