Skip to content
Cloud Foundry - the open platform as a service project
Branch: master
Clone or download
Latest commit cc4259c Dec 12, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Run em-posix-spawn unit tests from warden test script Mar 8, 2016
em-posix-spawn
em-warden-client
warden-client
warden-protocol
warden
.gitignore
.ruby-version
CONTRIBUTING.md
LICENSE
NOTICE Update NOTICE Dec 12, 2016
README.md remove travis badges Aug 7, 2015
Vagrantfile

README.md

warden

Manages isolated, ephemeral, and resource controlled environments.

Introduction

The project's primary goal is to provide a simple API for managing isolated environments. These isolated environments -- or containers -- can be limited in terms of CPU usage, memory usage, disk usage, and network access. As of writing, the only supported OS is Linux.

Components

This repository contains the following components:

  • warden -- server
  • warden-protocol -- protocol definition, used by both the server and clients
  • warden-client -- client (Ruby)
  • em-warden-client -- client (Ruby's EventMachine)

For information on how to run the warden server and interact with it at the command line, see the warden server README.

Testing

Warden server tests are run automatically in a newly created container using a virtualbox image dynamically downloaded from s3.amazonaws.com/runtime-artifacts/warden-compatible.box.

# Checkout the repos
git clone https://github.com/cloudfoundry/warden

There is a .ruby-version file in the root of the repo which is copied into the created container filespace (along with the rest of the warden directory, with a few exceptions). The version in this file is that used in the container. This is pre-installed in the warden-compatible.box image.

To run bin/test_in_vm you need to have this exact same version of ruby installed locally.

# Run warden server tests
bin/test_in_vm

License

The project is licensed under the Apache 2.0 license (see the LICENSE file).

Contributing

Please read the contributors' guide.

You can’t perform that action at this time.