Repository navigation
Add getMappedPort(Integer originalPort, InternetProtocol protocol) #554
Description
It will just look so much nicer in my test than
genericContainer.getContainerInfo().getNetworkSettings().getPorts().getBindings().get(new ExposedPort(originalPort, protocol))[0].getHostPortSpec()
I think it has something to do with the law of demeter.
But in all fairness root cause is moby/moby#4635
Activity
rnorth commentedon Feb 3, 2018
Wow, yes, that is quite a lot of code for something that ought to be nice and simple.
I think our
withExposedPortsmethod ultimately only sets up TCP port mappings. Are you looking, then, for:withExposedPorts(Integer originalPort, InternetProtocol protocol)method (and a correspondingadd...method)getMappedPort(Integer originalPort, InternetProtocol protocol)methodIs this what you mean?
This seems like an straightforward and worthwhile thing to add - thanks.
npetzall commentedon Feb 3, 2018
Both would be nice.
When I created the issue, the port was exposed in the dockerfile and default behavior is to Map all port so it was only retrieving that caused a fuzz.
I have now also added an unexposed udp port thru the createCommand hook.
So having both methods, would make usage easier and the test code much nicer.
agafox commentedon Feb 21, 2018
@rnorth do you need help here? I can take care of this issue
kiview commentedon Feb 24, 2018
@agafox PR would be greatly appreciated 🙂
jmcgill-public commentedon Oct 16, 2018
Late to this conversation. Is there a way to map UDP ports with randomly assigned port numbers as with ".withExposedPorts()" ?
I need to implement the equivalent of docker-compose
I also need to have TestContainers map the udp ports like it does for TCP.
indigo423 commentedon Jan 12, 2019
I tried to use Testcontainers in a black box test use case where I wanted to ran a test against several network flow services provided on UDP port 50000-50003 in our application. I use the
DockerComposeContainerwhich builds and runs a stack of the required services and publishes services on 50000-50003/udp and one for a REST API endpoint on 8980/tcp. I was able to use thewithExposedService()method for the REST API port. The test sends some network flow packets into our application and we check with some REST API calls if the packets are processed and stored correctly.During the test I've noticed the
withExposedService()method only allows to create TCP mappings which are required to use thegetServiceHost()andgetServicePort()methods fromDockerComposeContainerto resolve the dynamically assigned host and ports.I was able to workaround this issue by publishing a static port 50000-50003/udp in my docker-compose.yml file. Each port represents a different network flow protocol implementation:
So I can form a InetSocketAddress against the local machine and bypass the Testcontainer framework. That way I'll loose the ability to use dynamically mapped ports and have to ensure this test runs only once on the host system.
The code for the test can be found here and the Docker Compose file is here
doctorpangloss commentedon Jun 23, 2020
This is a pretty serious issue, I can see a lot of people are trying to test
jaegerbased on the UDP port there, including me.For anyone else coming from Google with this issue, simply use:
in your custom
jaegertracing/all-in-oneGenericContainer's constructormkrzywanski commentedon Jul 3, 2020
Anyone working on this? Was it resolved?
kiview commentedon Jul 3, 2020
@sHiniz0r
There is currently no implementation for a dynamically mapped port for UDP. Are you interested in contributing this?
mkrzywanski commentedon Jul 4, 2020
@kiview yes, I would like to try to contribute it.
kiview commentedon Jul 4, 2020
Great, feel free to ping me in Slack if you want discuss details or have questions.
I'd think implementation should be relatively straight forward, unless I overlooked something.
Add getMappedPort support for UDP protocol (testcontainers#554)
sudhir8485 commentedon Aug 4, 2026
Hi! I'd like to work on this if it's still open and wanted. I can add an overload of getMappedPort that accepts an InternetProtocol parameter, following the pattern already used in withFixedExposedPort. I'll also add a unit test covering both TCP and UDP mapping. Let me know if this is still relevant given #11377, or if there's a preferred approach — happy to get started once confirmed.
mohitduhan19 commentedon Sep 18, 2026
Opened a draft PR for this: #12086 - adds getMappedPort(int, InternetProtocol) on ContainerState, plus addExposedPort/withExposedPort(int, InternetProtocol) on GenericContainer so a UDP port can be exposed with a random host port in the first place, per the design agreed above. Left it as a draft since I could not run the full Gradle build in the environment I prepared it in; will mark it ready for review once CI is green.