moby--moby/experimental
Arnaud Porterie 7d193ef1f3 Add builtin nodes discovery
Use `pkg/discovery` to provide nodes discovery between daemon instances.

The functionality is driven by two different command-line flags: the
experimental `--cluster-store` (previously `--kv-store`) and
`--cluster-advertise`. It can be used in two ways by interested
components:

1. Externally by calling the `/info` API and examining the cluster store
   field. The `pkg/discovery` package can then be used to hit the same
   endpoint and watch for appearing or disappearing nodes. That is the
   method that will for example be used by Swarm.
2. Internally by using the `Daemon.discoveryWatcher` instance. That is
   the method that will for example be used by libnetwork.

Signed-off-by: Arnaud Porterie <arnaud.porterie@docker.com>
2015-09-25 14:52:09 -07:00
..
README.md Update the instructions for building experimental docker binaries 2015-09-16 13:18:32 -07:00
compose_swarm_networking.md ubuntu-14-10-x64 is not a valid image on digital ocean 2015-08-28 23:59:30 -07:00
network_overlay.md Add builtin nodes discovery 2015-09-25 14:52:09 -07:00
networking.md Change all docker -d to docker daemon 2015-08-10 20:48:08 +08:00
networking_api.md Initial Services docs 2015-06-20 11:04:25 -07:00
plugins_network.md Promote volume drivers from experimental to master. 2015-07-21 09:32:44 -07:00

README.md

Docker Experimental Features

This page contains a list of features in the Docker engine which are experimental. Experimental features are not ready for production. They are provided for test and evaluation in your sandbox environments.

The information below describes each feature and the GitHub pull requests and issues associated with it. If necessary, links are provided to additional documentation on an issue. As an active Docker user and community member, please feel free to provide any feedback on these features you wish.

Install Docker experimental

Unlike the regular Docker binary, the experimental channels is built and updated nightly on https://experimental.docker.com. From one day to the next, new features may appear, while existing experimental features may be refined or entirely removed.

  1. Verify that you have curl installed.

     $ which curl
    

    If curl isn't installed, install it after updating your manager:

     $ sudo apt-get update
     $ sudo apt-get install curl
    
  2. Get the latest Docker package.

     $ curl -sSL https://experimental.docker.com/ | sh
    

    The system prompts you for your sudo password. Then, it downloads and installs Docker and its dependencies.

    Note: If your company is behind a filtering proxy, you may find that the apt-key command fails for the Docker repo during installation. To work around this, add the key directly using the following:

      $ curl -sSL https://experimental.docker.com/gpg | sudo apt-key add -
    
  3. Verify docker is installed correctly.

     $ sudo docker run hello-world
    

    This command downloads a test image and runs it in a container.

Get the Linux binary

To download the latest experimental docker binary for Linux, use the following URLs:

https://experimental.docker.com/builds/Linux/i386/docker-latest

https://experimental.docker.com/builds/Linux/x86_64/docker-latest

After downloading the appropriate binary, you can follow the instructions here to run the docker daemon.

Note

  1. You can get the MD5 and SHA256 hashes by appending .md5 and .sha256 to the URLs respectively

  2. You can get the compressed binaries by appending .tgz to the URLs

Build an experimental binary

You can also build the experimental binary from the standard development environment by adding DOCKER_EXPERIMENTAL=1 to the environment where you run make to build Docker binaries. For example, to build a Docker binary with the experimental features enabled:

    $ DOCKER_EXPERIMENTAL=1 make binary

Current experimental features

How to comment on an experimental feature

Each feature's documentation includes a list of proposal pull requests or PRs associated with the feature. If you want to comment on or suggest a change to a feature, please add it to the existing feature PR.

Issues or problems with a feature? Inquire for help on the #docker IRC channel or in on the Docker Google group.