27 lines
1.6 KiB
Markdown
27 lines
1.6 KiB
Markdown
# 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
|