README.md
1 Google App Engine interop tests
2 =====================================
3
4 This directory contains interop tests that runs in Google App Engine
5 as gRPC clients.
6
7 Prerequisites
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
22 Running the tests in GAE
23 ==========================
24
25 You 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
35 Optional:
36
37 You can also browse to `http://${PROJECT_ID}.appspot.google.com` to
38 see the result of the interop test.
39
40
41 Debugging
42 ==========================
43
44 You 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
48 Click on the `/` URI to view the log entries for each test run.
49
50