gRPC for GCP extensions

Copyright 2018 The gRPC Authors

About This Repository

This repo is created to support GCP specific extensions for gRPC. To use the extension features, please refer to grpcio-gcp.

This repo also contains supporting infrastructures such as end2end tests and benchmarks for accessing cloud APIs with gRPC client libraries.

Testing

Download from github

 $ git clone https://github.com/GoogleCloudPlatform/grpc-gcp-python.git
 $ cd grpc-gcp-python
 $ git submodule update --init --recursive

Setup credentials. See Getting Started With Authentication for more details.

 $ export GOOGLE_APPLICATION_CREDENTIALS=path/to/key.json

Install the gRPC-GCP extension

 $ src/setup.sh

Install the gRPC-GCP extension test & benchmark suite

 $ tests/setup.sh

Run end to end integration tests.

 $ tests/integration.sh

Run end to end benchmark with gRPC-GCP extension.

 $ tests/benchmark.sh --gcp

Run end to end benchmark without gRPC-GCP extension. For comparison purspose.

 $ tests/benchmark.sh

Run grpc channel unit tests.

 $ tests/unit.sh

Run stress test against grpc client calls with weights.

 $ tests/stress.sh --gcp --weighted_cases 'list_sessions:100'