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