Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudfoundry-attic/warden
Cloud Foundry - the open platform as a service project
https://github.com/cloudfoundry-attic/warden
Last synced: 3 days ago
JSON representation
Cloud Foundry - the open platform as a service project
- Host: GitHub
- URL: https://github.com/cloudfoundry-attic/warden
- Owner: cloudfoundry-attic
- License: apache-2.0
- Archived: true
- Created: 2012-05-23T03:15:28.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2016-12-12T11:34:33.000Z (almost 8 years ago)
- Last Synced: 2024-10-30T16:04:02.923Z (12 days ago)
- Language: Ruby
- Size: 3 MB
- Stars: 283
- Watchers: 117
- Forks: 108
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-repos - cloudfoundry-attic/warden - Cloud Foundry - the open platform as a service project (Ruby)
README
# 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](warden/README.md).
## 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`.
```bash
# 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.
```bash
# Run warden server tests
bin/test_in_vm
```
## License
The project is licensed under the Apache 2.0 license (see the
[`LICENSE`][license] file).
[license]: /LICENSE
## Contributing
Please read the [contributors' guide](https://github.com/cloudfoundry/warden/blob/master/CONTRIBUTING.md).