{"id":13567662,"url":"https://github.com/dokku/docker-ambassador","last_synced_at":"2025-04-04T02:32:25.908Z","repository":{"id":34255793,"uuid":"173980882","full_name":"dokku/docker-ambassador","owner":"dokku","description":"A maintained version of the ambassador linking pattern","archived":false,"fork":false,"pushed_at":"2024-09-22T03:48:20.000Z","size":137,"stargazers_count":8,"open_issues_count":0,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-30T00:56:02.044Z","etag":null,"topics":["ambassador","docker","docker-image","dokku","paas"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dokku.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"dokku","open_collective":"dokku","patreon":"dokku"}},"created_at":"2019-03-05T16:22:29.000Z","updated_at":"2024-09-22T03:48:22.000Z","dependencies_parsed_at":"2024-11-08T20:31:03.762Z","dependency_job_id":"d2dcd2b2-04ea-40c1-942b-eb8ba8e5499e","html_url":"https://github.com/dokku/docker-ambassador","commit_stats":{"total_commits":89,"total_committers":4,"mean_commits":22.25,"dds":0.5168539325842696,"last_synced_commit":"c1392c8a4195071b35a57765cb4db80fbf931fee"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dokku%2Fdocker-ambassador","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dokku%2Fdocker-ambassador/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dokku%2Fdocker-ambassador/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dokku%2Fdocker-ambassador/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dokku","download_url":"https://codeload.github.com/dokku/docker-ambassador/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246465225,"owners_count":20781919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ambassador","docker","docker-image","dokku","paas"],"created_at":"2024-08-01T13:02:38.327Z","updated_at":"2025-04-04T02:32:25.658Z","avatar_url":"https://github.com/dokku.png","language":"Shell","funding_links":["https://github.com/sponsors/dokku","https://opencollective.com/dokku","https://patreon.com/dokku"],"categories":["Shell"],"sub_categories":[],"readme":"# docker-ambassador\n\n[![dokku/ambassador](http://dockeri.co/image/dokku/ambassador)](https://hub.docker.com/r/dokku/ambassador)\n\nA maintained version of the [ambassador linking](https://github.com/SvenDowideit/dockerfiles/tree/master/ambassador) pattern.\n\nThis ambassador image can be used to automatically proxy all exposed ports from the linked container, or to proxy a specified port at a specific IP address or hostname.\n\n## Use Docker linking to autoattach to all exposed ports\n\n```shell\n# start a container that exposes a port\ndocker run --rm --name nginx.1 nginx\n\n# run the ambassador \ndocker run --rm -ti --link nginx.1 -p 9999:80 -p 8888:443 dokku/ambassador\n```\n\nRunning the ambassador container will result in output lke the following.\n\n```text\nConnecting to 172.17.0.4:80 172.17.0.4:443...\n2016/01/12 13:03:14 socat[19] E connect(5, AF=2 172.17.0.4:443, 16): Connection refused\n```\n\nYou can also proxy exposed ports from more than one container by using more than one --link, but only if there is no duplication of exposed container ports.\n\n## Specify host and port\n\nThis will allow you Dynamically map a container port after its been created.\n\nFor example:\n\n```shell\n# start a container that exposes a port\ndocker run --rm --name nginx.1 nginx\n```\n\nIn the above example, nginx is running, but no-one can make requests to it. By running:\n\n```shell\n# Assuming the nginx.1 container is on IP `172.17.0.4`\ndocker run --rm -p 9999:80 dokku/ambassador 172.17.0.4 80\n```\n\nYou will now be able to make requests to the web server on `http://localhost:9999`\n\n## Credit\n\nThanks to Sven Dowideit for providing the initial implementation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdokku%2Fdocker-ambassador","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdokku%2Fdocker-ambassador","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdokku%2Fdocker-ambassador/lists"}