Zebrunner MCloud

Zebrunner MCloud is a Device Farm for automated test execution (Appium) and remote web access by humans to physical devices (Android and iOS) including phones, tablets, and TVs. It is fully integrated into the Zebrunner (Community Edition) ecosystem and can be used both for manual and automated testing.

• It is built on top of OpenSTF and supports iOS devices remote control.

Feel free to support the development with a donation for the next improvements.

System requirements

Hardware requirements

Software requirements

• Install docker (Ubuntu 16.04, Ubuntu 18.04, Ubuntu 20.04, Amazon Linux 2, Redhat/Cent OS)

• Install docker-composer 1.25.5+

• Install git 2.20.0+

Usage

1. Clone mcloud and set up:

   git clone https://github.com/zebrunner/mcloud.git && cd mcloud && ./zebrunner.sh setup
   

   Provide valid protocol, hostname, and port

2. Start services ./zebrunner.sh start
3. Open http://hostname:80/stf
4. Log in using any name/email values as auth-mock is configured by default
5. Goto Settings->Keys and generate new Access Token
6. Paste generated token into the variables.env for STF_TOKEN var
7. Restart services using ./zebrunner.sh restart
8. Set up the servers with Android and iOS devices according to mcloud-agent

   mcloud-ios can be used to connect iOS devices via MacOS

9. Use http://hostname:80/mcloud/grid/console to see connected devices and http://hostname:80/mcloud/wd/hub as Selenium/Appium hub url for test automation.

Follow the installation and configuration guide in Zebrunner CE to reuse MCloud components effectively for Test Automation.

Components

• mcloud-agent - Device Farm agent for connecting physical Android and iOS devices including phones, tablets, and TVs via Linux.
• mcloud-ios - Device Farm agent for connecting physical iOS devices including phones, tablets, and TVs via Mac.

  Support of simulators coming soon

• mcloud-device - Dockerized STF provider image for Android and iOS devices.
• mcloud-grid - Enhanced Selenium Grid for automating physical devices and emulators/simulators via Appium.
• appium - Enhanced Appium image with low-level video recording and local storage for ipa/apk artifacts.

Documentation and free support

• Zebrunner PRO
• Zebrunner CE
• Zebrunner Reporting
• Carina Guide
• Demo Project
• Telegram Channel

License

Code - Apache Software License v2.0

Documentation and Site - Creative Commons Attribution 4.0 International License