#! /bin/bash # This script is meant to be used with a fresh clone of DetectionLab and # will fail to run if boxes have already been created or any of the steps # from the README have already been run followed. # Only MacOS and Linux are supported. # If you encounter issues, feel free to open an issue at # https://github.com/clong/DetectionLab/issues set -e print_usage() { echo "Usage: ./build.sh " exit 0 } check_packer_and_vagrant() { # Check for existence of Vagrant in PATH which vagrant > /dev/null if [ "$?" -ne 0 ]; then (>&2 echo "Vagrant was not found in your PATH.") (>&2 echo "Please correct this before continuing. Quitting.") exit 1 fi # Ensure Vagrant >= 2.0.0 if [ "$(vagrant --version | grep -o "[0-9]" | head -1)" -lt 2 ]; then (>&2 echo "WARNING: It is highly recommended to use Vagrant 2.0.0 or above before continuing") fi # Check for existence of Packer in PATH which packer > /dev/null if [ "$?" -ne 0 ]; then (>&2 echo "Packer was not found in your PATH.") (>&2 echo "Please correct this before continuing. Quitting.") (>&2 echo "Hint: sudo cp ./packer /usr/local/bin/packer; sudo chmod +x /usr/local/bin/packer") exit 1 fi } # Returns 0 if not installed or 1 if installed check_virtualbox_installed() { which VBoxManage > /dev/null if [ "$?" -eq 0 ]; then echo "1" else echo "0" fi } # Returns 0 if not installed or 1 if installed check_vmware_fusion_installed() { echo "$(ls /Applications | grep -ci 'VMware Fusion.app')" } # Returns 0 if not installed or 1 if installed check_vmware_vagrant_plugin_installed() { VAGRANT_VMWARE_PLUGIN_PRESENT=$(vagrant plugin list | grep -c 'vagrant-vmware-fusion') if [ $VAGRANT_VMWARE_PLUGIN_PRESENT -eq 0 ]; then (>&2 echo "VMWare Fusion is installed, but the Vagrant plugin is not.") (>&2 echo "Visit https://www.vagrantup.com/vmware/index.html#buy-now for more information on how to purchase and install it") (>&2 echo "VMWare Fusion will not be listed as a provider until the Vagrant plugin has been installed.") echo "0" else echo $VAGRANT_VMWARE_PLUGIN_PRESENT fi } # List the available Vagrant providers present on the system list_providers() { VBOX_PRESENT=0 VMWARE_FUSION_PRESENT=0 if [ $(uname) == "Darwin" ]; then # Detect Providers on OSX VBOX_PRESENT=$(check_virtualbox_installed) VMWARE_FUSION_PRESENT=$(check_vmware_fusion_installed) VAGRANT_VMWARE_PLUGIN_PRESENT=$(check_vmware_vagrant_plugin_installed) else # Assume the only other available provider is VirtualBox VBOX_PRESENT=$(check_virtualbox_installed) fi (>&2 echo "Available Providers:") if [ "$VBOX_PRESENT" == "1" ]; then (>&2 echo "virtualbox";) fi if [[ $VMWARE_FUSION_PRESENT -eq 1 ]] && [[ $VAGRANT_VMWARE_PLUGIN_PRESENT -eq 1 ]] then (>&2 echo "vmware_fusion";) fi if [[ $VBOX_PRESENT -eq 0 ]] && [[ $VMWARE_FUSION_PRESENT -eq 0 ]] then (>&2 echo "You need to install a provider such as VirtualBox or VMware Fusion to continue.") exit 1 fi (>&2 echo -e "\nWhich provider would you like to use?") read PROVIDER # Sanity check if [[ "$PROVIDER" != "virtualbox" ]] && [[ "$PROVIDER" != "vmware_fusion" ]] then (>&2 echo "Please choose a valid provider. \"$PROVIDER\" is not a valid option") exit 1 fi echo $PROVIDER } # A series of checks to identify potential issues before starting the build preflight_checks() { DL_DIR="$1" # Check to see if curl is in PATH which curl > /dev/null if [ "$?" -ne 0 ]; then (>&2 echo "Please install curl and make sure it is in your PATH.") exit 1 fi # Check to see if boxes exist already BOXES_BUILT=$(ls -al "$DL_DIR"/Boxes/*.box 2> /dev/null | wc -l) if [ $BOXES_BUILT -gt 0 ]; then (>&2 echo "You appear to have already built at least one box using Packer. This script does not support pre-built boxes. Please either delete the existing boxes or follow the build steps in the README to continue.") exit 1 fi # Check to see if any Vagrant instances exist already cd "$DL_DIR"/Vagrant/ VAGRANT_BUILT=$(vagrant status | grep -c 'not created') if [ $VAGRANT_BUILT -ne 4 ]; then (>&2 echo "You appear to have already created at least one Vagrant instance. This script does not support already created instances. Please either destroy the existing instances or follow the build steps in the README to continue.") exit 1 fi # Check available disk space. Recommend 80GB free, warn if less. FREE_DISK_SPACE=$(df -m $HOME | tr -s ' ' | grep '/' | cut -d ' ' -f 4) if [ $FREE_DISK_SPACE -lt 80000 ]; then (>&2 echo -e "Warning: You appear to have less than 80GB of HDD space free on your primary partition. If you are using a separate parition, you may ignore this warning.\n") (>&2 df -m $HOME) (>&2 echo "") fi # Check Packer version against known bad if [ "$(packer --version)" == '1.1.2' ]; then (>&2 echo "Packer 1.1.2 is not supported. Please upgrade to a newer version and see https://github.com/hashicorp/packer/issues/5622 for more information.") exit 1 fi # Ensure the vagrant-reload plugin is installed VAGRANT_RELOAD_PLUGIN_INSTALLED=$(vagrant plugin list | grep -c 'vagrant-reload') if [ "$VAGRANT_RELOAD_PLUGIN_INSTALLED" != "1" ]; then (>&2 echo "The vagrant-reload plugin is required and not currently installed. This script will attempt to install it now.") $(which vagrant) plugin install "vagrant-reload" if [ "$?" -ne 0 ]; then (>&2 echo "Unable to install the vagrant-reload plugin. Please try to do so manually and re-run this script.") exit 1 fi fi } # Builds a box using Packer packer_build_box() { PROVIDER="$1" BOX="$2" DL_DIR="$3" if [ "$PROVIDER" == "vmware_fusion" ]; then PROVIDER="vmware" fi cd "$DL_DIR/Packer" (>&2 echo "Using Packer to build the $BOX Box. This can take 90-180 minutes depending on bandwidth and hardware.") $(which packer) build --only="$PROVIDER-iso" $BOX.json if [ "$?" -ne 0 ]; then (>&2 echo "Something went wrong while attempting to build the $BOX box.") (>&2 echo "To file an issue, please visit https://github.com/clong/DetectionLab/issues/") fi } # Moves the boxes from the Packer directory to the Boxes directory move_boxes() { PROVIDER="$1" DL_DIR="$2" # Hacky workaround for VMware if [ "$PROVIDER" == "vmware_fusion" ]; then PROVIDER="vmware" fi mv "$DL_DIR"/Packer/*.box "$DL_DIR"/Boxes # Ensure Windows 10 box exists if [ ! -f "$DL_DIR"/Boxes/windows_10_"$PROVIDER".box ]; then (>&2 echo "Windows 10 box is missing from the Boxes directory. Qutting.") exit 1 fi # Ensure Windows 2016 box exists if [ ! -f "$DL_DIR"/Boxes/windows_2016_"$PROVIDER".box ]; then (>&2 echo "Windows 2016 box is missing from the Boxes directory. Qutting.") exit 1 fi } # Brings up a single host using Vagrant vagrant_up_host() { PROVIDER="$1" HOST="$2" DL_DIR="$3" (>&2 echo "Attempting to bring up the $HOST host using Vagrant") cd "$DL_DIR"/Vagrant $(which vagrant) up $HOST --provider="$PROVIDER" 1>&2 echo "$?" } # Attempts to reload and re-provision a host if the intial "vagrant up" fails vagrant_reload_host() { HOST="$1" DL_DIR="$2" cd "$DL_DIR"/Vagrant # Attempt to reload the host if the vagrant up command didn't exit cleanly $(which vagrant) reload $HOST --provision 1>&2 echo "$?" } # A series of checks to ensure important services are responsive after the build completes. post_build_checks() { # If the curl operation fails, we'll just leave the variable equal to 0 # This is needed to prevent the script from exiting if the curl operation fails CALDERA_CHECK=$(curl -ks -m 2 https://192.168.38.5:8888 | grep -c '302: Found' || echo "") SPLUNK_CHECK=$(curl -ks -m 2 https://192.168.38.5:8000/en-US/account/login?return_to=%2Fen-US%2F | grep -c 'This browser is not supported by Splunk' || echo "") FLEET_CHECK=$(curl -ks -m 2 https://192.168.38.5:8412 | grep -c 'Kolide Fleet' || echo "") BASH_MAJOR_VERSION=$(/bin/bash --version | grep 'GNU bash' | grep -o version\.\.. | cut -d ' ' -f 2 | cut -d '.' -f 1) # Associative arrays are only supported in bash 4 and up if [ "$BASH_MAJOR_VERSION" -ge 4 ]; then declare -A SERVICES SERVICES=( ["caldera"]="$CALDERA_CHECK" ["splunk"]="$SPLUNK_CHECK" ["fleet"]="$FLEET_CHECK") for SERVICE in "${!SERVICES[@]}" do if [ "${SERVICES[$SERVICE]}" -lt 1 ]; then (>&2 echo "Warning: $SERVICE failed post-build tests and may not be functioning correctly.") fi done else if [ "$CALDERA_CHECK" -lt 1 ]; then (>&2 echo "Warning: Caldera failed post-build tests and may not be functioning correctly.") fi if [ "$SPLUNK_CHECK" -lt 1 ]; then (>&2 echo "Warning: Splunk failed post-build tests and may not be functioning correctly.") fi if [ "$FLEET_CHECK" -lt 1 ]; then (>&2 echo "Warning: Fleet failed post-build tests and may not be functioning correctly.") fi fi } main() { # Get location of build.sh # https://stackoverflow.com/questions/59895/getting-the-source-directory-of-a-bash-script-from-within DL_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" PROVIDER="" LAB_HOSTS=("logger" "dc" "wef" "win10") # If no argument was supplied, list available providers if [ $# -eq 0 ]; then PROVIDER=$(list_providers) fi # If more than one argument was supplied, print usage message if [ $# -gt 1 ]; then print_usage exit 1 fi if [ $# -eq 1 ]; then # If the user specifies the provider as an agument, set the variable # TODO: Check to make sure they actually have their provider installed case "$1" in virtualbox) PROVIDER="$1" ;; vmware_fusion) PROVIDER="$1" ;; *) echo "\"$1\" is not a valid provider. Listing available providers:" PROVIDER=$(list_providers) ;; esac fi preflight_checks $DL_DIR packer_build_box $PROVIDER "windows_2016" $DL_DIR packer_build_box $PROVIDER "windows_10" $DL_DIR move_boxes $PROVIDER $DL_DIR # Change provider back to original selection if using vmware_fusion if [ "$PROVIDER" == "vmware" ]; then PROVIDER="vmware_fusion" fi # Vagrant up each box and attempt to reload one time if it fails for VAGRANT_HOST in "${LAB_HOSTS[@]}" do RET=$(vagrant_up_host $PROVIDER $VAGRANT_HOST $DL_DIR) if [ "$RET" -eq 0 ]; then (>&2 echo "Good news! $VAGRANT_HOST was built successfully!") fi # Attempt to recover if the intial "vagrant up" fails if [ "$RET" -ne 0 ]; then (>&2 echo "Something went wrong while attempting to build the $VAGRANT_HOST box.") (>&2 echo "Attempting to reload and reprovision the host...") RETRY_STATUS=$(vagrant_reload_host $VAGRANT_HOST $DL_DIR) if [ "$RETRY_STATUS" -ne 0 ]; then (>&2 echo "Failed to bring up $VAGRANT_HOST after a reload. Exiting.") exit 1 fi fi done post_build_checks } main $@ exit 0