Quick start

Install

The installation can be performed using Homebrew. Here’s how to add the MarathonLabs repository:

brew tap malinskiy/tap

Next, install the Marathon Cloud CLI:

brew install malinskiy/tap/marathon-cloud

Alternatively, you can download prebuild binaries for Windows, Linux, or MacOS from the Release page.

API Key

Token creation and management are available at the Tokens page. Generate a token and save it somewhere safe for the next step.

Samples (optional)

To showcase the advantages of Marathon Cloud compared to other solutions, we’ve prepared a sample app with 300 tests, out of which 15% are flaky. During the initial run, our platform will gather information about the tests. During the second run, it will optimize it to fit within 15 minutes.

Download prebuild iOS Application

curl https://cloud.marathonlabs.io/samples/ios/sample.zip -o sample.zip

Download prebuild iOS Test Application

curl https://cloud.marathonlabs.io/samples/ios/sampleUITests-Runner.zip -o sampleUITests-Runner.zip

Download prebuild Android Application

curl https://cloud.marathonlabs.io/samples/android/app.apk -o app.apk

Download prebuild Android Test Application

curl https://cloud.marathonlabs.io/samples/android/appTest.apk -o appTest.apk

To use your own applications please read Documentation.

Execution

Now you can start running your tests. Use the following command to execute the CLI with the necessary parameters:

export MARATHON_CLOUD_API_KEY=generated_api_key
marathon-cloud run ios --application sample.zip --test-application sampleUITests-Runner.zip

export MARATHON_CLOUD_API_KEY=generated_api_key
marathon-cloud run android --application app.apk --test-application appTest.apk

For additional parameters, refer to the marathon-cloud-cli README