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](https://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 gae-jdk8
28$ ../../gradlew runInteropTestRemote
29
30# Or run one of these from the root gRPC Java directory:
31$ ./gradlew :grpc-gae-interop-testing-jdk8:runInteropTestRemote
32```
33
34Optional:
35
36You can also browse to `http://${PROJECT_ID}.appspot.google.com` to
37see the result of the interop test.
38
39
40Debugging
41==========================
42
43You can find the server side logs by logging into
44`http://appengine.google.com` and scrolling down to the section titled
45`Application Errors` and `Server Errors`.
46
47Click on the `/` URI to view the log entries for each test run.
48
49