Upload AppMaps to AppLand

Step 1: Install command line tools

The AppLand Command Line application is distributed as a .tar.gz file archive.

Download the latest version of the AppLand Command Line Tools for Mac (Darwin), Linux, or Windows.

Mac and Linux users can unpack the archive by clicking on the downloaded package or using the tar -xzf path/to/file command. Windows users will need to use an archive manager to unpack the archive. We recommend 7Zip.

From inside the resulting directory you can execute appland commands. For example, entering the command appland help will display the help page.

$ appland help
Manage AppLand resources

Usage:
  appland [flags]
  appland [command]

Available Commands:
  context     Manage AppLand contexts
  help        Help about any command
  login       Login to AppLand
  logout      Log out of AppLand
  upload      Upload AppMap files to AppLand
...

To use the appland command from anywhere in your environment make sure the appland executable is available on your PATH.

Mac and Linux users may want to move the appland file to /usr/local/bin/appland.

Windows users will want to follow this procedure or one very similar tailored to the version of Windows they are running.

Step 2: Configure the API key

To begin, issue yourself a new API key.

You can do this on your Account settings page.

Step 3: Upload AppMaps to AppLand

Next, use the CLI to upload your AppMaps to AppLand . When you create AppMaps by running RSpec, the files are named *.appmap.json . Upload these files to AppLand by running appland upload .

When you record scenarios from Ruby RSpec tests, the AppMaps are written to the directory tmp/appmap/rspec . Upload them like this:

$ appland upload tmp/appmap/rspec/*
 100% |████████████████████████████████████████|  [10s:0s]

Success! AppLand has been updated with 21 scenarios.

When you record scenarios from Java JUnit tests, the AppMaps are written to the current directory. Upload them like this:

$ appland upload *.appmap.json
 100% |████████████████████████████████████████|  [10s:0s]

Success! AppLand has been updated with 21 scenarios.

When you run appland upload , your browser will open automatically to show your uploaded data.

You've now completed this tutorial!