stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
cf5b72974f923126944f4dcd47e85864ebb31a3b
git.stella-ops.org/docs/features/unchecked/integrations/registry-webhook-handlers.md

1.6 KiB
Raw Blame History

Registry Webhook Handlers (Docker/Harbor)

Module

Integrations

Status

IMPLEMENTED

Description

Webhook handlers for Docker Registry v2 and Harbor image-push events that trigger async gate evaluation. Accepts webhook payloads at /api/v1/webhooks/registry/* and queues gate evaluation jobs via an in-memory Channel-based queue with a background worker.

Implementation Details

  • API endpoints: src/Integrations/StellaOps.Integrations.WebService/IntegrationEndpoints.cs -- webhook receiver at /api/v1/webhooks/registry/*
  • Integration service: src/Integrations/StellaOps.Integrations.WebService/IntegrationService.cs -- processes webhook payloads and queues gate evaluation
  • Harbor plugin: src/Integrations/__Plugins/StellaOps.Integrations.Plugin.Harbor/HarborConnectorPlugin.cs -- Harbor-specific webhook handling
  • GitHub App plugin: src/Integrations/__Plugins/StellaOps.Integrations.Plugin.GitHubApp/GitHubAppConnectorPlugin.cs -- GitHub webhook processing
  • Integration DTOs: src/Integrations/__Libraries/StellaOps.Integrations.Contracts/IntegrationDtos.cs -- webhook payload models
  • WebService program: src/Integrations/StellaOps.Integrations.WebService/Program.cs -- webhook endpoint registration
  • Source: SPRINT_20251226_001_BE_cicd_gate_integration.md

E2E Test Plan

  • Verify Docker Registry v2 webhook payloads are accepted
  • Test Harbor image-push webhook triggers gate evaluation
  • Verify Channel-based queue processes jobs asynchronously
  • Test webhook authentication validates payload signatures
  • Verify gate evaluation job queuing under load