Overview

The vagga.yaml has two sections:

  • containers – description of the containers
  • commands – a set of commands defined for the project

Containers

Example of one container defined:

containers:
  sphinx:
    setup:
    - !Ubuntu trusty
    - !Install [python-sphinx, make]

The YAML above defines a container named sphinx, which is built with two steps: download and unpack ubuntu trusty base image, and install install packages name python-sphinx, make inside the container.

Commands

Example of command defined:

commands:
  build-docs: !Command
    description: Build vagga documentation using sphinx
    container: sphinx
    work-dir: docs
    run: make

The YAML above defines a command named build-docs, which is run in container named sphinx, that is run in docs/ sub dir of project, and will run command make in container. So running:

> vagga build-docs html

Builds html docs using sphinx inside a container.

See commands for comprehensive description of how to define commands.