fleet - a distributed init system
fleet ties together systemd and etcd into a distributed init system. Think of it as an extension of systemd that operates at the cluster level instead of the machine level. This project is very low level and is designed as a foundation for higher order orchestration.
Launching a unit with fleet is as simple as running
$ fleetctl start examples/hello.service Unit hello.service launched on 113f16a7.../172.17.8.103
fleetctl start command waits for the unit to get scheduled and actually start somewhere in the cluster.
fleetctl list-unit-files tells you the desired state of your units and where they are currently scheduled:
$ fleetctl list-unit-files UNIT HASH DSTATE STATE TMACHINE hello.service e55c0ae launched launched 113f16a7.../172.17.8.103
fleetctl list-units exposes the systemd state for each unit in your fleet cluster:
$ fleetctl list-units UNIT MACHINE ACTIVE SUB hello.service 113f16a7.../172.17.8.103 active running
Supported Deployment Patterns
- Deploy a single unit anywhere on the cluster
- Deploy a unit globally everywhere in the cluster
- Automatic rescheduling of units on machine failure
- Ensure that units are deployed together on the same machine
- Forbid specific units from colocation on the same machine (anti-affinity)
- Deploy units to machines only with specific metadata
These patterns are all defined using custom systemd unit options.
Before you can deploy units, fleet must be deployed and configured on each host in your cluster. (If you are running CoreOS, fleet is already installed.)
After you have machines configured (check
fleetctl list-machines), get to work with the client.
fleet must be built with Go 1.3+ on a Linux machine. Simply run
./build and then copy the binaries out of bin/ onto each of your machines. The tests can similarly be run by simply invoking
If you're on a machine without Go 1.3+ but you have Docker installed, run
./build-docker to compile the binaries instead.
The fleet API uses JSON over HTTP to manage units in a fleet cluster. See the API documentation for more information.
See the releases tab for more information on each release.
See CONTRIBUTING for details on submitting patches and contacting developers via IRC and mailing lists.
fleet is released under the Apache 2.0 license. See the LICENSE file for details.
Specific components of fleet use code derivative from software distributed under other licenses; in those cases the appropriate licenses are stipulated alongside the code.
The uuid package generates and inspects UUIDs.
|The uuid package generates and inspects UUIDs.|
Package activation implements primitives for systemd socket activation.
|Package activation implements primitives for systemd socket activation.|
Integration with the systemd D-Bus API.
|Integration with the systemd D-Bus API.|
Packet netlink provide access to low level Netlink sockets and messages.
|Packet netlink provide access to low level Netlink sockets and messages.|
Package dbus implements bindings to the D-Bus message bus system.
|Package dbus implements bindings to the D-Bus message bus system.|
Package introspect provides some utilities for dealing with the DBus introspection format.
|Package introspect provides some utilities for dealing with the DBus introspection format.|
Package prop provides the Properties struct which can be used to implement org.freedesktop.DBus.Properties.
|Package prop provides the Properties struct which can be used to implement org.freedesktop.DBus.Properties.|
Package ssh implements an SSH client and server.
|Package ssh implements an SSH client and server.|
Package agent implements a client to an ssh-agent daemon.
|Package agent implements a client to an ssh-agent daemon.|
Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems.
|Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems.|
This package contains integration tests for the code.google.com/p/go.crypto/ssh package.
|This package contains integration tests for the code.google.com/p/go.crypto/ssh package.|
Package googleapi contains the common code shared by all Google API libraries.
|Package googleapi contains the common code shared by all Google API libraries.|
Package uritemplates is a level 4 implementation of RFC 6570 (URI Template, http://tools.ietf.org/html/rfc6570).
|Package uritemplates is a level 4 implementation of RFC 6570 (URI Template, http://tools.ietf.org/html/rfc6570).|
Package transport contains HTTP transports used to make authenticated API requests.
|Package transport contains HTTP transports used to make authenticated API requests.|
Package schema provides access to the fleet API.
|Package schema provides access to the fleet API.|