README
¶
serviced
Serviced is a PaaS runtime. It allows users to create, manage and scale services in a uniform way.
Installation
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
sudo apt-key adv --keyserver keys.gnupg.net --recv-keys AA5A1AD7  REPO=http://get.zenoss.io/apt/ubuntu sudo sh -c 'echo "deb [ arch=amd64 ] '${REPO}' trusty universe"
> /etc/apt/sources.list.d/zenoss.list' sudo apt-get update sudo apt-get install -y servicedOr 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 https://localhost
Usage
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 host add HOST:PORT RESOURCE_POOL
Dev Environment
Serviced is written in go. To install go, download go v1.4 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 14.04 is the typical development environment. There are additional dependencies your install will need.
sudo apt-get install git mercurial libpam0g-dev make
With $GOROOT set and $GOROOT/bin in your $PATH, create a development workspace.
export GOPATH=~/mygo
export PATH="$PATH:$GOPATH/bin"
mkdir -p $GOPATH/{bin,pkg,src}
mkdir -p $GOPATH/src/github.com/control-center
cd $GOPATH/src/github.com/control-center
git clone git@github.com:control-center/serviced
# alternatively: git clone https://github.com/control-center/serviced
cd serviced
make
After this, a binary should exist at $GOPATH/bin/serviced & $GOPATH/src/github.com/control-center/serviced/serviced. You can run the server with
sudo serviced -master
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
acceptance
|
|
|
mockAgent
command
|
|
|
Package audit implements audit logging.
|
Package audit implements audit logging. |
|
cli
|
|
|
diet
Package diet provides an implementation of a Discrete Interval Encoding Tree.
|
Package diet provides an implementation of a Discrete Interval Encoding Tree. |
|
iptables
Simple iptables controller based on Docker's
|
Simple iptables controller based on Docker's |
|
This package exists merely to avoid circular imports.
|
This package exists merely to avoid circular imports. |
|
coordinator
|
|
|
Package domain contains graph config data objects for all domain objects
|
Package domain contains graph config data objects for all domain objects |
|
Package serviced - agent implements a service that runs on a serviced node.
|
Package serviced - agent implements a service that runs on a serviced node. |
|
Package proxy is used to create and register proxies that forward traffic from a port/ip combination, address, to a set of backends
|
Package proxy is used to create and register proxies that forward traffic from a port/ip combination, address, to a set of backends |
|
rpc
|
|
|
Package shell - Run serviced shells
|
Package shell - Run serviced shells |
|
Package stats collects serviced metrics and posts them to the TSDB.
|
Package stats collects serviced metrics and posts them to the TSDB. |
|
Empty package
|
Empty package |
|
serviced-storage
command
serviced-storage COMMAND ARGS
|
serviced-storage COMMAND ARGS |