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.
| Requirements | |
|---|---|
| Operating System | Ubuntu 16.04 - 21.10 Linux CentOS 7+ Amazon Linux 2 |
| CPU | 4+ Cores |
| Memory | 16 Gb RAM |
| Free space | SSD 32Gb+ of free space |
-
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+
- Clone mcloud and set up:
git clone https://github.com/zebrunner/mcloud.git && cd mcloud && ./zebrunner.sh setupProvide valid protocol, hostname, and port
- Start services
./zebrunner.sh start - Open
http://hostname:80/stf - Log in using any name/email values as auth-mock is configured by default
- Goto Settings->Keys and generate new Access Token
- Paste generated token into the variables.env for
STF_TOKENvar - Restart services using
./zebrunner.sh restart - Set up the servers with Android and iOS devices according to mcloud-agent
mcloud-ios can be used to connect iOS devices via MacOS
- Use
http://hostname:80/mcloud/grid/consoleto see connected devices andhttp://hostname:80/mcloud/wd/hubas Selenium/Appium hub url for test automation.
Follow the installation and configuration guide in Zebrunner CE to reuse MCloud components effectively for Test Automation.
- 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.
Code - Apache Software License v2.0
Documentation and Site - Creative Commons Attribution 4.0 International License