Documentation 0.22.0 (latest) 0.21.0 0.20.0 0.19.1 0.19.0 0.18.1 0.18.0 0.17.0 0.16.0 0.15.0 0.14.0 0.13.0 0.12.0 0.11.0 0.10.0 0.9.0 0.8.0 0.7.0-incubating 0.6.0-incubating 0.5.0-incubating

Containers

Docker

Aurora has optional support for launching Docker containers, if correctly configured by an Operator.

Example (available in the Vagrant environment):

$ cat /vagrant/examples/jobs/docker/hello_docker.aurora
hello_world_proc = Process(
  name = 'hello',
  cmdline = """
    while true; do
      echo hello world
      sleep 10
    done
  """)

hello_world_docker = Task(
  name = 'hello docker',
  processes = [hello_world_proc],
  resources = Resources(cpu = 1, ram = 1*MB, disk=8*MB)
)

jobs = [
  Service(
    cluster = 'devcluster',
    environment = 'devel',
    role = 'docker-test',
    name = 'hello_docker',
    task = hello_world_docker,
    container = Container(docker = Docker(image = 'python:2.7'))
  )
]

In order to correctly execute processes inside a job, the docker container must have Python 2.7 installed. Further details of how to use Docker can be found in the Reference Documentation.

Mesos

Note: In order to use filesystem images with Aurora, you must be running at least Mesos 0.28.x

Aurora supports specifying a task filesystem image to use with the Mesos containerizer. This is done by setting the container property of the Job to a Mesos container object that includes the image to use. Both AppC and Docker images are supported.

job = Job(
   ...
   container = Mesos(image=DockerImage(name='my-image', tag='my-tag'))
   ...
)