aboutsummaryrefslogtreecommitdiffhomepage
path: root/examples/pubsub/README
diff options
context:
space:
mode:
Diffstat (limited to 'examples/pubsub/README')
-rw-r--r--examples/pubsub/README30
1 files changed, 30 insertions, 0 deletions
diff --git a/examples/pubsub/README b/examples/pubsub/README
new file mode 100644
index 0000000000..b55083afc5
--- /dev/null
+++ b/examples/pubsub/README
@@ -0,0 +1,30 @@
+C++ Client implementation for Cloud Pub/Sub service
+(https://developers.google.com/apis-explorer/#p/pubsub/v1beta1/).
+
+"Google Cloud Pub/Sub" API needs to be enabled at
+https://console.developers.google.com/project to open the access for a client.
+Select the project name, select the "APIs" under "APIs & auth", and turn
+on "Google Cloud Pub/Sub" API.
+
+To run the client from Google Compute Engine (GCE), the GCE instance needs to
+be created with scope "https://www.googleapis.com/auth/cloud-platform" as below:
+
+gcloud compute instances create instance-name
+ --image debian-7 --scopes https://www.googleapis.com/auth/cloud-platform
+
+Google TLS cert is required to run the client, which can be downloaded from
+Chrome browser.
+
+To run the client from GCE:
+make pubsub_client
+GRPC_DEFAULT_SSL_ROOTS_FILE_PATH="Google TLS cert" bins/opt/pubsub_client
+ --project_id="your project id"
+
+A service account credential is required to run the client from other
+environments, which can be generated as a JSON key file from
+https://console.developers.google.com/project/. To run the client with a service
+account credential:
+
+GRPC_DEFAULT_SSL_ROOTS_FILE_PATH="Google TLS cert" bins/opt/pubsub_client
+ --project_id="your project id"
+ --service_account_key_file="absolute path to the JSON key file"