README.md
1Google App Engine interop tests
2=====================================
3
4This directory contains interop tests that runs in Google App Engine
5as gRPC clients.
6
7Prerequisites
8==========================
9
10- Install the Google Cloud SDK and ensure that `gcloud` is in the path
11- Set up an [App Engine app](http://appengine.google.com) with your
12 choice of a PROJECT_ID.
13- Associate your `gcloud` environment with your app:
14 ```bash
15 # Log into Google Cloud
16 $ gcloud auth login
17
18 # Associate this codebase with a GAE project
19 $ gcloud config set project PROJECT_ID
20 ```
21
22Running the tests in GAE
23==========================
24
25You can run the gradle task to execute the interop tests.
26```bash
27# cd into either gae-jdk7 or gae-jdk8
28$ ../../gradlew runInteropTestRemote
29
30# Or run one of these from the root gRPC Java directory:
31$ ./gradlew :grpc-gae-interop-testing-jdk7:runInteropTestRemote
32$ ./gradlew :grpc-gae-interop-testing-jdk8:runInteropTestRemote
33```
34
35Optional:
36
37You can also browse to `http://${PROJECT_ID}.appspot.google.com` to
38see the result of the interop test.
39
40
41Debugging
42==========================
43
44You can find the server side logs by logging into
45`http://appengine.google.com` and scrolling down to the section titled
46`Application Errors` and `Server Errors`.
47
48Click on the `/` URI to view the log entries for each test run.
49
50