#SocketPlane
Developers don't want to care about VLANs, VXLANs, Tunnels or TEPs. People responsible for managing the infra expect it to be performant and reliable. SocketPlane provides a networking abstraction at the socket-layer in order to solve the problems of the network in a manageable fashion.
This early release is just a peek at some of the things we are working on and releasing to the community as open source. As we are working upstream with the Docker community to bring in native support for network driver/plugin/extensions, we received a number of request to try the proposed socketplane solution with existing Docker versions. Hence we came up with a temporary wrapper command : socketplane that is used as a front-end to the docker CLI commands. This enables us to send hooks to the SocketPlane Daemon.
In this release we support the following features:
- Open vSwitch integration
- ZeroConf multi-host networking for Docker
- Elastic growth of a Docker/SocketPlane cluster
- Support for multiple networks
- Distributed IP Address Management (IPAM)
Overlay networking establishes tunnels between host endpoints, and in our case, those host endpoints are Open vSwitch. The advantage to this scenario is the user doesn't need to worry about subnets/vlans or any other layer 2 usage constraints. This is just one way to deploy container networking that we will be presenting. The importance of Open vSwitch is performance and the defacto APIs for advanced networking.
Our 'ZeroConf' technology is based on multicast DNS. This allows us to discover other SocketPlane cluster members on the same segment and to start peering with them. This allows us to elastically grow the cluster on demand by simply deploying another host - mDNS handles the rest. Since multicast availability is hit and miss in most networks, it is aimed at making it easy to deploy Docker and SocketPlane to start getting familiar with the exciting marriage of advanced, yet sane networking scenario with the exciting Docker use cases. We will be working with the community on other clustering technologies such as swarm that can be in used in conjunction to provide a more provisioning oriented clustering solutions.
Once we've discovered our neighbors, we're able to join an embedded [Consul] instance, giving us access to an eventually consistent key/value store for network state.
We support mutiple networks, to allow you to divide your containers in to subnets to ease the burden of enforcing firewall policy in the network.
Finally, we've implemented a distributed IP address management solution that enables non conflicting address assignment throughout a cluster.
Note: As we previously mentioned, it's not an ideal approach, but it allows people to start kicking the tyres as soon as possible. All of the functionality in
socketplane.shwill move in to our Golang core over time.
[ See Getting Started Demo Here ] ( https://www.youtube.com/watch?v=ukITRl58ntg )
[ See Socketplane with a LAMP Stack Demo Here ] ( https://www.youtube.com/watch?v=5uzUSk3NjD0 )
A Default Vagrant file has been provided to setup a a demo system. By default three Ubuntu 14.04 VM hosts will be installed each with an installed version of Socketplane.
You can change the number of systems created as follows:
export SOCKETPLANE_NODES=1
#or
export SOCKETPLANE_NODES=10
To start the demo systems:
git clone https://github.com/socketplane/socketplane
cd socketplane
vagrant up
The VM's are named socketplane-{n}, where n is a number from 1 to SOCKETPLANE_NODES || 3
Once the VM's are started you can ssh in as follows:
vagrant ssh socketplane-1
vagrant ssh socketplane-2
vagrant ssh socketplane-3
You can start Docker containters in each of the VM's and they will all be in a default network.
sudo socketplane run -itd ubuntu
You can also see the status of containers on a specific host VM by typing:
sudo socketplane info
If you want to create multiple networks you can do the following:
sudo socketplane network create web 10.2.0.0/16
sudo socketplane run -n web -itd ubuntu
You can list all the created networks with the following command:
sudo socketplane network list
For more options use the HELP command
sudo socketplane help
If you are not a vagrant user, please follow these instructions to install and deploy socketplane. While Golang, Docker and OVS can run on many operating systems, we are currently running tests and QA against Ubuntu and Fedora.
Note: If you are using Virtualbox, please take care of the following before proceeding with the installation :
-
Clustering over NAT adapter will not work. Hence, the Virtualbox VMs must have either Host-Only Adapter (or) Internal Network (or) Bridged adapter installed for clustering to work.
-
The VMs/Hosts must have unique hostname. Make sure that /etc/hosts in the VMs have the unique hostname updated.
Fist Node: curl -sSL http://get.socketplane.io/ | sudo BOOTSTRAP=true sh
Subsequent Nodes: curl -sSL http://get.socketplane.io/ | sudo sh
or
Fist Node:
wget -qO- http://get.socketplane.io/ | sudo BOOTSTRAP=true sh
Subsequent Nodes:
wget -qO- http://get.socketplane.io/ | sudo sh
Warning: The BOOTSTRAP=true should be used on the first node only. Without it, it won't work. If used on subsequent nodes, bad things will happen.
This should ideally start the Socketplane agent container as well. You can use sudo docker ps | grep socketplane command to check the status. If, the agent isnt already running, you can install it using the following command :
sudo socketplane install
Next start an image, for example a bash shell:
sudo socketplane run -i -t ubuntu /bin/bash
You can also see the status of containers on a specific host VM by typing:
sudo socketplane info
If you want to create multiple networks you can do the following:
sudo socketplane network create web 10.2.0.0/16
sudo socketplane run -n web -itd ubuntu
You can list all the created networks with the following command:
sudo socketplane network list
For more options use the HELP command
sudo socketplane help
The Socketplane agent runs in its own container and you might find the following commands useful :
-
Socketplane agent troubleshooting/debug logs :
sudo socketplane agent logs -
Socketplane agent stop :
sudo socketplane agent stop -
Socketplane agent start :
sudo socketplane agent start
Hacking uses the standard GitHub workflow which is made a lot easier by using hub
-
Clone this repository
git clone [email protected]:socketplane/socketplane -
Create a fork
hub fork -
Create a branch for your work
# For bugs git checkout -b bug/42 # For long-lived feature branches git checkout -b feature/something-cool -
Make your changes and commit
git add --all git commit -s -
Push your changes to your GitHub fork
git push <github-user> <branch-name> -
Raise a Pull Request
git pull-request
If you need to make changes to your pull request in response to commets etc...
-
Checkout your working branch
git checkout <branch-name> -
Make changes and then commit
git add --all git commit --amend git push --force
For bugs please file an issue. For any assistance, questions or just to say hi, please visit us on IRC, #socketplane at irc.freenode.net
Stay tuned for some exciting features coming soon from the SocketPlane team.
Copyright 2014 SocketPlane, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.Code is released under the Apache 2.0 license.