From 9dc9010490fbe44567b93d6f0fe3c03acbf739bd Mon Sep 17 00:00:00 2001 From: Vishal Banthia Date: Tue, 29 Dec 2015 14:15:58 +0900 Subject: [PATCH 1/3] DOCUMENTATION: Add storage-s3 sample unit in DEPLOYMENT doc --- doc/DEPLOYMENT.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/doc/DEPLOYMENT.md b/doc/DEPLOYMENT.md index 2c95aee6c2..9dd3902d72 100644 --- a/doc/DEPLOYMENT.md +++ b/doc/DEPLOYMENT.md @@ -629,6 +629,38 @@ ExecStart=/usr/bin/docker run --rm \ ExecStop=-/usr/bin/docker stop -t 10 %p ``` +### `stf-storage-s3@.service` + +If you want to store data such as screenshots and apk files into [Amazon S3](https://aws.amazon.com/s3/) instead of locally, then you can use this optional unit. Before using this you will need to setup your amazon account and get proper credentials for S3 bucket. You can read more about this at [AWS documentation](https://aws.amazon.com/s3/). + +** NOTE** If you are using this storage, you will not need [stf-storage-temp@.service](#stf-storage-tempservice) unit, since both do the same thing. Only the storage location is different. + +This is a template unit, meaning that you'll need to start it with an instance identifier. In this example configuration the identifier is used to specify the exposed port number (i.e. `stf-storage-s3@3500.service` runs on port 3500). Currently, **you cannot have more than one instance of this unit**, as both temporary files and an in-memory mapping is used. Using a template unit makes it easy to set the port. + +```ini +[Unit] +Description=STF s3 storage +After=docker.service +Requires=docker.service + +[Service] +EnvironmentFile=/etc/environment +TimeoutStartSec=0 +Restart=always +ExecStartPre=/usr/bin/docker pull openstf/stf:latest +ExecStartPre=-/usr/bin/docker kill %p-%i +ExecStartPre=-/usr/bin/docker rm %p-%i +ExecStart=/usr/bin/docker run --rm \ + --name %p-%i \ + -p %i:3000 \ + openstf/stf:latest \ + stf storage-s3 --port 3000 \ + --bucket YOUR_S3_BUCKET_NAME_HERE \ + --profile YOUR_AWS_CREDENTIALS_PROFILE \ + --endpoint YOUR_BUCKET_ENDPOING_HERE +ExecStop=-/usr/bin/docker stop -t 10 %p-%i +``` + ## Nginx configuration Now that you've got all the units ready, it's time to set up [nginx](http://nginx.org/) to tie all the processes together with a clean URL. From ae85736173f9142a80b929fc14987cf1a7d9ca02 Mon Sep 17 00:00:00 2001 From: Vishal Banthia Date: Tue, 29 Dec 2015 14:49:56 +0900 Subject: [PATCH 2/3] DOCUMENTATION: Add changelog for 1.1 from 1.0.10 --- CHANGELOG.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000000..de6175125f --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,15 @@ +## CHANGES IN VERSION 1.1 (from 1.0.10) + +Minor release addressing the following: + +### Enhancements +- Android 6.0 support +- Added translation support for Chinese, Korean, Russian and Spanish +- Added File Explorer feature in device controller where you can access device file system +- Added optional storage-s3 unit which can store storage data in Amazon S3 bucket instead of local +- Now, "Notes" column of device list is editable. +- Experimental armv7l support +- Added [stf-setup-examples](https://github.com/openstf/setup-examples) using [Vagrant](https://www.vagrantup.com/) and [Virtual Box](https://www.virtualbox.org/) + +### Fixes +- [DEPLOYMENT doc ](https://github.com/openstf/stf/blob/master/doc/DEPLOYMENT.md) fixes From d656b7bba05bc6d1e2131add3dd5c031fadb04a5 Mon Sep 17 00:00:00 2001 From: Vishal Banthia Date: Tue, 29 Dec 2015 15:01:42 +0900 Subject: [PATCH 3/3] 1.1.0 --- README.md | 11 +++++------ package.json | 2 +- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 23682d7cb5..f02f2410b2 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,6 @@ It is currently being used at [CyberAgent](https://www.cyberagent.co.jp/en/) to * OS support - Android * Supports versions 2.3.3 (SDK level 10) to 6.0 (SDK level 23) - - **Note: build from master for 6.0 support until 1.1.0 is out.** * Supports Wear 5.1 (but not 5.0 due to missing permissions) * Supports Fire OS, CyanogenMod, and other heavily Android based distributions * `root` is **not** required for any current functionality @@ -44,6 +43,7 @@ It is currently being used at [CyberAgent](https://www.cyberagent.co.jp/en/) to * Run any `adb` command locally, including shell access * [Android Studio](http://developer.android.com/tools/studio/index.html) and other IDE support, debug your app while watching the device screen on your browser * Supports [Chrome remote debug tools](https://developer.chrome.com/devtools/docs/remote-debugging) + - File Explorer to access device file system - Experimental VNC support (work in progress) * Manage your device inventory - See which devices are connected, offline/unavailable (indicating a weak USB connection), unauthorized or unplugged @@ -66,10 +66,9 @@ We're also actively working to expand the team. Welcome **@vbanthia** as our new Here are some things we are planning to address ASAP. 1. Properly expose the new VNC functionality in the UI -2. Release 1.1.0 so that we have stable version with Android 6.0 support -3. Implement a basic REST API for programmatically using devices -4. Properly reset user data between uses (Android 4.0+) -5. Automated scheduled restarts for devices +2. Implement a basic REST API for programmatically using devices +3. Properly reset user data between uses (Android 4.0+) +4. Automated scheduled restarts for devices ### Sponsors wanted @@ -91,7 +90,7 @@ As the product has evolved from an internal tool running in our internal network * [Node.js](https://nodejs.org/) >= 0.12 * [ADB](http://developer.android.com/tools/help/adb.html) properly set up -* [RethinkDB](http://rethinkdb.com/) >= 2.0.0 +* [RethinkDB](http://rethinkdb.com/) >= 2.2 * [GraphicsMagick](http://www.graphicsmagick.org/) (for resizing screenshots) * [ZeroMQ](http://zeromq.org/) libraries installed * [Protocol Buffers](https://github.com/google/protobuf) libraries installed diff --git a/package.json b/package.json index 547e50eda3..6b50b8c6cb 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "stf", - "version": "1.0.10", + "version": "1.1.0", "description": "Smartphone Test Farm", "keywords": [ "adb",