History

VakarisZ cebd41b264 Build: change docker container to set MONKEY_DOCKER_CONTAINER env var. This variable is needed because we can't prompt for data dir removal on docker like we do on other deployments Due to the fact that docker is not running interactively and user might be running on an old data dir if he uses volumes, we need special case for docker		2021-10-25 17:11:31 +03:00
..
appimage	Build: Refactor agent versioning	2021-10-21 12:19:08 -04:00
docker	Build: change docker container to set MONKEY_DOCKER_CONTAINER env var. This variable is needed because we can't prompt for data dir removal on docker like we do on other deployments	2021-10-25 17:11:31 +03:00
README.md	Build: Move final build artifact to dist/ directory	2021-07-28 07:53:33 -04:00
build_appimage.sh	Build: Add build_{appimage,docker}.sh wrapper scripts	2021-07-28 07:00:18 -04:00
build_docker.sh	Build: Add build_{appimage,docker}.sh wrapper scripts	2021-07-28 07:00:18 -04:00
build_package.sh	Build: Refactor commit id	2021-10-21 17:12:01 +02:00
common.sh	Build: Refactor commit id	2021-10-21 17:12:01 +02:00

README.md

Infection Monkey Linux Package Builder

About

This directory contains the necessary artifacts for building an Infection Monkey packages for Linux.

AppImage

Building an AppImage

Create a clean VM or LXC (not docker!) based on Ubuntu 18.04.
Copy the build_scipts/ directory to $HOME/ in the VM.
On the VM, cd $HOME/build_scripts
Run sudo -v.
Execute ./build_appimage.sh. This will pull all necessary dependencies and build the AppImage.

NOTE: This script is intended to be run from a clean VM. You can also manually remove build artifacts by running appimage/clean.sh

Running the AppImage

The build script will produce an AppImage executable named ./dist/Infection_Monkey-x86_64.AppImage. Simply execute this file and you're off to the races.

A new directory, $HOME/.monkey_island will be created to store runtime artifacts.

Docker

Building a Docker image

Create a clean Ubuntu 18.04 VM (not WSL).
Copy the build_scipts/ directory to $HOME/ in the VM.
On the VM, cd $HOME/build_scripts
Run sudo -v.
Execute ./build_docker.sh --package docker. This will pull all necessary dependencies and build the Docker image.

NOTE: This script is intended to be run from a clean VM. You can also manually remove build artifacts by running docker/clean.sh

Running the Docker Image

The build script will produce a .tgz file in ./dist/. See docker/DOCKER_README.md for instructions on running the docker image.