Serviced is a PaaS runtime. It allows users to create, manage and scale services in a uniform way.
Serviced can run on a single host or across multiple hosts. First, serviced depends on docker.
-
Follow the instruction at http://www.docker.io/ , to install it on every host that serviced will run on. Ensure docker is running.
-
Install a generated package from http://jenkins.zendev.org/view/Control%20Plane/job/serviced_rpm . Or follow the steps below in the dev section to a source build.
-
Start the service. On ubuntu,
start serviced
There will be some delay the first time serviced is started before it is ready for user requests. You can track the output of serviced at /var/log/upstart/serviced.log.
- Browse the UI at http://localhost:8787
Serviced is a platform for running services. Serviced is composed of a master serviced process and agent processes running on each host. Each host must be registered with the master process. To register a agent process:
serviced add-host [HOSTNAME:PORT]
After the hosts are registered they must be placed in to a resource pool. This is done by first creating a pool:
serviced add-pool NAME CORE_LIMIT MEMORY_LIMIT PRIORITY
Serviced is written in go. To install go, download go v1.2 from http://golang.org. Untar the distribution to /usr/local/go. If you use a different location for go, you must set GOROOT. See the http://www.golang.org for more information. Ensure that $GOROOT/bin is in you path.
Add your development user to the "docker" group.
sudo usermod -G docker -a $USER
Ubuntu 13.x is the typical development environment. There are additional dependencies your install will need.
sudo apt-get install git mercurial libpam0g-dev apparmor-utils make
sudo aa-complain /usr/bin/lxc-start
With $GOROOT set and $GOROOT/bin in your $PATH, create a development workspace.
export GOPATH=~/mygo
export PATH="$PATH:$GOPATH/bin"
mkdir $GOPATH/{bin,pkg,src} -p
mkdir $GOPATH/src/github.com/zenoss -p
cd $GOPATH/src/github.com/zenoss
git clone git@github.com:control-center/serviced.git
cd serviced
make install
Setup HBASE
https://github.com/control-center/serviced/wiki/Single-node-HBASE-setup
After this, a binary should exist at $GOPATH/bin/serviced & $GOPATH/src/github.com/control-center/serviced/serviced. You can run the server with
serviced -agent -master