Awesome

BananaPeels

A framework for testing the deployement of packages via Munki wrapped in a CLI tool. Requires VMWare Fusion. Note: This is very early on in dev. Pull requests are welcome.

##Requires:

• VMWare Fusion
• OS X VM and configured snapshots
• Configured Munki repo to serve packages
• test_munki_client manifest in manifests directory of repository

##VM Configuration:

• Create an OS X VM with a test admin account (don't use a sensitive account name or password for this VM- the password must be specified in plaintext to communicate with vmrun)
• Stop Munki from attempting hourly runs in VM (we'll be running Munki manually and hourly runs can cause error when running tests)

sudo /bin/launchctl unload -w /Library/LaunchDaemons/com.googlecode.munki.managedsoftwareupdate-check.plist

• Install Munki and VMWare Tools to VM
• Configure VM client Munki to fetch from your Munki repository
• Configure VM client Munki to subscribe to test_munki_client manifest
• Add your admin account to sudoers file in VM

sudo visudo
# User privilege specification
...
root            ALL=(ALL) ALL
YOUR_ADMIN_USER ALL=(ALL) NOPASSWD: ALL
...

• Take snapshots to use for testing. Ex: My munkitools-1.x.x snapshot is titled "Munki1", my munkitools-2.x.x snapshot is title "Munki2"

##Details: BananaPeels is a framework for testing the deployement of packages via Munki wrapped up in a CLI for ease-of-use. BananaPeels works by using a baseline OS X VM snapshot as a fixture to download and install specified packages to via Munki. Any failures or errors in the download or install process are logged and returned to the user at the conclusion of the sequence of tests. Default behavior is to search the specified repo for all valid .pkginfo and .plist files and attempt to deploy the configured package for each to the VM test environment. If name-version pairs are provided via the optional "--only" argument then only packages found in the repo corresponding to those name-version pairs will be deployed.

##Usage:

python BananaPeels.py -h
usage: BananaPeels.py [-h] --repo PATH --vmx PATH --snapshot TITLE --user NAME 
		      --password PASSWORD 
		     [--only SomePkg-x.x.x [SomePkg-x.x.x ...]]

Command line tool for testing the download and install of Munki packages from
a specified repo.

optional arguments:
  -h, --help            show this help message and exit
  --repo PATH           Path to munki repo to test.
  --vmx PATH            Path to vmx file for VM to use for testing.
  --snapshot TITLE      Title of VM snapshot to use for testing.
  --user NAME           Shortname for admin account on VM.
  --password PASSWORD   Password for admin account on VM.
  --only SomePkg-x.x.x [SomePkg-x.x.x ...]
                        Optionally specify name-version of pkgs to test. If no
                        version specified defaults to latest. Packages
                        specified by only will be tested individually.

##Known Bugs

• vmrun is currently not able to communicate properly with OSX > 10.10.2 VMs. See: https://communities.vmware.com/message/2510106#2510106
• Occasionally Munki will fail with exit code 150 when run through vmrun. I believe this is due to a race condition where managedsoftwareupdate is being run on the VM before its network interfaces have been initialized after a snapshot revert. Exit codes from munkicommon.py can be found below:

# Preflight exit codes.
EXIT_STATUS_PREFLIGHT_FAILURE = 1  # Python crash yields 1.
# Client config exit codes.
EXIT_STATUS_OBJC_MISSING = 100
EXIT_STATUS_MUNKI_DIRS_FAILURE = 101
# Server connection exit codes.
EXIT_STATUS_SERVER_UNAVAILABLE = 150
# User related exit codes.
EXIT_STATUS_INVALID_PARAMETERS = 200
EXIT_STATUS_ROOT_REQUIRED = 201