Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Automated Deployment of Lab Environments System (ADLES)

Project Description

Overview

Automated Deployment of Lab Environments System (ADLES)

ADLES automates the deterministic creation of virtualized environments for use in Cybersecurity and Information Technology (IT) education.
The system enables educators to easily build deterministic and portable environments for their courses, saving significant amounts of time and effort, and alieviates the requirement of possessing advanced IT knowledge.

Complete documentation can be found at ReadTheDocs: https://adles.readthedocs.io

Getting started

pip3 install adles
adles -h
adles --print-spec exercise
adles --print-spec infra
adles --list-examples
adles --print-example competition

Usage

Creating an environment using ADLES:

  • Read the exercise and infrastructure specifications and examples of them.
  • Write an infrastructure specification for your platform. (Currently, VMware vSphere is the only platform supported)
  • Write an exercise specification with the environment you want created.
  • Check its syntax, run the mastering phase, make your changes, and then run the deployment phase.
adles -c my-competition.yaml
adles -m -s my-competition.yaml
adles -d -s my-competition.yaml

System requirements

Python:

  • 3.4+ (Recommended)
  • 2.7.6+ (Will be deprecated in the future)

ADLES will run on any platform supported by Python. It has been tested on:

  • Windows 10 (Anniversary and Creators)
  • Ubuntu 14.04 and 16.04 (Including Bash on Ubuntu on Windows)
  • CentOS 7

Python packages

See requirements.txt for specific versions

  • pyvmomi
  • docopt
  • pyyaml
  • netaddr
  • colorlog
  • setuptools (If you are installing manually or developing)

Platforms

VMware vSphere

  • vCenter Server: 6.0+
  • ESXi: 6.0+

Contributing

Contributions are most definitely welcome! See TODO.md for a list of what needs to be done. Before submitting a pull request, do ensure you follow the general style and conventions used. Just read the code for a bit to get a feel for how things are done, and stay consistent with that.

If you have questions about the system, don’t hesitate to contact me by email or Twitter. (Email is in init.py, Twitter handle is same as GitHub).

Goals and TODO

The overall goal of ADLES is to create a easy to use and rock-solid system that allows instructors and students teaching using virtual environments to automate their workloads.

Long-term, I’d like to see the creation of a open-source repository, similiar to Hashicorp’s Atlas and Docker’s Hub, where educators can share packages and contribute to improving cyber education globally.

Main things on the radar (see TODO.md for full list):

  • User and group implementation for Vsphere
  • Post-phase cleanups
  • Result collection
  • Provisioners
  • Automated testing for utils and ideally Vsphere
  • Working Docker platform implementation
  • Implement a cloud platform interface, with Amazon AWS or Microsoft Azure being the easiest picks

License

This project is licensed under the Apache License, Version 2.0. See LICENSE for the full license text, and NOTICES for attributions to external projects that this project uses code from.

Project History

The system began as a proof of concept implementation of my Master’s thesis research at the University of Idaho in Fall of 2016. It was originally designed to run on the RADICL lab.

Release History

Release History

This version
History Node

1.3.5

History Node

1.3.4

History Node

1.3.2

History Node

1.3.1

History Node

1.3.0

History Node

1.2.0

History Node

1.1.9

History Node

1.1.8

History Node

1.1.7

History Node

1.1.6

History Node

1.1.5

History Node

1.1.4

History Node

1.1.3

History Node

1.1.2

History Node

1.1.1

History Node

1.1.0

History Node

1.0.5

History Node

1.0.4

History Node

1.0.3

History Node

0.13.10

History Node

0.13.9

History Node

0.13.8

History Node

0.13.7

History Node

0.13.6

History Node

0.13.5

History Node

0.13.4

History Node

0.13.3

History Node

0.13.2

History Node

0.13.1

History Node

0.13.0

History Node

0.12.4

History Node

0.12.3

History Node

0.12.1

History Node

0.12.0

History Node

0.11.4

History Node

0.11.3

History Node

0.11.2

History Node

0.11.1

History Node

0.11.0

History Node

0.10.4

History Node

0.10.3

History Node

0.10.2

History Node

0.10.1

History Node

0.10.0

History Node

0.9.2

History Node

0.9.1

History Node

0.9.0

History Node

0.8.2

History Node

0.8.1

History Node

0.8.0

History Node

0.7.17

History Node

0.7.16

History Node

0.7.15

History Node

0.7.14

History Node

0.7.13

History Node

0.7.12

History Node

0.7.11

History Node

0.7.10

History Node

0.7.9

History Node

0.7.8

History Node

0.7.7

History Node

0.7.6

History Node

0.7.5

History Node

0.7.4

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ADLES-1.3.5.tar.gz (70.6 kB) Copy SHA256 Checksum SHA256 Source Dec 14, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting