github.com/walkingsparrow/docker@v1.4.2-0.20151218153551-b708a2249bfa/docs/extend/plugins_network.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Docker network driver plugins"
     4  description = "Network driver plugins."
     5  keywords = ["Examples, Usage, plugins, docker, documentation, user guide"]
     6  [menu.main]
     7  parent = "mn_extend"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # Docker network driver plugins
    12  
    13  Docker network plugins enable Docker deployments to be extended to support a
    14  wide range of networking technologies, such as VXLAN, IPVLAN, MACVLAN or
    15  something completely different. Network driver plugins are supported via the
    16  LibNetwork project. Each plugin is implemented asa  "remote driver" for
    17  LibNetwork, which shares plugin infrastructure with Docker. Effectively,
    18  network driver plugins are activated in the same way as other plugins, and use
    19  the same kind of protocol.
    20  
    21  ## Using network driver plugins
    22  
    23  The means of installing and running a network driver plugin depend on the
    24  particular plugin. So, be sure to install your plugin according to the
    25  instructions obtained from the plugin developer.
    26  
    27  Once running however, network driver plugins are used just like the built-in
    28  network drivers: by being mentioned as a driver in network-oriented Docker
    29  commands. For example,
    30  
    31      $ docker network create --driver weave mynet
    32  
    33  Some network driver plugins are listed in [plugins](plugins.md)
    34  
    35  The `mynet` network is now owned by `weave`, so subsequent commands
    36  referring to that network will be sent to the plugin,
    37  
    38      $ docker run --net=mynet busybox top
    39  
    40  
    41  ## Write a network plugin
    42  
    43  Network plugins implement the [Docker plugin
    44  API](https://docs.docker.com/extend/plugin_api/) and the network plugin protocol
    45  
    46  ## Network plugin protocol
    47  
    48  The network driver protocol, in addition to the plugin activation call, is
    49  documented as part of libnetwork:
    50  [https://github.com/docker/libnetwork/blob/master/docs/remote.md](https://github.com/docker/libnetwork/blob/master/docs/remote.md).
    51  
    52  # Related Information
    53  
    54  To interact with the Docker maintainers and other interested users, see the IRC channel `#docker-network`.
    55  
    56  -  [Docker networks feature overview](../userguide/networking/index.md)
    57  -  The [LibNetwork](https://github.com/docker/libnetwork) project