p34709852
/
monkey
forked from p15670423/monkey
1
0
Fork 1
Code Issues Pull Requests Projects Releases Wiki Activity
monkey/build_scripts
History
Mike Salvatore b8a5245c1b Build: Use `pipenv sync --system` instead of requirements.txt 
When pipenv dumps the lock file to a requirements.txt, it does not
include the `sys_platform` directive. This causes pip to attempt to
install win32 packages, which fails. By using `pypenv sync --system`
instead, only packages applicable to Linux are installed.

Fixes #1993
 		2022-06-09 11:15:07 -04:00
..
appimage Build: Use `pipenv sync --system` instead of requirements.txt 2022-06-09 11:15:07 -04:00
docker Build: Add cleanup function to build_package 2022-06-03 09:02:32 -04:00
README.md Build: Add warning about building an AppImage on LXD with shiftfs 2021-11-08 21:22:52 -05: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: Add cleanup function to build_package 2022-06-03 09:02:32 -04:00
common.sh Build: Run `npm run dev` on development build 2022-04-12 17:25:04 +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

  1. Create a clean VM or LXD (not docker!) based on Ubuntu 18.04.
  2. Copy the build_scipts/ directory to $HOME/ in the VM.
  3. On the VM, cd $HOME/build_scripts
  4. Run sudo -v.
  5. 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

WARNING: If you use a LXD container, ensure that shiftfs is disabled.

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

  1. Create a clean Ubuntu 18.04 VM (not WSL).
  2. Copy the build_scipts/ directory to $HOME/ in the VM.
  3. On the VM, cd $HOME/build_scripts
  4. Run sudo -v.
  5. 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.