Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zebrunner/mcloud
Mobile farm ecosystem for Android and iOS devices
https://github.com/zebrunner/mcloud
android androidtv ansible appium automation cloud devicefarm docker farm hub ios macos mobile openstf phone stf tablet testing tv tvos
Last synced: 2 days ago
JSON representation
Mobile farm ecosystem for Android and iOS devices
- Host: GitHub
- URL: https://github.com/zebrunner/mcloud
- Owner: zebrunner
- Created: 2019-07-26T11:16:48.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-15T11:13:09.000Z (3 months ago)
- Last Synced: 2025-01-12T07:07:15.528Z (9 days ago)
- Topics: android, androidtv, ansible, appium, automation, cloud, devicefarm, docker, farm, hub, ios, macos, mobile, openstf, phone, stf, tablet, testing, tv, tvos
- Language: Shell
- Homepage:
- Size: 294 KB
- Stars: 145
- Watchers: 10
- Forks: 21
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
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)](https://zebrunner.github.io/community-edition) ecosystem and can be used both for manual and automated testing.
* It is built on top of [OpenSTF](https://github.com/openstf) and supports iOS devices remote control.
Feel free to support the development with a [**donation**](https://www.paypal.com/donate/?hosted_button_id=MNHYYCYHAKUVA) for the next improvements.
## System requirements
### Hardware requirements
| | Requirements |
|:-----------------------: |------------------------------------------------------------------ |
| Operating System | Ubuntu 24.04
Linux CentOS 7+
Amazon Linux 2
MacOS |
| CPU | 4+ Cores |
| Memory | 16 Gb RAM |
| Free space | SSD 32Gb+ of free space |
### Software requirements
* Installed Docker v27+
* Installed Docker compose as a plugin
* Installed git 2.20.0+
## Usage
1. Clone [mcloud](https://github.com/zebrunner/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](https://github.com/zebrunner/mcloud-agent)
> [mcloud-ios](https://github.com/zebrunner/mcloud-ios) is deprecated. Use the same [mcloud-agent](https://github.com/zebrunner/mcloud-agent) to setup on MacOS too!
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](https://zebrunner.github.io/community-edition) to reuse MCloud components effectively for Test Automation.
## Components
* [mcloud-agent](https://github.com/zebrunner/mcloud-agent) - Device Farm agent for connecting physical Android and iOS devices including phones, tablets, and TVs via Linux or MacOS.
* [mcloud-device](https://github.com/zebrunner/mcloud-device) - Dockerized STF provider image for Android and iOS devices.
* [mcloud-grid](https://github.com/zebrunner/mcloud-grid) - Enhanced Selenium Grid for automating physical devices and emulators/simulators via Appium.
* [appium](https://github.com/zebrunner/appium) - Enhanced Appium image with low-level video recording and local storage for ipa/apk artifacts.
* [mcloud-redroid](https://github.com/zebrunner/mcloud-redroid) - GPU accelerated Android In Cloud solution
## Documentation and free support
* [Zebrunner PRO](https://zebrunner.com)
* [Zebrunner CE](https://zebrunner.github.io/community-edition)
* [Zebrunner Reporting](https://zebrunner.com/documentation)
* [Carina Guide](http://zebrunner.github.io/carina)
* [Demo Project](https://github.com/zebrunner/carina-demo)
* [Telegram Channel](https://t.me/zebrunner)
## License
Code - [Apache Software License v2.0](http://www.apache.org/licenses/LICENSE-2.0)
Documentation and Site - [Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/deed.en_US)