Add fallback registry support and alternative image mapping in docker-compose
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 5/5
- Tempo estimado
- Mais de uma semana
- Facilidade para iniciantes
- 32/100
- Tipo de issue
- Funcionalidade
- Clareza
- Razoavelmente clara
- Status de atividade
- Pouca atividade
- Stack de tecnologia
- docker, docker-compose, go
- Domínio
- devops, infrastructure
Direção de pesquisa
Nenhum arquivo, teste ou ponto de entrada é mencionado. Comece rastreando como o docker-compose analisa a configuração de imagem dos serviços e lida com pulls de imagens; em seguida, encontre os testes de configuração e integração existentes. Done deve incluir um esquema de configuração acordado, um comportamento definido para falhas de fallback e testes que cubram as tentativas nos registros primário e de fallback.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Description
This feature request proposes adding native support in docker-compose for defining multiple container registries (primary and fallback) and enabling automatic failover when the primary registry is unavailable. It also introduces optional alternative image mappings per registry.
Problem
Currently, docker-compose only supports a single image reference per service:
services:
app:
image: myorg/myapp:1.0
If the primary registry (e.g. Docker Hub) becomes unavailable due to outage, rate limiting, or network issues, deployments fail immediately.
There is no built-in mechanism for:
- Automatic fallback to another registry (e.g. GHCR, ECR)
- Defining alternative image locations
- Transparent retry logic for image pulls
This forces users to rely on external scripts or CI/CD logic, increasing complexity and reducing reliability.
Proposed Solution
1. Global registry fallback configuration
x-registries:
primary: docker.io
fallback: ghcr.io
2. Service-level fallback image definition
services:
app:
image:
primary: myorg/myapp:1.0
fallback: ghcr.io/myorg/myapp:1.0
3. Automatic fallback behavior
When pulling images:
- Attempt to pull from primary registry
- If it fails (network error, timeout, 5xx errors):
- Automatically retry using fallback image
Example:
docker pull myorg/myapp:1.0
→ fails
docker pull ghcr.io/myorg/myapp:1.0
→ succeeds
4. Optional registry mapping per service
services:
app:
image: myorg/myapp:1.0
registry_fallback:
docker.io: myorg/myapp:1.0
ghcr.io: ghcr.io/myorg/myapp:1.0
Expected Behavior
- Primary registry is always attempted first
- Fallback registry is automatically used on failure
- No manual intervention required
- Works transparently with
docker compose up
Benefits
- Improved deployment reliability
- Resilience against registry outages (e.g. Docker Hub downtime)
- Simplified multi-registry strategies
- Better CI/CD and production robustness
- Reduced need for custom scripting
Use Cases
- Production systems requiring high availability
- CI/CD pipelines using multiple registries
- Organizations mirroring images across Docker Hub and GHCR
- Edge environments with unstable connectivity
- Disaster recovery scenarios
Alternatives Considered
- CI/CD-based image rewriting
- Manual multi-registry tagging and pushing
- Kubernetes-based imagePullPolicy strategies
These approaches are either external, complex, or not integrated into docker-compose workflows.
Summary
This feature would enhance docker-compose by adding native registry failover support, improving resilience and simplifying multi-registry deployments while preserving declarative configuration.
- Linguagem predominante
- Go
- Estrelas
- 38.9k
- Forks
- 6k
- Merge médio
- 2d 22h
- PRs com merge (30d)
- 81
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de docker/compose
-
[BUG] `docker compose port` prints `:0` (exit 0) for a port the image exposes but the service does not publishTalvez já em andamento @ndeloof assumiu há 1 dia. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 62/100
docker/compose#14435 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
[BUG] deploy.restart_policy without condition drops the restart policyTalvez livre de novo @akshat-lakhera assumiu há 25 dias e não há nenhum pull request aberto. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
docker/compose#14383 · 3 comentários ·
Mantenedores costumam responder em até 1 dia
-
[BUG] up: an optional (required: false) service_healthy dependent is not started when a required dependent shares the failing waitTalvez já em andamento @ndeloof assumiu há 2 dias. Aberta
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 58/100
docker/compose#14507 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
[BUG] Negative replica count in scale flags (docker compose scale / --scale) is accepted without validationTalvez já em andamento @arsalanyavari assumiu há 8 dias. Abertakind/bug status/approved
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 30/100
Mantenedores costumam responder em até 1 dia
Todas as issues de docker/compose
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
IBM-Cloud/terraform-provider-ibm#7115 ·
Mantenedores costumam responder em até 2 dias
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 86/100
fluxcd/notification-controller#1441 ·
Mantenedores costumam responder em até 1 dia
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 66/100
volcengine/volcengine-go-sdk#163 · 1 comentário ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
OneBusAway/maglev#2145 ·
Mantenedores costumam responder em até 2 dias
-
priority/medium status/ready type/chore
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
discobox-ai/discobox#1357 ·
Mantenedores costumam responder em até 1 dia