Files
git.stella-ops.org/docs/features/unchecked/integrations/built-in-container-registry-connectors.md

2.3 KiB

Built-in Container Registry Connectors (Docker Hub, Harbor, ACR, ECR, GCR, Generic OCI)

Module

Integrations

Status

IMPLEMENTED

Description

Six container registry connectors implemented using raw HTTP clients (no cloud SDKs): Docker Hub with rate limiting, Harbor for self-hosted, ACR with Azure AD token exchange, ECR with AWS SigV4, GCR with JWT/OAuth2, and Generic OCI for any compliant registry. All resolve tags to digests.

Implementation Details

  • Plugin interface: src/Integrations/__Libraries/StellaOps.Integrations.Contracts/IIntegrationConnectorPlugin.cs -- connector plugin contract
  • Harbor connector: src/Integrations/__Plugins/StellaOps.Integrations.Plugin.Harbor/HarborConnectorPlugin.cs -- Harbor self-hosted registry connector
  • Integration models: src/Integrations/__Libraries/StellaOps.Integrations.Core/IntegrationModels.cs -- registry connection models
  • Integration enums: src/Integrations/__Libraries/StellaOps.Integrations.Core/IntegrationEnums.cs -- connector type enums (registry types)
  • Integration core: src/Integrations/__Libraries/StellaOps.Integrations.Core/Integration.cs -- base integration with Vault-type references
  • Plugin loader: src/Integrations/StellaOps.Integrations.WebService/IntegrationPluginLoader.cs -- dynamic plugin loading
  • Integration service: src/Integrations/StellaOps.Integrations.WebService/IntegrationService.cs -- integration lifecycle management
  • Persistence: src/Integrations/__Libraries/StellaOps.Integrations.Persistence/PostgresIntegrationRepository.cs, IIntegrationRepository.cs, IntegrationDbContext.cs
  • In-memory connector: src/Integrations/__Plugins/StellaOps.Integrations.Plugin.InMemory/InMemoryConnectorPlugin.cs -- test connector
  • Tests: src/Integrations/__Tests/StellaOps.Integrations.Tests/IntegrationServiceTests.cs, IntegrationPluginLoaderTests.cs, StellaOps.Integrations.Plugin.Tests/InMemoryConnectorPluginTests.cs
  • Source: SPRINT_20260110_102_004_INTHUB_registry_connectors.md

E2E Test Plan

  • Verify Harbor connector resolves tags to digests
  • Test plugin loader discovers and loads registry connector plugins
  • Verify integration service manages connector lifecycle
  • Test PostgreSQL persistence stores integration configurations
  • Verify connector handles authentication for each registry type