feat(docker): Add support for multiple registries #657

BYK · 2025-12-10T00:00:32Z

Summary

Extend the Docker target to support publishing to multiple container registries (Docker Hub, GHCR, GCR, etc.) with per-registry credentials, including cross-registry publishing from private sources.

Key Changes

Multi-Registry Support

Auto-detect registry from image paths (e.g., ghcr.io/user/image → ghcr.io)
Per-registry credentials via DOCKER_<REGISTRY>_USERNAME/PASSWORD env vars
Built-in GHCR defaults using GITHUB_ACTOR/GITHUB_TOKEN for zero-config in GitHub Actions
Registry override to share credentials across regional registries
Treat docker.io, index.docker.io, registry-1.docker.io as Docker Hub aliases

Cross-Registry Publishing

Source registry authentication for pulling from private registries
Login to both source and target registries when credentials are available
If no source credentials found, assumes source is public

New Nested Object Config Format

Both source and target now support string or object format:

# String shorthand
source: ghcr.io/org/image
target: getsentry/craft

# Object format with options
source:
  image: ghcr.io/org/image
  registry: ghcr.io
  format: "{{{source}}}:sha-{{{revision}}}"
  usernameVar: MY_SOURCE_USER
  passwordVar: MY_SOURCE_PASS
target:
  image: us.gcr.io/project/image
  registry: gcr.io  # Share creds across regions

Security Improvements

Secure password handling using --password-stdin

Example Configurations

Cross-registry publishing:

targets:
  - name: docker
    source:
      image: ghcr.io/myorg/private-image
      usernameVar: GHCR_USER
      passwordVar: GHCR_PASS
    target: getsentry/craft

Multi-registry publishing:

targets:
  # Docker Hub
  - name: docker
    source: ghcr.io/getsentry/craft
    target: getsentry/craft

  # GHCR (zero-config in GitHub Actions)
  - name: docker
    source: ghcr.io/getsentry/craft
    target: ghcr.io/getsentry/craft

  # GCR with shared regional credentials  
  - name: docker
    source: ghcr.io/getsentry/craft
    target:
      image: us.gcr.io/project/image
      registry: gcr.io

Closes #591

Extend the Docker target to support publishing to multiple container registries (Docker Hub, GHCR, GCR, etc.) with per-registry credentials. Key changes: - Auto-detect registry from target image path (e.g., ghcr.io/user/image) - Per-registry credentials via DOCKER_<REGISTRY>_USERNAME/PASSWORD env vars - Built-in GHCR defaults using GITHUB_ACTOR/GITHUB_TOKEN for zero-config in GitHub Actions - Optional registry config override to share credentials across regions - Optional usernameVar/passwordVar for explicit env var names (no fallback) - Use --password-stdin for secure password handling Closes #591

README.md

Recognize docker.io, index.docker.io, and registry-1.docker.io as Docker Hub aliases that should use default DOCKER_USERNAME/PASSWORD credentials instead of looking for DOCKER_DOCKER_IO_* env vars.

…ublishing When source and target registries differ, credentials can now be resolved independently for each registry. This enables cross-registry publishing (e.g., pulling from private GHCR and pushing to Docker Hub). - Source credentials use registry-specific env vars (no default fallback) - Add sourceRegistry, sourceUsernameVar, sourcePasswordVar config options - Login to both registries when source credentials are available - If source credentials are not found, assume source is public

README.md

src/targets/docker.ts

+  // Object form - prefer object properties over legacy, but allow legacy as fallback
+  return {
+    image: ref.image,
+    format: ref.format ?? legacyFormat,
+    registry: ref.registry ?? legacyRegistry,
+    usernameVar: ref.usernameVar ?? legacyUsernameVar,
+    passwordVar: ref.passwordVar ?? legacyPasswordVar,
+    skipLogin: ref.skipLogin ?? legacySkipLogin,
+  };
+}


Allow source and target to be specified as either a string (image path) or an object with additional options (image, registry, format, usernameVar, passwordVar). This provides a cleaner API that groups related configuration. - Add ImageRefConfig and ImageRef types - Add normalizeImageRef() for backwards compatibility with legacy flat config - Update getDockerConfig() to use normalized config - Support both new nested format and legacy flat format - Add comprehensive tests for new format (12 new tests) - Update README with new configuration documentation

src/targets/docker.ts

Throws a clear ConfigurationError if source or target is missing from the Docker target configuration, instead of crashing with an unhelpful TypeError: Cannot read property 'image' of undefined.

hubertdeng123

one more comment, hope this doesn't break anything 🤞

src/targets/docker.ts

…t-ins - Use node:fs, node:os, node:path instead of fs, os, path - Use specific named imports (existsSync, homedir, join) instead of namespace imports

sentry · 2025-12-12T19:27:32Z

src/targets/docker.ts

+const GCR_REGISTRY_PATTERNS = [
+  /^gcr\.io$/,
+  /^[a-z]+-gcr\.io$/, // us-gcr.io, eu-gcr.io, asia-gcr.io, etc.
+  /^[a-z]+\.gcr\.io$/, // us.gcr.io, eu.gcr.io, asia.gcr.io, etc.
+  /^[a-z]+-docker\.pkg\.dev$/, // us-docker.pkg.dev, europe-docker.pkg.dev, etc.
+];


