Zombie Service Format
Last updated 4 years ago by asbjornenge .
BSD · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @zombiec0rn/zombie-service-format 
SYNC missed versions from official npm registry.

Zombie Service Format

Zombie Service Format (zsf) is the configuration format for zombie services.

The format describes services and their properties. The main purpose of this module is to provide tools and a validation schema for working with zombie services. It includes a JSON schema validator for the format.

The format is extensible so other modules can expand it's capabilities and semantics.


npm install --save @zombiec0rn/zombie-service-format


var zsf = require('@zombiec0rn/zombie-service-format')

try {
} catch(e) {
  console.log(e instanceof zsf.exception, e.trace)



The main usecase for this module is to validate service configs. See usage example above.

random(num, opts)

Generate random service configs. Useful for testing etc.

var zsf = require('@zombiec0rn/zombie-service-format')
var services = zsf.random(5, { host: { hostname: 'yolo' }})


The zsf json schema.


The zsf exception throws if bad config.


    "id"      : "app",                 // Service id
    "image"   : "megacorp/webapp",     // Image path
    "cmd"     : "python server.py",    // Command to run        (optional)
    "ports"   : ["80:80","53:53/udp"], // List of port mappings (optional)
    "env"     : ["FOO=BAR"],           // Environment variables (optional)
    "volumes" : ["/tmp:/tmp"],         // Service volumes       (optional)


The id, app in the example, is the service identifier. It can be any arbitrary string. No spaces.


The image, megacorp/webapp in the example, is URI to the service image. It can be any valid URI, relative or full.


The cmd, python server.py in the example, is the command to execute when running the service. It can be an arbitrary string.


The ports, ["80:80"] in the example, is a list of port mappings. A port mapping is defined using a string with two ports separated by a colon: "host-port:service-port" where host-port references a port on the host running the service, and the service-port references a port inside the running service. Zsf also support specifying the protocol; ["53:53/udp"]. The two supported protocols are tcp and udp.


The env, ["FOO=BAR"] in the example, is a list of environment variables. An evironment variable is defined using a string with a key and a value separated by a equals sign: "key=value".


The volumes, ["/tmp:/tmp"] in the example, is a list of volumes to mount inside the service. There are two different ways to specify a volume:

"/host/path:/service/path"  // Mounts a specified path on the host to the specified path in the service
"/host/path"                // Mounts a specified path on the host to the same path in the service



  • Initial release :tada:

Current Tags

  • 1.0.2                                ...           latest (4 years ago)

3 Versions

  • 1.0.2                                ...           4 years ago
  • 1.0.1                                ...           4 years ago
  • 1.0.0                                ...           4 years ago
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (5)
Dev Dependencies (0)

Copyright 2014 - 2016 © taobao.org |