Files
git.stella-ops.org/docs/features/unimplemented/integrations/registry-webhook-handlers.md
2026-02-13 02:04:55 +02:00

1.6 KiB

Registry Webhook Handlers (Docker/Harbor)

Module

Integrations

Status

NOT_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