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 alleviates the requirement of possessing advanced IT knowledge.

Complete documentation can be found at ReadTheDocs.

Publication describing the system.

Getting started

```bash

Install

pip3 install adles

Usage

adles -h

Specification syntax

adles --print-spec exercise adles --print-spec infra

Examples

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.

```bash

Validate spec

adles validate my-competition.yaml

Create Master images

adles masters my-competition.yaml

Deploy the exercise

adles deploy my-competition.yaml

Cleanup the environment

adles cleanup my-competition.yaml ```

Detailed usage

```bash usage: adles [-h] [--version] [-v] [--syslog SERVER] [--no-color] [--list-examples] [--print-spec NAME] [--print-example NAME] [-i INFRA] {validate,deploy,masters,package,cleanup} ...

Examples: adles --list-examples adles --print-example competition | adles validate - adles validate examples/pentest-tutorial.yaml adles masters examples/experiment.yaml adles -v deploy examples/experiment.yaml adles cleanup -t masters --cleanup-nets examples/competition.yaml adles validate -t infra examples/infra.yaml

optional arguments: -h, --help show this help message and exit --version show program's version number and exit -v, --verbose Emit debugging logs to terminal --syslog SERVER Send logs to a Syslog server on port 514 --no-color Do not color terminal output -i INFRA, --infra INFRA Override the infrastructure specification to be used

Print examples and specs: --list-examples Prints the list of available example scenarios --print-spec NAME Prints the named specification --print-example NAME Prints the named example

ADLES Subcommands: {validate,deploy,masters,package,cleanup} validate Validate the syntax of your specification deploy Environment deployment phase of specification masters Master creation phase of specification package Create a package cleanup Cleanup and remove existing environments ```

vSphere Utility Scripts

There are a number of utility scripts to make certain vSphere tasks bearable.

```bash

Basic usage

vsphere --help vsphere