Integrations

Dockreg seamlessly integrates with your existing development and monitoring workflows. Whether you’re using standard Docker tools or connecting to your monitoring stack, Dockreg supports straightforward integration without requiring new tools or complex setups.

Docker CLI

Dockreg works directly with the Docker CLI, allowing you to push, pull, and manage images using familiar commands. No additional installations or learning curves are needed.

Quick Start Example

To push your first image to a Dockreg registry:

1. Log in to your registry:

   docker login myapp.registry.dockreg.com

2. Tag your local image:

   docker tag myapp:latest myapp.registry.dockreg.com/myorg/myapp:latest

3. Push the image:

   docker push myapp.registry.dockreg.com/myorg/myapp:latest

For more details on Docker CLI operations, refer to the Docker documentation.

Webhooks for Monitoring

Dockreg supports webhooks to integrate with your existing monitoring and alerting systems. Configure webhooks at the organization or registry level to receive real-time notifications for events like image pushes, pulls, deletions, or vulnerability scan results (beta, available for select users).

Setting Up Webhooks

1. Navigate to your organization’s settings in the Dockreg dashboard.
2. Select “Webhooks” and add a new endpoint URL (e.g., your monitoring service’s ingress point).
3. Choose the events to subscribe to (e.g., image_pushed, image_pulled).
4. Dockreg will send POST requests with JSON payloads containing event details.

Example webhook payload for an image push:

{
  "event": "image_pushed",
  "registry": "myapp.registry.dockreg.com",
  "repository": "myorg/myapp",
  "tag": "latest",
  "digest": "sha256:abc123...",
  "timestamp": "2023-10-01T12:00:00Z"
}

Ensure your endpoint handles HMAC signatures for security. For implementation details, see the webhook configuration guide.

Note: Webhook setup is done via the dashboard at https://dockreg.com/dashboard. Public APIs are forthcoming for more advanced programmatic access.

The Docker CLI and webhook integrations ensure Dockreg fits into your pipeline effortlessly, enhancing security and efficiency without disrupting your workflow.