-
-
Notifications
You must be signed in to change notification settings - Fork 120
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #805 from austyh/docs/cloud
docs(cloud): Added Marathon Cloud overview
- Loading branch information
Showing
6 changed files
with
7,068 additions
and
7,050 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
--- | ||
title: "Overview" | ||
--- | ||
|
||
import Tabs from '@theme/Tabs'; | ||
import TabItem from '@theme/TabItem'; | ||
|
||
Marathon Cloud is a cloud testing infrastructure built on top of the Marathon test runner. | ||
It automatically provisions virtual devices to accommodate your tests within 15 minutes. | ||
The test execution is then delegated to Marathon test runner, which handles tasks such as batching, | ||
sorting, preventive retries, and post-factum retries. | ||
This ensures an even distribution of tests across the provisioned devices. | ||
|
||
|
||
## What you'll need | ||
|
||
To utilize Marathon Cloud, please ensure you have the following: | ||
- Marathon Cloud account ([Sign up or Sign here](https://cloud.marathonlabs.io/signup)) | ||
- API Key: You can create an API Key by following the [link](https://cloud.marathonlabs.io/tokens) provided. | ||
- CLI or CI/CD plugin: Make sure you have the [Command Line Interface (CLI)](https://github.com/MarathonLabs/marathon-cloud-cli) or the appropriate Continuous Integration/Continuous Deployment (CI/CD) plugin installed. | ||
- Application with tests for iOS or Android | ||
|
||
## Application requirements | ||
|
||
### iOS | ||
|
||
Marathon Cloud supports tests written with XCTest and XCUITest frameworks. | ||
Both the application and the tests must be built for the ARM architecture. | ||
When dealing with iOS applications and tests, please compress them into ZIP archives. | ||
For instance, if your project is named "SampleApp," navigate to Product -> Show Build Folder in Finder. | ||
In the opened Finder window, you'll find the required folders/applications for testing: "SampleApp.app" for the application and "SampleAPPUITests-Runner.app" for the Testing Application. | ||
|
||
### Android | ||
|
||
Marathon Cloud supports tests written with UIAutomator, Cucumber, Espresso, and Kaspresso frameworks. | ||
You will need APK files for both the application and the tests. | ||
|
||
## Installation | ||
|
||
Please look at CLI [Readme on Github](https://github.com/MarathonLabs/marathon-cloud-cli). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,75 +1,83 @@ | ||
/** | ||
* Creating a sidebar enables you to: | ||
- create an ordered group of docs | ||
- render a sidebar for each doc of that group | ||
- provide next/previous navigation | ||
* Creating a sidebar enables you to: | ||
- create an ordered group of docs | ||
- render a sidebar for each doc of that group | ||
- provide next/previous navigation | ||
The sidebars can be generated from the filesystem, or explicitly defined here. | ||
The sidebars can be generated from the filesystem, or explicitly defined here. | ||
Create as many sidebars as you want. | ||
*/ | ||
Create as many sidebars as you want. | ||
*/ | ||
|
||
// @ts-check | ||
|
||
/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */ | ||
const sidebars = { | ||
docs: [ | ||
docs: [ | ||
{ | ||
type: 'category', | ||
label: 'Getting Started', | ||
collapsed: false, | ||
items: [ | ||
'index', | ||
'intro/overview', | ||
'intro/install', | ||
{ | ||
type: 'category', | ||
label: 'Getting Started', | ||
collapsed: false, | ||
items: [ | ||
'index', | ||
'intro/overview', | ||
'intro/install', | ||
{ | ||
type: 'category', | ||
label: 'Configuration', | ||
collapsed: true, | ||
items: [ | ||
'intro/configure', | ||
'configuration/filtering', | ||
'configuration/analytics', | ||
'configuration/pooling', | ||
'configuration/sharding', | ||
'configuration/sorting', | ||
'configuration/batching', | ||
'configuration/flakiness', | ||
'configuration/retries', | ||
'configuration/dynamic-configuration', | ||
] | ||
}, | ||
'intro/execute', | ||
'intro/reports', | ||
'intro/faq', | ||
'intro/vision', | ||
'intro/contribute', | ||
'intro/special-thanks', | ||
], | ||
type: 'category', | ||
label: 'Configuration', | ||
collapsed: true, | ||
items: [ | ||
'intro/configure', | ||
'configuration/filtering', | ||
'configuration/analytics', | ||
'configuration/pooling', | ||
'configuration/sharding', | ||
'configuration/sorting', | ||
'configuration/batching', | ||
'configuration/flakiness', | ||
'configuration/retries', | ||
'configuration/dynamic-configuration', | ||
] | ||
}, | ||
{ | ||
type: 'category', | ||
label: 'Android', | ||
collapsed: false, | ||
items: [ | ||
'android', | ||
'android/install', | ||
'android/configure', | ||
'android/examples', | ||
], | ||
}, | ||
{ | ||
type: 'category', | ||
label: 'iOS', | ||
collapsed: false, | ||
items: [ | ||
'ios', | ||
'ios/workers', | ||
'ios/configure', | ||
'ios/examples', | ||
], | ||
}, | ||
], | ||
'intro/execute', | ||
'intro/reports', | ||
'intro/faq', | ||
'intro/vision', | ||
'intro/contribute', | ||
'intro/special-thanks', | ||
], | ||
}, | ||
{ | ||
type: 'category', | ||
label: 'Android', | ||
collapsed: false, | ||
items: [ | ||
'android', | ||
'android/install', | ||
'android/configure', | ||
'android/examples', | ||
], | ||
}, | ||
{ | ||
type: 'category', | ||
label: 'iOS', | ||
collapsed: false, | ||
items: [ | ||
'ios', | ||
'ios/workers', | ||
'ios/configure', | ||
'ios/examples', | ||
], | ||
}, | ||
{ | ||
type: 'category', | ||
label: 'Cloud', | ||
collapsed: false, | ||
items: [ | ||
'cloud' | ||
] | ||
} | ||
], | ||
}; | ||
|
||
module.exports = sidebars; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.