aboutsummaryrefslogtreecommitdiff
path: root/gae-interop-testing/README.md
blob: 1f9bea3648a8a4e65f135c6b4fbf554107e8034b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
Google App Engine interop tests
=====================================

This directory contains interop tests that runs in Google App Engine
as gRPC clients.

Prerequisites
==========================

- Install the Google Cloud SDK and ensure that `gcloud` is in the path
- Set up an [App Engine app](http://appengine.google.com) with your
  choice of a PROJECT_ID.
- Associate your `gcloud` environment with your app:
  ```bash
  # Log into Google Cloud
  $ gcloud auth login

  # Associate this codebase with a GAE project
  $ gcloud config set project PROJECT_ID
  ```

Running the tests in GAE
==========================

You can run the gradle task to execute the interop tests.
```bash
# cd into either gae-jdk7 or gae-jdk8
$ ./gradlew runInteropTestRemote

# Or run one of these from the root gRPC Java directory:
$ ./gradlew :grpc-gae-interop-testing-jdk7:runInteropTestRemote
$ ./gradlew :grpc-gae-interop-testing-jdk8:runInteropTestRemote
```

Optional:

You can also browse to `http://${PROJECT_ID}.appspot.google.com` to
see the result of the interop test.


Debugging
==========================

You can find the server side logs by logging into
`http://appengine.google.com` and scrolling down to the section titled
`Application Errors` and `Server Errors`.

Click on the `/` URI to view the log entries for each test run.