Bug: The regex for Google Artifact Registry hostnames is too strict and doesn't account for numbers in region names, causing authentication failures for valid regional endpoints.
_{Severity: CRITICAL | Confidence: High}

🔍 Detailed Analysis

The regular expression used to identify Google Cloud Registry (GCR) hosts is incorrect. The pattern /^[a-z]+-docker\.pkg\.dev$/ in isGoogleCloudRegistry only matches lowercase letters for the region, but valid Google Artifact Registry regions can contain numbers (e.g., us-west1). As a result, when a user specifies a valid regional endpoint like us-west1-docker.pkg.dev, the function returns false. This causes the application to incorrectly demand explicit DOCKER_..._USERNAME/PASSWORD credentials instead of using the available gcloud authentication, breaking the expected zero-configuration workflow.

💡 Suggested Fix

Update the regular expression on line 32 of src/targets/docker.ts to allow for numeric digits in the region part of the hostname. Change /^[a-z]+-docker\.pkg\.dev$/ to /^[a-z0-9-]+-docker\.pkg\.dev$/ to correctly match regional endpoints like us-west1-docker.pkg.dev.

🤖 Prompt for AI Agent

Review the code at the location below. A potential bug has been identified by an AI agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not valid. Location: src/targets/docker.ts#L27-L32 Potential issue: The regular expression used to identify Google Cloud Registry (GCR) hosts is incorrect. The pattern `/^[a-z]+-docker\.pkg\.dev$/` in `isGoogleCloudRegistry` only matches lowercase letters for the region, but valid Google Artifact Registry regions can contain numbers (e.g., `us-west1`). As a result, when a user specifies a valid regional endpoint like `us-west1-docker.pkg.dev`, the function returns `false`. This causes the application to incorrectly demand explicit `DOCKER_..._USERNAME`/`PASSWORD` credentials instead of using the available `gcloud` authentication, breaking the expected zero-configuration workflow.

_{Did we get this right? 👍 / 👎 to inform future reviews.}
_{Reference ID: 7465936}

aldy505 · 2025-12-15T04:18:41Z

@BYK do you have any plans to cut a release for this one?

aldy505 reviewed Dec 10, 2025

View reviewed changes

README.md Show resolved Hide resolved

BYK added 3 commits December 11, 2025 11:11

Merge branch 'master' into byk/feat/docker-multi-registry

965a20b

fix(docker): Treat docker.io as Docker Hub registry

e63f428

Recognize docker.io, index.docker.io, and registry-1.docker.io as Docker Hub aliases that should use default DOCKER_USERNAME/PASSWORD credentials instead of looking for DOCKER_DOCKER_IO_* env vars.

BYK force-pushed the byk/feat/docker-multi-registry branch 3 times, most recently from fe9004d to 56969b7 Compare December 12, 2025 00:01

BYK marked this pull request as ready for review December 12, 2025 00:02

BYK requested review from aldy505 and hubertdeng123 and removed request for aldy505 December 12, 2025 00:02

hubertdeng123 reviewed Dec 12, 2025

View reviewed changes

README.md Show resolved Hide resolved

src/targets/docker.ts Show resolved Hide resolved

BYK force-pushed the byk/feat/docker-multi-registry branch from 56969b7 to 0b62470 Compare December 12, 2025 10:10

sentry bot reviewed Dec 12, 2025

View reviewed changes

BYK force-pushed the byk/feat/docker-multi-registry branch from 0b62470 to 0faa5a4 Compare December 12, 2025 10:28

sentry bot reviewed Dec 12, 2025

View reviewed changes

src/targets/docker.ts Show resolved Hide resolved

BYK requested review from aldy505 and hubertdeng123 December 12, 2025 10:36

fix(docker): validate source and target properties are present

f8b1ec6

Throws a clear ConfigurationError if source or target is missing from the Docker target configuration, instead of crashing with an unhelpful TypeError: Cannot read property 'image' of undefined.

hubertdeng123 approved these changes Dec 12, 2025

View reviewed changes

src/targets/docker.ts Outdated Show resolved Hide resolved

refactor(docker): use node: prefix and named imports for Node.js buil…

9d986e7

…t-ins - Use node:fs, node:os, node:path instead of fs, os, path - Use specific named imports (existsSync, homedir, join) instead of namespace imports

BYK enabled auto-merge (squash) December 12, 2025 19:27

sentry bot reviewed Dec 12, 2025

View reviewed changes

BYK merged commit f60aba9 into master Dec 12, 2025
14 checks passed

BYK deleted the byk/feat/docker-multi-registry branch December 12, 2025 19:30

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

feat(docker): Add support for multiple registries #657

feat(docker): Add support for multiple registries #657

Uh oh!

BYK commented Dec 10, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

Uh oh!

hubertdeng123 left a comment

Uh oh!

Uh oh!

sentry bot Dec 12, 2025

Uh oh!

Uh oh!

aldy505 commented Dec 15, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

feat(docker): Add support for multiple registries #657

feat(docker): Add support for multiple registries #657

Uh oh!

Conversation

BYK commented Dec 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Key Changes

Multi-Registry Support

Cross-Registry Publishing

New Nested Object Config Format

Security Improvements

Example Configurations

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

Uh oh!

hubertdeng123 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sentry bot Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

aldy505 commented Dec 15, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

BYK commented Dec 10, 2025 •

edited

Loading