Files
docker-docs/engine/userguide/networking/default_network/dockerlinks/index.html
John Mulhausen fc11d4273b v1.8 seed
2016-09-01 13:53:00 -07:00

2667 lines
111 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="description" content="Learn how to connect Docker containers together.">
<meta name="keywords" content="[Examples, Usage, user guide, links, linking, docker, documentation, examples, names, name, container naming, port, map, network port, network]">
<title>Legacy container links </title>
<link rel="shortcut icon" href="https://docs.docker.com/images/favicon.png" type="image/x-icon">
<link rel="stylesheet" href="../../../../../dist/assets/css/app.css" />
<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/animate.css/3.2.6/animate.min.css">
<link rel="stylesheet" href="../../../../../css/custom.css">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script src="../../../../../dist/assets/js/modernizr.js"></script>
</head>
<body>
<div class="off-canvas-wrap" data-offcanvas>
<div class="inner-wrap">
<a class="left-off-canvas-toggle" href="#" >
<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="35px" height="35px" viewBox="0 0 35 35" enable-background="new 0 0 35 35" xml:space="preserve">
<path fill="#3597D4" d="M30.583,9.328c0,0.752-0.539,1.362-1.203,1.362H5.113c-0.664,0-1.203-0.61-1.203-1.362l0,0
c0-0.752,0.539-1.362,1.203-1.362H29.38C30.045,7.966,30.583,8.576,30.583,9.328L30.583,9.328z"/>
<path fill="#3597D4" d="M30.583,17.09c0,0.752-0.539,1.362-1.203,1.362H5.113c-0.664,0-1.203-0.61-1.203-1.362l0,0
c0-0.752,0.539-1.362,1.203-1.362H29.38C30.045,15.728,30.583,16.338,30.583,17.09L30.583,17.09z"/>
<path fill="#3597D4" d="M30.583,24.387c0,0.752-0.539,1.362-1.203,1.362H5.113c-0.664,0-1.203-0.61-1.203-1.362l0,0
c0-0.752,0.539-1.362,1.203-1.362H29.38C30.045,23.025,30.583,23.635,30.583,24.387L30.583,24.387z"/>
</svg>
</a>
<a class="button secondary small get-started-cta">Get Started</a>
<header class="main-header">
<div class="row">
<div class="large-3 columns">
<a href="../../../../../"><img class="logo" src="../../../../../dist/assets/images/logo.png"></a>
</div>
<div class="large-9 columns">
<ul class="nav-global">
<li><a href="https://www.docker.com/support">Support</a></li>
<li><a href="https://training.docker.com/">Training</a></li>
<li><a href="https://docs.docker.com/">Docs</a></li>
<li><a href="http://blog.docker.com/">Blog</a></li>
<li><a href="https://hub.docker.com/">Docker Hub</a></li>
<li><a class="button" href="../../../../../mac/started/">Get Started</a></li>
</ul>
<ul class="nav-main">
<li><a href="https://www.docker.com/products">Products</a>
<ul>
<li><a href="https://www.docker.com/pricing">Pricing</a></li>
<li><a href="https://www.docker.com/whatisdocker">What is Docker?</a></li>
</ul>
</li>
<li><a href="https://www.docker.com/customers">Customers</a></li>
<li><a href="https://www.docker.com/community">Community</a>
<ul>
<li><a href="https://www.docker.com/community/meetups">Meetups</a></li>
<li><a href="https://www.docker.com/community/events">Events</a></li>
<li><a href="https://forums.docker.com">Forums</a></li>
<li><a href="http://www.scoop.it/t/docker-by-docker">Community News</a></li>
</ul>
</li>
<li><a href="https://www.docker.com/partners">Partners</a>
<ul>
<li><a href="https://www.docker.com/partners/partner-programs">Partner Programs</a></li>
</ul>
</li>
<li><a href="https://www.docker.com/company">Company</a>
<ul>
<li><a href="https://www.docker.com/news-and-press">News &amp; Press</a></li>
<li><a href="https://www.docker.com/work-docker">Work at Docker</a></li>
<li><a href="https://www.docker.com/company/management">Management</a></li>
<li><a href="https://www.docker.com/company/contact">Contact</a></li>
</ul>
</li>
<li><a href="https://www.docker.com/open-source">Open Source</a>
<ul>
<li><a href="https://www.docker.com/contribute">Contribute</a></li>
</ul>
</li>
</ul>
</div>
</div>
</header>
<aside class="left-off-canvas-menu">
<ul class="off-canvas-list">
<li class="has-submenu"><a href="#">Products</a>
<ul class="left-submenu">
<li class="back"><a href="#">Back</a></li>
<li><a href="#">Pricing</a></li>
<li><a href="#">What Is Docker</a></li>
<li><a href="#">Products</a></li>
<li><a href="#">Docker Engine</a></li>
<li><a href="#">Docker Hub</a></li>
<li><a href="#">Docker Registry</a></li>
<li><a href="#">Docker Machine</a></li>
<li><a href="#">Docker Swarm</a></li>
<li><a href="#">Docker Compose</a></li>
<li><a href="#">Kitematic</a></li>
</ul>
</li>
<li><a href="#">Customers</a></li>
<li class="has-submenu"><a href="#">Community</a>
<ul class="left-submenu">
<li class="back"><a href="#">Back</a></li>
<li><a href="#">Community</a></li>
<li><a href="#">Meetups</a></li>
<li><a href="https://www.docker.com/community/events">Events</a></li>
<li><a href="#">Forum</a></li>
<li><a href="#">Scoop.it</a></li>
</ul>
</li>
<li class="has-submenu"><a href="#">Partners</a>
<ul class="left-submenu">
<li class="back"><a href="#">Back</a></li>
<li><a href="#">Partners</a></li>
<li><a href="https://www.docker.com/partners/partner-programs">Partners Programs</a></li>
</ul>
</li>
<li><a href="#">Company</a></li>
<li class="has-submenu"><a href="#">Open Source</a>
<ul class="left-submenu">
<li class="back"><a href="#">Back</a></li>
<li><a href="#">Open Source</a></li>
<li><a href="#">Contribute</a></li>
<li><a href="#">Governance</a></li>
</ul>
</li>
</ul>
<ul class="nav-global-off-canvas">
<li><a href="#">Support</a></li>
<li><a href="#">Training</a></li>
<li><a href="#">Docs</a></li>
<li><a href="#">Blog</a></li>
<li><a href="#">Sign in</a></li>
<li><a href="#">Sign up</a></li>
</ul>
</aside>
<a class="exit-off-canvas"></a>
<div id="docs" class="row">
<div class="large-3 columns">
<section id="multiple" data-accordion-group>
<section data-accordion>
<article data-accordion>
<button data-control> Install</button>
<div data-content>
<article data-accordion>
<button data-control> Docker Engine</button>
<div data-content>
<a data-link href="../../../../../engine/installation/mac/" class=""> Installation on Mac OS X</a>
<a data-link href="../../../../../engine/installation/windows/" class=""> Installation on Windows</a>
<article data-accordion>
<button data-control> Linux</button>
<div data-content>
<a data-link href="../../../../../engine/installation/ubuntulinux/" class=""> Installation on Ubuntu </a>
<a data-link href="../../../../../engine/installation/rhel/" class=""> Installation on Red Hat Enterprise Linux</a>
<a data-link href="../../../../../engine/installation/centos/" class=""> Installation on CentOS</a>
<a data-link href="../../../../../engine/installation/fedora/" class=""> Installation on Fedora</a>
<a data-link href="../../../../../engine/installation/debian/" class=""> Installation on Debian</a>
<a data-link href="../../../../../engine/installation/archlinux/" class=""> Installation on Arch Linux</a>
<a data-link href="../../../../../engine/installation/cruxlinux/" class=""> Installation on CRUX Linux</a>
<a data-link href="../../../../../engine/installation/frugalware/" class=""> Installation on FrugalWare</a>
<a data-link href="../../../../../engine/installation/gentoolinux/" class=""> Installation on Gentoo</a>
<a data-link href="../../../../../engine/installation/oracle/" class=""> Installation on Oracle Linux</a>
<a data-link href="../../../../../engine/installation/SUSE/" class=""> Installation on openSUSE and SUSE Linux Enterprise</a>
</div>
</article>
<article data-accordion>
<button data-control> Cloud</button>
<div data-content>
<a data-link href="../../../../../engine/installation/amazon/" class=""> Amazon EC2 Installation</a>
<a data-link href="../../../../../engine/installation/google/" class=""> Installation on Google Cloud Platform</a>
<a data-link href="../../../../../engine/installation/softlayer/" class=""> Installation on IBM SoftLayer </a>
<a data-link href="../../../../../engine/installation/azure/" class=""> Installation on Microsoft Azure platform</a>
<a data-link href="../../../../../engine/installation/rackspace/" class=""> Installation on Rackspace Cloud</a>
<a data-link href="../../../../../engine/installation/joyent/" class=""> Joyent Triton Elastic Container Service</a>
</div>
</article>
<a data-link href="../../../../../engine/installation/binaries/" class=""> Installation from binaries</a>
</div>
</article>
<a data-link href="../../../../../kitematic/" class=""> Kitematic</a>
<a data-link href="../../../../../machine/install-machine/" class=""> Docker Machine</a>
<a data-link href="../../../../../compose/install/" class=""> Docker Compose</a>
<a data-link href="../../../../../swarm/install-w-machine/" class=""> Docker Swarm</a>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> Docker Fundamentals</button>
<div data-content>
<a data-link href="../../../../../engine/userguide/basics/" class=""> Quickstart containers</a>
<a data-link href="../../../../../engine/userguide/" class=""> The Docker user guide</a>
<article data-accordion>
<button data-control> Work with Docker Images</button>
<div data-content>
<a data-link href="../../../../../engine/articles/dockerfile_best-practices/" class=""> Best practices for writing Dockerfiles</a>
<a data-link href="../../../../../engine/articles/baseimages/" class=""> Create a base image</a>
</div>
</article>
<article data-accordion>
<button data-control> Work with Docker Containers</button>
<div data-content>
<a data-link href="../../../../../engine/userguide/dockerizing/" class=""> Hello world in a container</a>
<a data-link href="../../../../../engine/userguide/usingdocker/" class=""> Run a simple application</a>
<a data-link href="../../../../../engine/userguide/dockerimages/" class=""> Build your own images</a>
<a data-link href="../../../../../engine/userguide/networkingcontainers/" class=""> Networking containers</a>
<a data-link href="../../../../../engine/userguide/dockervolumes/" class=""> Manage data in containers</a>
<a data-link href="../../../../../engine/userguide/dockerrepos/" class=""> Store images on Docker Hub</a>
</div>
</article>
<article data-accordion>
<button data-control> Docker on Windows &amp; OSX</button>
<div data-content>
<a data-link href="../../../../../engine/articles/dsc/" class=""> PowerShell DSC Usage</a>
</div>
</article>
<article data-accordion>
<button data-control> Use the Kitematic GUI</button>
<div data-content>
<a data-link href="../../../../../kitematic/userguide/" class=""> Kitematic User Guide: Intro &amp; Overview</a>
<a data-link href="../../../../../kitematic/nginx-web-server/" class=""> Set up an Nginx web server</a>
<a data-link href="../../../../../kitematic/minecraft-server/" class=""> Set up a Minecraft Server</a>
<a data-link href="../../../../../kitematic/rethinkdb-dev-database/" class=""> Creating a Local RethinkDB Database for Development</a>
<a data-link href="../../../../../kitematic/faq/" class=""> Frequently Asked Questions</a>
<a data-link href="../../../../../kitematic/known-issues/" class=""> Known Issues</a>
</div>
</article>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> Use Docker</button>
<div data-content>
<a data-link href="../../../../../engine/misc/" class=""> About Docker</a>
<a data-link href="../../../../../engine/userguide/labels-custom-metadata/" class=""> Apply custom metadata</a>
<a data-link href="../../../../../engine/misc/deprecated/" class=""> Docker Deprecated Features</a>
<a data-link href="../../../../../engine/introduction/understanding-docker/" class=""> Understand the architecture</a>
<article data-accordion>
<button data-control> Provision &amp; set up Docker hosts</button>
<div data-content>
<a data-link href="../../../../../machine/" class=""> Overview of Docker Machine</a>
<a data-link href="../../../../../machine/get-started/" class=""> Get started with Docker Machine and a local VM</a>
<a data-link href="../../../../../machine/get-started-cloud/" class=""> Using Docker Machine with a cloud provider</a>
<a data-link href="../../../../../machine/migrate-to-machine/" class=""> Migrate from Boot2Docker to Docker Machine</a>
</div>
</article>
<article data-accordion>
<button data-control> Create multi-container applications</button>
<div data-content>
<a data-link href="../../../../../compose/" class=""> Overview of Docker Compose</a>
<a data-link href="../../../../../compose/production/" class=""> Using Compose in production</a>
<a data-link href="../../../../../compose/extends/" class=""> Extending services in Compose</a>
<a data-link href="../../../../../compose/gettingstarted/" class=""> Getting Started</a>
<a data-link href="../../../../../compose/django/" class=""> Quickstart Guide: Compose and Django</a>
<a data-link href="../../../../../compose/rails/" class=""> Quickstart Guide: Compose and Rails</a>
<a data-link href="../../../../../compose/networking/" class=""> Networking in Compose</a>
<a data-link href="../../../../../compose/wordpress/" class=""> Quickstart Guide: Compose and WordPress</a>
<a data-link href="../../../../../compose/completion/" class=""> Command-line Completion</a>
</div>
</article>
<article data-accordion>
<button data-control> Cluster Docker containers</button>
<div data-content>
<a data-link href="../../../../../swarm/" class=""> Docker Swarm</a>
<a data-link href="../../../../../swarm/install-manual/" class=""> Create a swarm for development</a>
<a data-link href="../../../../../swarm/multi-manager-setup/" class=""> High availability in Docker Swarm</a>
<a data-link href="../../../../../swarm/networking/" class=""> Docker Swarm Networking</a>
<a data-link href="../../../../../swarm/discovery/" class=""> Docker Swarm discovery</a>
<a data-link href="../../../../../swarm/scheduler/filter/" class=""> Docker Swarm filters</a>
<a data-link href="../../../../../swarm/scheduler/strategy/" class=""> Docker Swarm strategies</a>
</div>
</article>
<article data-accordion>
<button data-control> Administrate Docker</button>
<div data-content>
<a data-link href="../../../../../engine/articles/host_integration/" class=""> Automatically start containers</a>
<a data-link href="../../../../../engine/articles/security/" class=""> Docker security</a>
<a data-link href="../../../../../engine/articles/configuring/" class=""> Configuring and running Docker</a>
<a data-link href="../../../../../engine/articles/runmetrics/" class=""> Runtime metrics</a>
<a data-link href="../../../../../engine/articles/https/" class=""> Protect the Docker daemon socket</a>
<a data-link href="../../../../../engine/articles/ambassador_pattern_linking/" class=""> Link via an ambassador container</a>
<a data-link href="../../../../../engine/articles/systemd/" class=""> Control and configure Docker with systemd</a>
<article data-accordion>
<button data-control> Logging</button>
<div data-content>
<a data-link href="../../../../../engine/reference/logging/overview/" class=""> Configuring Logging Drivers</a>
<a data-link href="../../../../../engine/reference/logging/awslogs/" class=""> Amazon CloudWatch Logs logging driver</a>
<a data-link href="../../../../../engine/reference/logging/log_tags/" class=""> Log tags for logging driver</a>
<a data-link href="../../../../../engine/reference/logging/fluentd/" class=""> Fluentd logging driver</a>
<a data-link href="../../../../../engine/reference/logging/splunk/" class=""> Splunk logging driver</a>
<a data-link href="../../../../../engine/reference/logging/journald/" class=""> journald logging driver</a>
</div>
</article>
<article data-accordion>
<button data-control> Applications and Services</button>
<div data-content>
<a data-link href="../../../../../engine/examples/running_riak_service/" class=""> Dockerizing a Riak service</a>
<a data-link href="../../../../../engine/examples/running_ssh_service/" class=""> Dockerizing an SSH service</a>
</div>
</article>
<article data-accordion>
<button data-control> Integrate with Third-party Tools</button>
<div data-content>
<a data-link href="../../../../../engine/articles/cfengine_process_management/" class=""> Process management with CFEngine</a>
<a data-link href="../../../../../engine/articles/chef/" class=""> Using Chef</a>
<a data-link href="../../../../../engine/articles/puppet/" class=""> Using Puppet</a>
<a data-link href="../../../../../engine/articles/using_supervisord/" class=""> Using Supervisor with Docker</a>
</div>
</article>
</div>
</article>
<article data-accordion>
<button data-control> Docker storage drivers</button>
<div data-content>
<a data-link href="../../../../../engine/userguide/storagedriver/imagesandcontainers/" class=""> Understand images, containers, and storage drivers</a>
<a data-link href="../../../../../engine/userguide/storagedriver/selectadriver/" class=""> Select a storage driver</a>
<a data-link href="../../../../../engine/userguide/storagedriver/aufs-driver/" class=""> AUFS storage driver in practice</a>
<a data-link href="../../../../../engine/userguide/storagedriver/btrfs-driver/" class=""> BTRFS storage in practice</a>
<a data-link href="../../../../../engine/userguide/storagedriver/device-mapper-driver/" class=""> Device mapper storage in practice</a>
<a data-link href="../../../../../engine/userguide/storagedriver/overlayfs-driver/" class=""> OverlayFS storage in practice</a>
<a data-link href="../../../../../engine/userguide/storagedriver/zfs-driver/" class=""> ZFS storage in practice</a>
</div>
</article>
<article data-accordion>
<button data-control> Network configuration</button>
<div data-content>
<a data-link href="../../../../../engine/userguide/networking/dockernetworks/" class=""> Docker container networking</a>
<a data-link href="../../../../../engine/userguide/networking/work-with-networks/" class=""> Work with network commands</a>
<a data-link href="../../../../../engine/userguide/networking/get-started-overlay/" class=""> Get started with multi-host networking</a>
<article data-accordion>
<button data-control> Default bridge network</button>
<div data-content>
<a data-link href="../../../../../engine/userguide/networking/default_network/dockerlinks/" class=" active"> Legacy container links</a>
<a data-link href="../../../../../engine/userguide/networking/default_network/binding/" class=""> Bind container ports to the host</a>
<a data-link href="../../../../../engine/userguide/networking/default_network/build-bridges/" class=""> Build your own bridge</a>
<a data-link href="../../../../../engine/userguide/networking/default_network/configure-dns/" class=""> Configure container DNS</a>
<a data-link href="../../../../../engine/userguide/networking/default_network/custom-docker0/" class=""> Customize the docker0 bridge</a>
<a data-link href="../../../../../engine/userguide/networking/default_network/container-communication/" class=""> Understand container communication</a>
<a data-link href="../../../../../engine/userguide/networking/default_network/ipv6/" class=""> IPv6 with Docker</a>
</div>
</article>
</div>
</article>
<article data-accordion>
<button data-control> Applied Docker</button>
<div data-content>
<a data-link href="../../../../../engine/examples/mongodb/" class=""> Dockerizing MongoDB</a>
<a data-link href="../../../../../engine/examples/postgresql_service/" class=""> Dockerizing PostgreSQL</a>
<a data-link href="../../../../../engine/examples/couchdb_data_volumes/" class=""> Dockerizing a CouchDB service</a>
<a data-link href="../../../../../engine/examples/nodejs_web_app/" class=""> Dockerizing a Node.js web app</a>
<a data-link href="../../../../../engine/examples/running_redis_service/" class=""> Dockerizing a Redis service</a>
<a data-link href="../../../../../engine/examples/apt-cacher-ng/" class=""> Dockerizing an apt-cacher-ng service</a>
</div>
</article>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> Manage image repositories</button>
<div data-content>
<a data-link href="../../../../../engine/userguide/image_management/" class=""> Image management</a>
<article data-accordion>
<button data-control> Docker Hub</button>
<div data-content>
<a data-link href="../../../../../docker-hub/" class=""> Introducing Docker Hub</a>
<a data-link href="../../../../../docker-hub/accounts/" class=""> Your Docker Hub account</a>
<a data-link href="../../../../../docker-hub/repos/" class=""> Repositories on Docker Hub</a>
<a data-link href="../../../../../docker-hub/builds/" class=""> Automated Builds on Docker Hub</a>
<a data-link href="../../../../../docker-hub/github/" class=""> Automated Builds from GitHub</a>
<a data-link href="../../../../../docker-hub/bitbucket/" class=""> Automated Builds with Bitbucket</a>
<a data-link href="../../../../../docker-hub/orgs/" class=""> Teams &amp; Organizations</a>
<a data-link href="../../../../../docker-hub/official_repos/" class=""> Official Repositories on Docker Hub</a>
</div>
</article>
<article data-accordion>
<button data-control> Docker Trusted Registry</button>
<div data-content>
<a data-link href="../../../../../docker-trusted-registry/" class=""> Overview</a>
<article data-accordion>
<button data-control> Trusted Registry installation overview</button>
<div data-content>
<a data-link href="../../../../../docker-trusted-registry/install/dtr-ami-byol-launch/" class=""> Install Docker Subscription for AWS (BYOL))</a>
<a data-link href="../../../../../docker-trusted-registry/install/engine-ami-launch/" class=""> Install Docker Engine for AWS AMI (BDS)</a>
<a data-link href="../../../../../docker-trusted-registry/install/dtr-ami-bds-launch/" class=""> Install Trusted Registry for AWS AMI (BDS)</a>
<a data-link href="../../../../../docker-trusted-registry/install/install-csengine/" class=""> Manually Install the CS Docker Engine</a>
<a data-link href="../../../../../docker-trusted-registry/install/install-dtr/" class=""> Manually install Trusted Registry</a>
<a data-link href="../../../../../docker-trusted-registry/install/upgrade/" class=""> Upgrade Trusted Registry and CS Engine</a>
</div>
</article>
<a data-link href="../../../../../docker-trusted-registry/quick-start/" class=""> Quick-start: Basic Workflow</a>
<a data-link href="../../../../../docker-trusted-registry/userguide/" class=""> User guide</a>
<a data-link href="../../../../../docker-trusted-registry/adminguide/" class=""> Admin guide</a>
<a data-link href="../../../../../docker-trusted-registry/configuration/" class=""> Configuration options</a>
<a data-link href="../../../../../docker-trusted-registry/license/" class=""> Trusted Registry License</a>
<article data-accordion>
<button data-control> DTR APIs</button>
<div data-content>
<a data-link href="../../../../../docker-trusted-registry/api/" class=""> Docker Trusted Registry Accounts &amp; Repos API: Intro &amp; Overview</a>
<a data-link href="../../../../../docker-trusted-registry/api/dtr_1_3_accounts/" class=""> Docker Trusted Registry Accounts API</a>
<a data-link href="../../../../../docker-trusted-registry/api/dtr_1_3_teams/" class=""> Docker Trusted Registry User and Org API</a>
<a data-link href="../../../../../docker-trusted-registry/api/dtr_1_3_repositories/" class=""> Docker Trusted Registry Repository API</a>
<a data-link href="../../../../../docker-trusted-registry/api/dtr_1_3_user_repo_access/" class=""> Docker Trusted Registry User Repository API</a>
<a data-link href="../../../../../docker-trusted-registry/api/dtr_1_3_team_repo_access/" class=""> Docker Trusted Registry Org Repository API</a>
<a data-link href="../../../../../docker-trusted-registry/api/dtr_1_3_team_repo_namespace_access/" class=""> Docker Trusted Registry Org Namespace API</a>
</div>
</article>
<a data-link href="../../../../../docker-trusted-registry/support/" class=""> Support</a>
<a data-link href="../../../../../docker-trusted-registry/release-notes/" class=""> Release notes</a>
<a data-link href="../../../../../docker-trusted-registry/prior-release-notes/" class=""> Prior release notes archive</a>
</div>
</article>
<article data-accordion>
<button data-control> Docker Registry</button>
<div data-content>
<a data-link href="../../../../../registry/" class=""> Docker Registry</a>
<a data-link href="../../../../../registry/introduction/" class=""> Understanding the Registry</a>
<a data-link href="../../../../../registry/deploying/" class=""> Deploying a registry server</a>
<a data-link href="../../../../../registry/configuration/" class=""> Configuring a registry</a>
<a data-link href="../../../../../registry/notifications/" class=""> Working with notifications</a>
<a data-link href="../../../../../registry/help/" class=""> Getting help</a>
</div>
</article>
<article data-accordion>
<button data-control> Use trusted images</button>
<div data-content>
<a data-link href="../../../../../engine/security/trust/content_trust/" class=""> Content trust in Docker</a>
<a data-link href="../../../../../engine/security/trust/trust_automation/" class=""> Automation with content trust</a>
<a data-link href="../../../../../engine/security/trust/trust_key_mng/" class=""> Manage keys for content trust</a>
<a data-link href="../../../../../engine/security/trust/trust_sandbox/" class=""> Play in a content trust sandbox</a>
</div>
</article>
<a data-link href="../../../../../engine/articles/certificates/" class=""> Using certificates for repository client verification</a>
<a data-link href="../../../../../engine/articles/registry_mirror/" class=""> Run a local registry mirror</a>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> Extend Docker</button>
<div data-content>
<a data-link href="../../../../../engine/extend/plugins_network/" class=""> Docker network driver plugins</a>
<a data-link href="../../../../../engine/extend/plugins/" class=""> Extending Docker with plugins</a>
<a data-link href="../../../../../engine/extend/plugins_volume/" class=""> Volume plugins</a>
<a data-link href="../../../../../engine/extend/plugin_api/" class=""> Plugins API</a>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> Command and API references</button>
<div data-content>
<a data-link href="../../../../../engine/reference/run/" class=""> Docker run reference</a>
<a data-link href="../../../../../engine/reference/builder/" class=""> Dockerfile reference</a>
<a data-link href="../../../../../engine/reference/api/remote_api_client_libraries/" class=""> Remote API client libraries</a>
<article data-accordion>
<button data-control> Using the command line</button>
<div data-content>
<a data-link href="../../../../../engine/reference/commandline/cli/" class=""> Use the Docker command line</a>
<a data-link href="../../../../../engine/reference/commandline/daemon/" class=""> daemon</a>
<a data-link href="../../../../../engine/reference/commandline/attach/" class=""> attach</a>
<a data-link href="../../../../../engine/reference/commandline/build/" class=""> build</a>
<a data-link href="../../../../../engine/reference/commandline/commit/" class=""> commit</a>
<a data-link href="../../../../../engine/reference/commandline/cp/" class=""> cp</a>
<a data-link href="../../../../../engine/reference/commandline/create/" class=""> create</a>
<a data-link href="../../../../../engine/reference/commandline/diff/" class=""> diff</a>
<a data-link href="../../../../../engine/reference/commandline/events/" class=""> events</a>
<a data-link href="../../../../../engine/reference/commandline/exec/" class=""> exec</a>
<a data-link href="../../../../../engine/reference/commandline/export/" class=""> export</a>
<a data-link href="../../../../../engine/reference/commandline/history/" class=""> history</a>
<a data-link href="../../../../../engine/reference/commandline/images/" class=""> images</a>
<a data-link href="../../../../../engine/reference/commandline/import/" class=""> import</a>
<a data-link href="../../../../../engine/reference/commandline/info/" class=""> info</a>
<a data-link href="../../../../../engine/reference/commandline/inspect/" class=""> inspect</a>
<a data-link href="../../../../../engine/reference/commandline/kill/" class=""> kill</a>
<a data-link href="../../../../../engine/reference/commandline/load/" class=""> load</a>
<a data-link href="../../../../../engine/reference/commandline/login/" class=""> login</a>
<a data-link href="../../../../../engine/reference/commandline/logout/" class=""> logout</a>
<a data-link href="../../../../../engine/reference/commandline/logs/" class=""> logs</a>
<a data-link href="../../../../../engine/reference/commandline/network_connect/" class=""> network connect</a>
<a data-link href="../../../../../engine/reference/commandline/network_create/" class=""> network create</a>
<a data-link href="../../../../../engine/reference/commandline/network_disconnect/" class=""> network disconnect</a>
<a data-link href="../../../../../engine/reference/commandline/network_inspect/" class=""> network inspect</a>
<a data-link href="../../../../../engine/reference/commandline/network_ls/" class=""> network ls</a>
<a data-link href="../../../../../engine/reference/commandline/network_rm/" class=""> network rm</a>
<a data-link href="../../../../../engine/reference/commandline/pause/" class=""> pause</a>
<a data-link href="../../../../../engine/reference/commandline/port/" class=""> port</a>
<a data-link href="../../../../../engine/reference/commandline/ps/" class=""> ps</a>
<a data-link href="../../../../../engine/reference/commandline/pull/" class=""> pull</a>
<a data-link href="../../../../../engine/reference/commandline/push/" class=""> push</a>
<a data-link href="../../../../../engine/reference/commandline/rename/" class=""> rename</a>
<a data-link href="../../../../../engine/reference/commandline/restart/" class=""> restart</a>
<a data-link href="../../../../../engine/reference/commandline/rm/" class=""> rm</a>
<a data-link href="../../../../../engine/reference/commandline/rmi/" class=""> rmi</a>
<a data-link href="../../../../../engine/reference/commandline/run/" class=""> run</a>
<a data-link href="../../../../../engine/reference/commandline/save/" class=""> save</a>
<a data-link href="../../../../../engine/reference/commandline/search/" class=""> search</a>
<a data-link href="../../../../../engine/reference/commandline/start/" class=""> start</a>
<a data-link href="../../../../../engine/reference/commandline/stats/" class=""> stats</a>
<a data-link href="../../../../../engine/reference/commandline/stop/" class=""> stop</a>
<a data-link href="../../../../../engine/reference/commandline/tag/" class=""> tag</a>
<a data-link href="../../../../../engine/reference/commandline/top/" class=""> top</a>
<a data-link href="../../../../../engine/reference/commandline/unpause/" class=""> unpause</a>
<a data-link href="../../../../../engine/reference/commandline/version/" class=""> version</a>
<a data-link href="../../../../../engine/reference/commandline/volume_create/" class=""> volume create</a>
<a data-link href="../../../../../engine/reference/commandline/volume_inspect/" class=""> volume inspect</a>
<a data-link href="../../../../../engine/reference/commandline/volume_ls/" class=""> volume ls</a>
<a data-link href="../../../../../engine/reference/commandline/volume_rm/" class=""> volume rm</a>
<a data-link href="../../../../../engine/reference/commandline/wait/" class=""> wait</a>
</div>
</article>
<a data-link href="../../../../../engine/reference/api/docker_io_accounts_api/" class=""> docker.io accounts API</a>
<article data-accordion>
<button data-control> Docker Remote API</button>
<div data-content>
<a data-link href="../../../../../engine/reference/api/docker_remote_api/" class=""> Remote API</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.21/" class=""> Remote API v1.21</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.20/" class=""> Remote API v1.20</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.19/" class=""> Remote API v1.19</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.18/" class=""> Remote API v1.18</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.17/" class=""> Remote API v1.17</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.16/" class=""> Remote API v1.16</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.15/" class=""> Remote API v1.15</a>
<a data-link href="../../../../../engine/reference/api/docker_remote_api_v1.14/" class=""> Remote API v1.14</a>
<a data-link href="../../../../../engine/reference/api/docker-io_api/" class=""> Docker Hub API</a>
</div>
</article>
<article data-accordion>
<button data-control> Docker Hub</button>
<div data-content>
<a data-link href="../../../../../engine/reference/api/hub_registry_spec/" class=""> The Docker Hub and the Registry v1</a>
</div>
</article>
<a data-link href="../../../../../docker-trusted-registry/api/dtr_api/" class=""> Docker Trusted Registry</a>
<article data-accordion>
<button data-control> Docker Compose Reference</button>
<div data-content>
<article data-accordion>
<button data-control> Compose CLI reference</button>
<div data-content>
<a data-link href="../../../../../compose/reference/overview/" class=""> Introduction to the CLI</a>
<a data-link href="../../../../../compose/reference/docker-compose/" class=""> docker-compose</a>
<a data-link href="../../../../../compose/reference/build/" class=""> build</a>
<a data-link href="../../../../../compose/reference/help/" class=""> help</a>
<a data-link href="../../../../../compose/reference/kill/" class=""> kill</a>
<a data-link href="../../../../../compose/reference/logs/" class=""> logs</a>
<a data-link href="../../../../../compose/reference/pause/" class=""> pause</a>
<a data-link href="../../../../../compose/reference/port/" class=""> port</a>
<a data-link href="../../../../../compose/reference/ps/" class=""> ps</a>
<a data-link href="../../../../../compose/reference/pull/" class=""> pull</a>
<a data-link href="../../../../../compose/reference/restart/" class=""> restart</a>
<a data-link href="../../../../../compose/reference/rm/" class=""> rm</a>
<a data-link href="../../../../../compose/reference/run/" class=""> run</a>
<a data-link href="../../../../../compose/reference/scale/" class=""> scale</a>
<a data-link href="../../../../../compose/reference/start/" class=""> start</a>
<a data-link href="../../../../../compose/reference/stop/" class=""> stop</a>
<a data-link href="../../../../../compose/reference/unpause/" class=""> unpause</a>
<a data-link href="../../../../../compose/reference/up/" class=""> up</a>
</div>
</article>
<a data-link href="../../../../../compose/compose-file/" class=""> Compose file reference</a>
<a data-link href="../../../../../compose/env/" class=""> Compose environment variables reference</a>
</div>
</article>
<article data-accordion>
<button data-control> Docker Machine Reference</button>
<div data-content>
<article data-accordion>
<button data-control> Drivers</button>
<div data-content>
<a data-link href="../../../../../machine/drivers/os-base/" class=""> Driver options and operating system defaults</a>
<a data-link href="../../../../../machine/drivers/aws/" class=""> Amazon Web Services</a>
<a data-link href="../../../../../machine/drivers/digital-ocean/" class=""> Digital Ocean</a>
<a data-link href="../../../../../machine/drivers/generic/" class=""> Generic</a>
<a data-link href="../../../../../machine/drivers/gce/" class=""> Google Compute Engine</a>
<a data-link href="../../../../../machine/drivers/soft-layer/" class=""> IBM Softlayer</a>
<a data-link href="../../../../../machine/drivers/azure/" class=""> Microsoft Azure</a>
<a data-link href="../../../../../machine/drivers/hyper-v/" class=""> Microsoft Hyper-V</a>
<a data-link href="../../../../../machine/drivers/openstack/" class=""> OpenStack</a>
<a data-link href="../../../../../machine/drivers/virtualbox/" class=""> Oracle VirtualBox</a>
<a data-link href="../../../../../machine/drivers/rackspace/" class=""> Rackspace</a>
<a data-link href="../../../../../machine/drivers/vm-fusion/" class=""> VMware Fusion</a>
<a data-link href="../../../../../machine/drivers/vm-cloud/" class=""> VMware vCloud Air</a>
<a data-link href="../../../../../machine/drivers/vsphere/" class=""> VMware vSphere</a>
<a data-link href="../../../../../machine/drivers/exoscale/" class=""> exoscale</a>
</div>
</article>
<article data-accordion>
<button data-control> Subcommands</button>
<div data-content>
<a data-link href="../../../../../machine/reference/active/" class=""> active</a>
<a data-link href="../../../../../machine/reference/config/" class=""> config</a>
<a data-link href="../../../../../machine/reference/create/" class=""> create</a>
<a data-link href="../../../../../machine/reference/env/" class=""> env</a>
<a data-link href="../../../../../machine/reference/help/" class=""> help</a>
<a data-link href="../../../../../machine/reference/inspect/" class=""> inspect</a>
<a data-link href="../../../../../machine/reference/ip/" class=""> ip</a>
<a data-link href="../../../../../machine/reference/kill/" class=""> kill</a>
<a data-link href="../../../../../machine/reference/ls/" class=""> ls</a>
<a data-link href="../../../../../machine/reference/regenerate-certs/" class=""> regenerate-certs</a>
<a data-link href="../../../../../machine/reference/restart/" class=""> restart</a>
<a data-link href="../../../../../machine/reference/rm/" class=""> rm</a>
<a data-link href="../../../../../machine/reference/scp/" class=""> scp</a>
<a data-link href="../../../../../machine/reference/ssh/" class=""> ssh</a>
<a data-link href="../../../../../machine/reference/start/" class=""> start</a>
<a data-link href="../../../../../machine/reference/status/" class=""> status</a>
<a data-link href="../../../../../machine/reference/stop/" class=""> stop</a>
<a data-link href="../../../../../machine/reference/upgrade/" class=""> upgrade</a>
<a data-link href="../../../../../machine/reference/url/" class=""> url</a>
</div>
</article>
</div>
</article>
<article data-accordion>
<button data-control> Docker Swarm Reference</button>
<div data-content>
<a data-link href="../../../../../swarm/api/swarm-api/" class=""> Docker Swarm API</a>
</div>
</article>
<article data-accordion>
<button data-control> Docker Registry Reference</button>
<div data-content>
<a data-link href="../../../../../registry/spec/api/" class=""> HTTP API V2</a>
<a data-link href="../../../../../registry/storagedrivers/" class=""> Storage Drivers</a>
<a data-link href="../../../../../registry/spec/auth/jwt/" class=""> Token Authentication Implementation</a>
<a data-link href="../../../../../registry/spec/auth/token/" class=""> Token Authentication Specification</a>
</div>
</article>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> Open Source at Docker</button>
<div data-content>
<a data-link href="../../../../../opensource/code/" class=""> Quickstart contribution</a>
<article data-accordion>
<button data-control> Set up for Engine Development</button>
<div data-content>
<a data-link href="../../../../../opensource/project/who-written-for/" class=""> README first</a>
<a data-link href="../../../../../opensource/project/software-required/" class=""> Get the required software</a>
<a data-link href="../../../../../opensource/project/software-req-win/" class=""> Set up for development on Windows</a>
<a data-link href="../../../../../opensource/project/set-up-git/" class=""> Configure Git for contributing</a>
<a data-link href="../../../../../opensource/project/set-up-dev-env/" class=""> Work with a development container</a>
<a data-link href="../../../../../opensource/project/test-and-docs/" class=""> Run tests and test documentation</a>
</div>
</article>
<article data-accordion>
<button data-control> Contribution workflow</button>
<div data-content>
<a data-link href="../../../../../opensource/workflow/make-a-contribution/" class=""> Understand how to contribute</a>
<a data-link href="../../../../../opensource/workflow/find-an-issue/" class=""> Find and claim an issue</a>
<a data-link href="../../../../../opensource/workflow/work-issue/" class=""> Work on your issue</a>
<a data-link href="../../../../../opensource/workflow/create-pr/" class=""> Create a pull request (PR)</a>
<a data-link href="../../../../../opensource/workflow/review-pr/" class=""> Participate in the PR review</a>
<a data-link href="../../../../../opensource/workflow/advanced-contributing/" class=""> Advanced contributing</a>
<a data-link href="../../../../../opensource/workflow/coding-style/" class=""> Coding style checklist</a>
</div>
</article>
<article data-accordion>
<button data-control> Other ways to contribute</button>
<div data-content>
<a data-link href="../../../../../opensource/ways/meetups/" class=""> Organize a Docker Meetup</a>
<a data-link href="../../../../../opensource/ways/issues/" class=""> Organize our issues</a>
<a data-link href="../../../../../opensource/ways/community/" class=""> Support the community</a>
<a data-link href="../../../../../opensource/ways/test/" class=""> Testing contributions</a>
</div>
</article>
<article data-accordion>
<button data-control> Governance</button>
<div data-content>
<a data-link href="../../../../../opensource/governance/dgab-info/" class=""> Docker Governance Advisory Board</a>
<a data-link href="../../../../../opensource/governance/board-profiles/" class=""> Board member profiles</a>
<a data-link href="../../../../../opensource/governance/conduct-code/" class=""> Code of conduct</a>
</div>
</article>
<a data-link href="../../../../../opensource/FAQ/" class=""> FAQ for contributors</a>
<a data-link href="../../../../../opensource/get-help/" class=""> Where to chat or get help</a>
<a data-link href="../../../../../opensource/doc-style/" class=""> Style guide for Docker documentation</a>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> About</button>
<div data-content>
<a data-link href="../../../../../release-notes/" class=""> Docker Release Notes</a>
<a data-link href="../../../../../engine/misc/faq/" class=""> FAQ</a>
<a data-link href="../../../../../engine/reference/glossary/" class=""> Docker Glossary</a>
</div>
</article>
</section>
<section data-accordion>
<article data-accordion>
<button data-control> Docs archive</button>
<div data-content>
<a data-link href="http://docs.docker.com/v1.7/" class=""> Version 1.7</a>
<a data-link href="http://docs.docker.com/v1.6/" class=""> Version 1.6</a>
<a data-link href="http://docs.docker.com/v1.5/" class=""> Version 1.5</a>
<a data-link href="http://docs.docker.com/v1.4/" class=""> Version 1.4</a>
</div>
</article>
</section>
</section>
<script>
$(document).ready(function () {
var $activeLink = $('#multiple [data-link].active');
var $accordions = $activeLink.parents('article[data-accordion]');
$($accordions.get().reverse()).each(function (index, accordion) {
var $accordion = $(accordion);
var $content = $accordion.find('[data-content]');
$accordion.addClass('open');
$content.css({'max-height': '100%'});
});
});
</script>
</div>
<div class="large-6 columns">
<section id="main">
<article id="content">
<h1 id="legacy-container-links">Legacy container links</h1>
<p>The information in this section explains legacy container links within the Docker default bridge. This is a <code>bridge</code> network named <code>bridge</code> created automatically when you install Docker.</p>
<p>Before the <a href="../../../../../engine/userguide/networking/dockernetworks/">Docker networks feature</a>, you could use the
Docker link feature to allow containers to discover each other and securely
transfer information about one container to another container. With the
introduction of the Docker networks feature, you can still create links but they
are only supported on the default <code>bridge</code> network named <code>bridge</code> and appearing
in your network stack as <code>docker0</code>.</p>
<p>This section briefly discuss connecting via a network port and then goes into
detail on container linking. While links are still supported on Docker&rsquo;s default
network (<code>bridge bridge</code>), you should avoid them in preference of the Docker
networks feature. Linking is expected to be deprecated and removed in a future
release.</p>
<h2 id="connect-using-network-port-mapping">Connect using network port mapping</h2>
<p>In <a href="../../../../../engine/userguide/usingdocker/">the Using Docker section</a>, you created a
container that ran a Python Flask application:</p>
<pre><code>$ docker run -d -P training/webapp python app.py
</code></pre>
<blockquote>
<p><strong>Note:</strong>
Containers have an internal network and an IP address
(as we saw when we used the <code>docker inspect</code> command to show the container&rsquo;s
IP address in the <a href="../../../../../engine/userguide/usingdocker/">Using Docker</a> section).
Docker can have a variety of network configurations. You can see more
information on Docker networking <a href="../../../../../engine/userguide/networking/">here</a>.</p>
</blockquote>
<p>When that container was created, the <code>-P</code> flag was used to automatically map
any network port inside it to a random high port within an <em>ephemeral port
range</em> on your Docker host. Next, when <code>docker ps</code> was run, you saw that port
5000 in the container was bound to port 49155 on the host.</p>
<pre><code>$ docker ps nostalgic_morse
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
bc533791f3f5 training/webapp:latest python app.py 5 seconds ago Up 2 seconds 0.0.0.0:49155-&gt;5000/tcp nostalgic_morse
</code></pre>
<p>You also saw how you can bind a container&rsquo;s ports to a specific port using
the <code>-p</code> flag. Here port 80 of the host is mapped to port 5000 of the
container:</p>
<pre><code>$ docker run -d -p 80:5000 training/webapp python app.py
</code></pre>
<p>And you saw why this isn&rsquo;t such a great idea because it constrains you to
only one container on that specific port.</p>
<p>Instead, you may specify a range of host ports to bind a container port to
that is different than the default <em>ephemeral port range</em>:</p>
<pre><code>$ docker run -d -p 8000-9000:5000 training/webapp python app.py
</code></pre>
<p>This would bind port 5000 in the container to a randomly available port
between 8000 and 9000 on the host.</p>
<p>There are also a few other ways you can configure the <code>-p</code> flag. By
default the <code>-p</code> flag will bind the specified port to all interfaces on
the host machine. But you can also specify a binding to a specific
interface, for example only to the <code>localhost</code>.</p>
<pre><code>$ docker run -d -p 127.0.0.1:80:5000 training/webapp python app.py
</code></pre>
<p>This would bind port 5000 inside the container to port 80 on the
<code>localhost</code> or <code>127.0.0.1</code> interface on the host machine.</p>
<p>Or, to bind port 5000 of the container to a dynamic port but only on the
<code>localhost</code>, you could use:</p>
<pre><code>$ docker run -d -p 127.0.0.1::5000 training/webapp python app.py
</code></pre>
<p>You can also bind UDP ports by adding a trailing <code>/udp</code>. For example:</p>
<pre><code>$ docker run -d -p 127.0.0.1:80:5000/udp training/webapp python app.py
</code></pre>
<p>You also learned about the useful <code>docker port</code> shortcut which showed us the
current port bindings. This is also useful for showing you specific port
configurations. For example, if you&rsquo;ve bound the container port to the
<code>localhost</code> on the host machine, then the <code>docker port</code> output will reflect that.</p>
<pre><code>$ docker port nostalgic_morse 5000
127.0.0.1:49155
</code></pre>
<blockquote>
<p><strong>Note:</strong>
The <code>-p</code> flag can be used multiple times to configure multiple ports.</p>
</blockquote>
<h2 id="connect-with-the-linking-system">Connect with the linking system</h2>
<p>Network port mappings are not the only way Docker containers can connect to one
another. Docker also has a linking system that allows you to link multiple
containers together and send connection information from one to another. When
containers are linked, information about a source container can be sent to a
recipient container. This allows the recipient to see selected data describing
aspects of the source container.</p>
<h3 id="the-importance-of-naming">The importance of naming</h3>
<p>To establish links, Docker relies on the names of your containers.
You&rsquo;ve already seen that each container you create has an automatically
created name; indeed you&rsquo;ve become familiar with our old friend
<code>nostalgic_morse</code> during this guide. You can also name containers
yourself. This naming provides two useful functions:</p>
<ol>
<li><p>It can be useful to name containers that do specific functions in a way
that makes it easier for you to remember them, for example naming a
container containing a web application <code>web</code>.</p></li>
<li><p>It provides Docker with a reference point that allows it to refer to other
containers, for example, you can specify to link the container <code>web</code> to container <code>db</code>.</p></li>
</ol>
<p>You can name your container by using the <code>--name</code> flag, for example:</p>
<pre><code>$ docker run -d -P --name web training/webapp python app.py
</code></pre>
<p>This launches a new container and uses the <code>--name</code> flag to
name the container <code>web</code>. You can see the container&rsquo;s name using the
<code>docker ps</code> command.</p>
<pre><code>$ docker ps -l
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
aed84ee21bde training/webapp:latest python app.py 12 hours ago Up 2 seconds 0.0.0.0:49154-&gt;5000/tcp web
</code></pre>
<p>You can also use <code>docker inspect</code> to return the container&rsquo;s name.</p>
<blockquote>
<p><strong>Note:</strong>
Container names have to be unique. That means you can only call
one container <code>web</code>. If you want to re-use a container name you must delete
the old container (with <code>docker rm</code>) before you can create a new
container with the same name. As an alternative you can use the <code>--rm</code>
flag with the <code>docker run</code> command. This will delete the container
immediately after it is stopped.</p>
</blockquote>
<h2 id="communication-across-links">Communication across links</h2>
<p>Links allow containers to discover each other and securely transfer information
about one container to another container. When you set up a link, you create a
conduit between a source container and a recipient container. The recipient can
then access select data about the source. To create a link, you use the <code>--link</code>
flag. First, create a new container, this time one containing a database.</p>
<pre><code>$ docker run -d --name db training/postgres
</code></pre>
<p>This creates a new container called <code>db</code> from the <code>training/postgres</code>
image, which contains a PostgreSQL database.</p>
<p>Now, you need to delete the <code>web</code> container you created previously so you can replace it
with a linked one:</p>
<pre><code>$ docker rm -f web
</code></pre>
<p>Now, create a new <code>web</code> container and link it with your <code>db</code> container.</p>
<pre><code>$ docker run -d -P --name web --link db:db training/webapp python app.py
</code></pre>
<p>This will link the new <code>web</code> container with the <code>db</code> container you created
earlier. The <code>--link</code> flag takes the form:</p>
<pre><code>--link &lt;name or id&gt;:alias
</code></pre>
<p>Where <code>name</code> is the name of the container we&rsquo;re linking to and <code>alias</code> is an
alias for the link name. You&rsquo;ll see how that alias gets used shortly.
The <code>--link</code> flag also takes the form:</p>
<pre><code>--link &lt;name or id&gt;
</code></pre>
<p>In which case the alias will match the name. You could have written the previous
example as:</p>
<pre><code>$ docker run -d -P --name web --link db training/webapp python app.py
</code></pre>
<p>Next, inspect your linked containers with <code>docker inspect</code>:</p>
<pre><code>$ docker inspect -f &quot;{{ .HostConfig.Links }}&quot; web
[/db:/web/db]
</code></pre>
<p>You can see that the <code>web</code> container is now linked to the <code>db</code> container
<code>web/db</code>. Which allows it to access information about the <code>db</code> container.</p>
<p>So what does linking the containers actually do? You&rsquo;ve learned that a link allows a
source container to provide information about itself to a recipient container. In
our example, the recipient, <code>web</code>, can access information about the source <code>db</code>. To do
this, Docker creates a secure tunnel between the containers that doesn&rsquo;t need to
expose any ports externally on the container; you&rsquo;ll note when we started the
<code>db</code> container we did not use either the <code>-P</code> or <code>-p</code> flags. That&rsquo;s a big benefit of
linking: we don&rsquo;t need to expose the source container, here the PostgreSQL database, to
the network.</p>
<p>Docker exposes connectivity information for the source container to the
recipient container in two ways:</p>
<ul>
<li>Environment variables,</li>
<li>Updating the <code>/etc/hosts</code> file.</li>
</ul>
<h3 id="environment-variables">Environment variables</h3>
<p>Docker creates several environment variables when you link containers. Docker
automatically creates environment variables in the target container based on
the <code>--link</code> parameters. It will also expose all environment variables
originating from Docker from the source container. These include variables from:</p>
<ul>
<li>the <code>ENV</code> commands in the source container&rsquo;s Dockerfile</li>
<li>the <code>-e</code>, <code>--env</code> and <code>--env-file</code> options on the <code>docker run</code>
command when the source container is started</li>
</ul>
<p>These environment variables enable programmatic discovery from within the
target container of information related to the source container.</p>
<blockquote>
<p><strong>Warning</strong>:
It is important to understand that <em>all</em> environment variables originating
from Docker within a container are made available to <em>any</em> container
that links to it. This could have serious security implications if sensitive
data is stored in them.</p>
</blockquote>
<p>Docker sets an <code>&lt;alias&gt;_NAME</code> environment variable for each target container
listed in the <code>--link</code> parameter. For example, if a new container called
<code>web</code> is linked to a database container called <code>db</code> via <code>--link db:webdb</code>,
then Docker creates a <code>WEBDB_NAME=/web/webdb</code> variable in the <code>web</code> container.</p>
<p>Docker also defines a set of environment variables for each port exposed by the
source container. Each variable has a unique prefix in the form:</p>
<p><code>&lt;name&gt;_PORT_&lt;port&gt;_&lt;protocol&gt;</code></p>
<p>The components in this prefix are:</p>
<ul>
<li>the alias <code>&lt;name&gt;</code> specified in the <code>--link</code> parameter (for example, <code>webdb</code>)</li>
<li>the <code>&lt;port&gt;</code> number exposed</li>
<li>a <code>&lt;protocol&gt;</code> which is either TCP or UDP</li>
</ul>
<p>Docker uses this prefix format to define three distinct environment variables:</p>
<ul>
<li>The <code>prefix_ADDR</code> variable contains the IP Address from the URL, for
example <code>WEBDB_PORT_5432_TCP_ADDR=172.17.0.82</code>.</li>
<li>The <code>prefix_PORT</code> variable contains just the port number from the URL for
example <code>WEBDB_PORT_5432_TCP_PORT=5432</code>.</li>
<li>The <code>prefix_PROTO</code> variable contains just the protocol from the URL for
example <code>WEBDB_PORT_5432_TCP_PROTO=tcp</code>.</li>
</ul>
<p>If the container exposes multiple ports, an environment variable set is
defined for each one. This means, for example, if a container exposes 4 ports
that Docker creates 12 environment variables, 3 for each port.</p>
<p>Additionally, Docker creates an environment variable called <code>&lt;alias&gt;_PORT</code>.
This variable contains the URL of the source container&rsquo;s first exposed port.
The &lsquo;first&rsquo; port is defined as the exposed port with the lowest number.
For example, consider the <code>WEBDB_PORT=tcp://172.17.0.82:5432</code> variable. If
that port is used for both tcp and udp, then the tcp one is specified.</p>
<p>Finally, Docker also exposes each Docker originated environment variable
from the source container as an environment variable in the target. For each
variable Docker creates an <code>&lt;alias&gt;_ENV_&lt;name&gt;</code> variable in the target
container. The variable&rsquo;s value is set to the value Docker used when it
started the source container.</p>
<p>Returning back to our database example, you can run the <code>env</code>
command to list the specified container&rsquo;s environment variables.</p>
<pre><code> $ docker run --rm --name web2 --link db:db training/webapp env
. . .
DB_NAME=/web2/db
DB_PORT=tcp://172.17.0.5:5432
DB_PORT_5432_TCP=tcp://172.17.0.5:5432
DB_PORT_5432_TCP_PROTO=tcp
DB_PORT_5432_TCP_PORT=5432
DB_PORT_5432_TCP_ADDR=172.17.0.5
. . .
</code></pre>
<p>You can see that Docker has created a series of environment variables with
useful information about the source <code>db</code> container. Each variable is prefixed
with
<code>DB_</code>, which is populated from the <code>alias</code> you specified above. If the <code>alias</code>
were <code>db1</code>, the variables would be prefixed with <code>DB1_</code>. You can use these
environment variables to configure your applications to connect to the database
on the <code>db</code> container. The connection will be secure and private; only the
linked <code>web</code> container will be able to talk to the <code>db</code> container.</p>
<h3 id="important-notes-on-docker-environment-variables">Important notes on Docker environment variables</h3>
<p>Unlike host entries in the <a href="#updating-the-etchosts-file"><code>/etc/hosts</code> file</a>,
IP addresses stored in the environment variables are not automatically updated
if the source container is restarted. We recommend using the host entries in
<code>/etc/hosts</code> to resolve the IP address of linked containers.</p>
<p>These environment variables are only set for the first process in the
container. Some daemons, such as <code>sshd</code>, will scrub them when spawning shells
for connection.</p>
<h3 id="updating-the-etc-hosts-file">Updating the <code>/etc/hosts</code> file</h3>
<p>In addition to the environment variables, Docker adds a host entry for the
source container to the <code>/etc/hosts</code> file. Here&rsquo;s an entry for the <code>web</code>
container:</p>
<pre><code>$ docker run -t -i --rm --link db:webdb training/webapp /bin/bash
root@aed84ee21bde:/opt/webapp# cat /etc/hosts
172.17.0.7 aed84ee21bde
. . .
172.17.0.5 webdb 6e5cdeb2d300 db
</code></pre>
<p>You can see two relevant host entries. The first is an entry for the <code>web</code>
container that uses the Container ID as a host name. The second entry uses the
link alias to reference the IP address of the <code>db</code> container. In addition to
the alias you provide, the linked container&rsquo;s name&ndash;if unique from the alias
provided to the <code>--link</code> parameter&ndash;and the linked container&rsquo;s hostname will
also be added in <code>/etc/hosts</code> for the linked container&rsquo;s IP address. You can ping
that host now via any of these entries:</p>
<pre><code>root@aed84ee21bde:/opt/webapp# apt-get install -yqq inetutils-ping
root@aed84ee21bde:/opt/webapp# ping webdb
PING webdb (172.17.0.5): 48 data bytes
56 bytes from 172.17.0.5: icmp_seq=0 ttl=64 time=0.267 ms
56 bytes from 172.17.0.5: icmp_seq=1 ttl=64 time=0.250 ms
56 bytes from 172.17.0.5: icmp_seq=2 ttl=64 time=0.256 ms
</code></pre>
<blockquote>
<p><strong>Note:</strong>
In the example, you&rsquo;ll note you had to install <code>ping</code> because it was not included
in the container initially.</p>
</blockquote>
<p>Here, you used the <code>ping</code> command to ping the <code>db</code> container using its host entry,
which resolves to <code>172.17.0.5</code>. You can use this host entry to configure an application
to make use of your <code>db</code> container.</p>
<blockquote>
<p><strong>Note:</strong>
You can link multiple recipient containers to a single source. For
example, you could have multiple (differently named) web containers attached to your
<code>db</code> container.</p>
</blockquote>
<p>If you restart the source container, the linked containers <code>/etc/hosts</code> files
will be automatically updated with the source container&rsquo;s new IP address,
allowing linked communication to continue.</p>
<pre><code>$ docker restart db
db
$ docker run -t -i --rm --link db:db training/webapp /bin/bash
root@aed84ee21bde:/opt/webapp# cat /etc/hosts
172.17.0.7 aed84ee21bde
. . .
172.17.0.9 db
</code></pre>
<h1 id="related-information">Related information</h1>
</article>
</section>
</div>
<div id="toc" class="large-3 columns toc ">
On this page:
<nav id="TableOfContents">
<ul>
<li><a href="#legacy-container-links">Legacy container links</a>
<ul>
<li><a href="#connect-using-network-port-mapping">Connect using network port mapping</a></li>
<li><a href="#connect-with-the-linking-system">Connect with the linking system</a>
<ul>
<li><a href="#the-importance-of-naming">The importance of naming</a></li>
</ul></li>
<li><a href="#communication-across-links">Communication across links</a>
<ul>
<li><a href="#environment-variables">Environment variables</a></li>
<li><a href="#important-notes-on-docker-environment-variables">Important notes on Docker environment variables</a></li>
<li><a href="#updating-the-etc-hosts-file">Updating the <code>/etc/hosts</code> file</a></li>
</ul></li>
</ul></li>
<li><a href="#related-information">Related information</a></li>
</ul>
</nav>
</div>
</div>
<footer class="main-footer">
<div class="row">
</div>
<div class="row">
</div>
<div id="buildinfo">
Nov 3, 2015 at 7:59pm (PST)
{
"docker/compose": {
"ref": "docs",
"repos": [
"git@github.com:docker/compose.git"
],
"sha": "9c8173dbfda93baef214359991b6a8a54172f6ae"
},
"docker/docker-hub": {
"ref": "master",
"repos": [
"git@github.com:docker/hub2-demo.git"
],
"sha": "4b2e522c81c860d63b126342a6b981ac0ff1605c"
},
"docker/docker-trusted-registry": {
"ref": "docs",
"repos": [
"git@github.com:docker/dhe-deploy.git"
],
"sha": "b8988465878952f2e2c2472e8fc5fd35e5975fbf"
},
"docker/docs-base": {
"ref": "hugo-github-linking",
"repos": [
"git@github.com:docker/docs-base.git"
],
"sha": "dc98c0381a6cc311c9e3189dc78a3c7e62e5a205"
},
"docker/engine": {
"ref": "master",
"repos": [
"git@github.com:docker/docker.git"
],
"sha": "474b16af8ecfe94ec635dfac60025348d3186aa3"
},
"docker/machine": {
"ref": "master",
"repos": [
"git@github.com:docker/machine.git"
],
"sha": "786437901c0c883ecb59c1e0531654c1d89b326d"
},
"docker/opensource": {
"ref": "master",
"repos": [
"git@github.com:docker/opensource.git"
],
"sha": "0cd99bcdd876ca0293d8944980c79f32064b6354"
},
"docker/registry": {
"ref": "master",
"repos": [
"git@github.com:docker/distribution.git"
],
"sha": "a9da0e510032314910b5405acc50873ab2fa2e5a"
},
"docker/swarm": {
"ref": "master",
"repos": [
"git@github.com:docker/swarm.git"
],
"sha": "087e2452f3ec474f112b4e5b8c52b8dacb5751be"
},
"docker/tutorials": {
"ref": "master",
"repos": [
"git@github.com:docker/tutorials.git"
],
"sha": "cb55d4de0df55e22f443aac664d66f092f06c56b"
},
"docs.docker.com": {
"ref": "refs/heads/1-9-release",
"repos": [
"git@github.com:moxiegirl/docs.docker.com.git",
"git@github.com:docker/docs.docker.com.git"
],
"sha": "5878eae5de6f012c67a2a4772327c9948274c351"
},
"kitematic/kitematic": {
"ref": "master",
"repos": [
"git@github.com:kitematic/kitematic.git"
],
"sha": "e533ed35d2eab31ce528675b0665f97516b4147b"
}
} </div>
</footer>
<link rel="stylesheet" href="../../../../../highlight/styles/github.css">
<script src="../../../../../highlight/highlight.pack.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script src="../../../../../dist/assets/js/all.js"></script>
<script>
$( 'nav li:has(ul)' ).doubleTapToGo();
</script>
<script>
;(function ( $, window, document, undefined ) {
var pluginName = 'accordion',
defaults = {
transitionSpeed: 300,
transitionEasing: 'ease',
controlElement: '[data-control]',
contentElement: '[data-content]',
groupElement: '[data-accordion-group]',
singleOpen: true
};
function Accordion(element, options) {
this.element = element;
this.options = $.extend({}, defaults, options);
this._defaults = defaults;
this._name = pluginName;
this.init();
}
Accordion.prototype.init = function () {
var self = this,
opts = self.options;
var $accordion = $(self.element),
$controls = $accordion.find('> ' + opts.controlElement),
$content = $accordion.find('> ' + opts.contentElement);
var accordionParentsQty = $accordion.parents('[data-accordion]').length,
accordionHasParent = accordionParentsQty > 0;
var closedCSS = { 'max-height': 0, 'overflow': 'hidden' };
var CSStransitions = supportsTransitions();
function debounce(func, threshold, execAsap) {
var timeout;
return function debounced() {
var obj = this,
args = arguments;
function delayed() {
if (!execAsap) func.apply(obj, args);
timeout = null;
};
if (timeout) clearTimeout(timeout);
else if (execAsap) func.apply(obj, args);
timeout = setTimeout(delayed, threshold || 100);
};
}
function supportsTransitions() {
var b = document.body || document.documentElement,
s = b.style,
p = 'transition';
if (typeof s[p] == 'string') {
return true;
}
var v = ['Moz', 'webkit', 'Webkit', 'Khtml', 'O', 'ms'];
p = 'Transition';
for (var i=0; i<v.length; i++) {
if (typeof s[v[i] + p] == 'string') {
return true;
}
}
return false;
}
function requestAnimFrame(cb) {
if(window.requestAnimationFrame || window.webkitRequestAnimationFrame || window.mozRequestAnimationFrame) {
return requestAnimationFrame(cb) ||
webkitRequestAnimationFrame(cb) ||
mozRequestAnimationFrame(cb);
} else {
return setTimeout(cb, 1000 / 60);
}
}
function toggleTransition($el, remove) {
if(!remove) {
$content.css({
'-webkit-transition': 'max-height ' + opts.transitionSpeed + 'ms ' + opts.transitionEasing,
'transition': 'max-height ' + opts.transitionSpeed + 'ms ' + opts.transitionEasing
});
} else {
$content.css({
'-webkit-transition': '',
'transition': ''
});
}
}
function calculateHeight($el) {
var height = 0;
$el.children().each(function() {
height = height + $(this).outerHeight(true);
});
$el.data('oHeight', height);
}
function updateParentHeight($parentAccordion, $currentAccordion, qty, operation) {
var $content = $parentAccordion.filter('.open').find('> [data-content]'),
$childs = $content.find('[data-accordion].open > [data-content]'),
$matched;
if(!opts.singleOpen) {
$childs = $childs.not($currentAccordion.siblings('[data-accordion].open').find('> [data-content]'));
}
$matched = $content.add($childs);
if($parentAccordion.hasClass('open')) {
$matched.each(function() {
var currentHeight = $(this).data('oHeight');
switch (operation) {
case '+':
$(this).data('oHeight', currentHeight + qty);
break;
case '-':
$(this).data('oHeight', currentHeight - qty);
break;
default:
throw 'updateParentHeight method needs an operation';
}
$(this).css('max-height', $(this).data('oHeight'));
});
}
}
function refreshHeight($accordion) {
if($accordion.hasClass('open')) {
var $content = $accordion.find('> [data-content]'),
$childs = $content.find('[data-accordion].open > [data-content]'),
$matched = $content.add($childs);
calculateHeight($matched);
$matched.css('max-height', $matched.data('oHeight'));
}
}
function closeAccordion($accordion, $content) {
$accordion.trigger('accordion.close');
if(CSStransitions) {
if(accordionHasParent) {
var $parentAccordions = $accordion.parents('[data-accordion]');
updateParentHeight($parentAccordions, $accordion, $content.data('oHeight'), '-');
}
$content.css(closedCSS);
$accordion.removeClass('open');
} else {
$content.css('max-height', $content.data('oHeight'));
$content.animate(closedCSS, opts.transitionSpeed);
$accordion.removeClass('open');
}
}
function openAccordion($accordion, $content) {
$accordion.trigger('accordion.open');
if(CSStransitions) {
toggleTransition($content);
if(accordionHasParent) {
var $parentAccordions = $accordion.parents('[data-accordion]');
updateParentHeight($parentAccordions, $accordion, $content.data('oHeight'), '+');
}
requestAnimFrame(function() {
$content.css('max-height', $content.data('oHeight'));
});
$accordion.addClass('open');
} else {
$content.animate({
'max-height': $content.data('oHeight')
}, opts.transitionSpeed, function() {
$content.css({'max-height': 'none'});
});
$accordion.addClass('open');
}
}
function closeSiblingAccordions($accordion) {
var $accordionGroup = $accordion.closest(opts.groupElement);
var $siblings = $accordion.siblings('[data-accordion]').filter('.open'),
$siblingsChildren = $siblings.find('[data-accordion]').filter('.open');
var $otherAccordions = $siblings.add($siblingsChildren);
$otherAccordions.each(function() {
var $accordion = $(this),
$content = $accordion.find(opts.contentElement);
closeAccordion($accordion, $content);
});
$otherAccordions.removeClass('open');
}
function toggleAccordion() {
var isAccordionGroup = (opts.singleOpen) ? $accordion.parents(opts.groupElement).length > 0 : false;
calculateHeight($content);
if(isAccordionGroup) {
closeSiblingAccordions($accordion);
}
if($accordion.hasClass('open')) {
closeAccordion($accordion, $content);
} else {
openAccordion($accordion, $content);
}
}
function addEventListeners() {
$controls.on('click', toggleAccordion);
$controls.on('accordion.toggle', function() {
if(opts.singleOpen && $controls.length > 1) {
return false;
}
toggleAccordion();
});
$(window).on('resize', debounce(function() {
refreshHeight($accordion);
}));
}
function setup() {
$content.each(function() {
var $curr = $(this);
if($curr.css('max-height') != 0) {
if(!$curr.closest('[data-accordion]').hasClass('open')) {
$curr.css({ 'max-height': 0, 'overflow': 'hidden' });
} else {
toggleTransition($curr);
calculateHeight($curr);
$curr.css('max-height', $curr.data('oHeight'));
}
}
});
if(!$accordion.attr('data-accordion')) {
$accordion.attr('data-accordion', '');
$accordion.find(opts.controlElement).attr('data-control', '');
$accordion.find(opts.contentElement).attr('data-content', '');
}
}
setup();
addEventListeners();
};
$.fn[pluginName] = function ( options ) {
return this.each(function () {
if (!$.data(this, 'plugin_' + pluginName)) {
$.data(this, 'plugin_' + pluginName,
new Accordion( this, options ));
}
});
}
})( jQuery, window, document );
$(document).ready(function() {
$('#multiple [data-accordion]').accordion({
singleOpen: false
});
});
</script>
<noscript>
<iframe src="//www.googletagmanager.com/ns.html?id=GTM-PSVHG8"
height="0" width="0" style="display:none;visibility:hidden"></iframe>
</noscript>
<script>
(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-PSVHG8');
</script>