Contradicting information about port mappings in service containers

[hsnabszhdn]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

• About service containers
• Workflow syntax for GitHub Actions

What part(s) of the article would you like to see updated?

In both pages linked about, it says that if you don't specify the port, it maps the host port to a randomly chosen port on the container:

About service containers / Mapping Docker host and service container ports

❌ 8080/udp Map a randomly chosen UDP port in the container to UDP port 8080 on the Docker host.

I think, it's the other way around: "Map a randomly chosen port on the Docker host to UDP port 8080 in the container"

Workflow syntax for GitHub Actions / jobs.<job_id>.services / Example: Using localhost

❌ When you specify the Docker host port but not the container port, the container port is randomly assigned to a free port.

I think, it should be: "When you specify the container port but not the Docker host port, the container port is randomly assigned to a free port."

Additional information

In the following page, I think the correct statement is used:

Accessing contextual information about workflow runs / job context / Example usage of the job context

✅ This example workflow configures a PostgreSQL service container, and automatically maps port 5432 in the service container to a randomly chosen available port on the host.

[nguyenalex836]

@hsnabszhdn Thank you for raising this issue! I'll get this triaged for review ✨ Our team will provide feedback regarding the best next steps for this issue - thanks for your patience! 💛

[github-actions]

Thanks for opening an issue! We've triaged this issue for technical review by a subject matter expert 👀