[Enhancement/Bug*]: Testcontainers does not fall back to linux/amd64 when registry returns missing architecture
Mantenedores costumam responder em até 1 dia
@anushkasrvstv já está trabalhando nisso.
Desde 4/6/2026.
Avaliação
- Dificuldade
- 4/5
- Tempo estimado
- 3-5 dias
- Facilidade para iniciantes
- 45/100
- Tipo de issue
- Bug
- Clareza
- Razoavelmente clara
- Status de atividade
- Pouca atividade
- Stack de tecnologia
- docker, java
- Domínio
- devops, testing-qa
Direção de pesquisa
Comece lendo a issue 9214 e o pull request 9200; em seguida, localize o tratamento de fallback existente para DockerClientException e NotFoundException. Reproduza a falha ao fazer pull da imagem arm64 de acordo com o comportamento descrito do registry e inspecione os testes relevantes. Considera-se concluído quando a resposta de arquitetura ausente for tratada de forma consistente ou quando a opção de arquitetura/fallback solicitada for claramente suportada.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Module
Core
Testcontainers version
1.21.4
Using the latest Testcontainers version?
Yes
Host OS
Mac
Host Arch
arm64
Docker version
podman version
Client: Podman Engine
Version: 5.6.2
API Version: 5.6.2
Go Version: go1.25.1
Git Commit: 9dd5e1ed33830612bc200d7a13db00af6ab865a4
Built: Tue Sep 30 21:35:47 2025
Build Origin: pkginstaller
OS/Arch: darwin/arm64
Server: Podman Engine
Version: 5.6.2
API Version: 5.6.2
Go Version: go1.24.7
Git Commit: 9dd5e1ed33830612bc200d7a13db00af6ab865a4
Built: Tue Sep 30 02:00:00 2025
OS/Arch: linux/arm64
What happened?
Expected behavior
When pulling a Docker image that only provides a linux/amd64 platform, Testcontainers should automatically fall back to linux/amd64 on ARM-based hosts (e.g. Apple Silicon Macs), as it already does for DockerClientException and NotFoundException.
Actual behavior
Registries like JFrog Artifactory may return:
com.github.dockerjava.api.exception.InternalServerErrorException: Status 500: {"message":"no image found in manifest list for architecture \"arm64\", variant \"v8\", OS \"linux\""}
While the 500 Internal server error from JFrog is arguably misleading/incorrect I still think testcontainers should provide an option to specify the arch or fallback strategy outside of using a direct image SHA.
Relevant log output
com.github.dockerjava.api.exception.InternalServerErrorException: Status 500: {"message":"no image found in manifest list for architecture \"arm64\", variant \"v8\", OS \"linux\""}
at org.testcontainers.shaded.com.github.dockerjava.core.DefaultInvocationBuilder.execute(DefaultInvocationBuilder.java:247)
at org.testcontainers.shaded.com.github.dockerjava.core.DefaultInvocationBuilder.lambda$executeAndStream$1(DefaultInvocationBuilder.java:269)
at java.base/java.lang.Thread.run(Thread.java:1474)
2026-05-27T12:16:09.667+02:00 WARN 46613 --- [ Test worker] [] t.r.b.d.4.0.11-r2 : Retrying pull for image: registry.bankdata.dev/all-docker-centrals/ibm-messaging/mq:9.4.0.11-r2 (112s remaining)
2026-05-27T12:16:13.150+02:00 ERROR 46613 --- [ream--322867326] [] c.g.d.api.async.ResultCallbackTemplate : Error during callback
com.github.dockerjava.api.exception.InternalServerErrorException: Status 500: {"message":"no image found in manifest list for architecture \"arm64\", variant \"v8\", OS \"linux\""}
Additional Information
Issue has great similarity to:
issues/9214:pull/9200
but I am unsure if it qualifies as a bug or an enhancement.
Would love to get some input. Won't fix is a very valid response as the issue is primarily JFrog related.
- Linguagem predominante
- Java
- Estrelas
- 8.8k
- Forks
- 2k
- Merge médio
- 5d 21h
- PRs com merge (30d)
- 15
Preparar o ambiente
Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.
- 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 testcontainers/testcontainers-java
-
[Bug]: withStartupTimeout() changes the startup timeout of all containers that use the default wait strategyTalvez já em andamento @aymenjamaaoui assumiu há 1 dia. Abertatype/bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 64/100
testcontainers/testcontainers-java#12171 ·
Mantenedores costumam responder em até 1 dia
-
[Enhancement]: Document why singleton containers are required under Spring's test context cachingTalvez já em andamento @zakaullah075 assumiu há 95 dias. Abertatype/enhancement
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 85/100
testcontainers/testcontainers-java#11967 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
[Bug]: Cannot reuse Selenium BrowserWebDriverContainers under LinuxTalvez já em andamento @kdelay assumiu há 116 dias. Abertatype/bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
testcontainers/testcontainers-java#11941 ·
Mantenedores costumam responder em até 1 dia
-
[Bug]: DockerDesktopClientProviderStrategy is always applicableTalvez já em andamento @seonwooj0810 assumiu há 165 dias. Abertatype/bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 74/100
testcontainers/testcontainers-java#11829 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
[Enhancement]: cleanup document after removing junit4 supportTalvez já em andamento @SJvaca30 assumiu há 173 dias. Abertatype/enhancement
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
testcontainers/testcontainers-java#11578 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de testcontainers/testcontainers-java
Issues semelhantes
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 68/100
pact-foundation/pact-plugins#125 ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 66/100
opencollab/flexdock#28 · 1 comentário ·
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 85/100
yegor256/jping#122 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 75/100
SAP/ai-sdk-java#1206 ·
Mantenedores costumam responder em até 1 dia
-
enhancement good first issue insight-module
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 86/100
sdlc-pro/spring-lens#606 ·
Mantenedores costumam responder em até 1 dia