Merge pull request googleapis#392 from GoogleCloudPlatform/tswast-bigtable-v2

Update Bigtable samples to v2.

Author: tswast

samples/hello/README.md

@@ -1,19 +1,75 @@
 # Cloud Bigtable Hello World
 
 This is a simple application that demonstrates using the [Google Cloud Client
-Library][gcloud-python] to connect to and interact with Cloud Bigtable.
+Library][gcloud-python-bigtable] to connect to and interact with Cloud Bigtable.
 
-[gcloud-python]: https://github.com/GoogleCloudPlatform/gcloud-python
+<!-- auto-doc-link -->
+These samples are used on the following documentation page:
 
+> https://cloud.google.com/bigtable/docs/samples-python-hello
 
-## Provision a cluster
+<!-- end-auto-doc-link -->
 
-Follow the instructions in the [user documentation](https://cloud.google.com/bigtable/docs/creating-cluster)
-to create a Google Cloud Platform project and Cloud Bigtable cluster if necessary.
-You'll need to reference your project ID, zone and cluster ID to run the application.
+[gcloud-python-bigtable]: https://googlecloudplatform.github.io/gcloud-python/stable/bigtable-usage.html
+[sample-docs]: https://cloud.google.com/bigtable/docs/samples-python-hello
 
 
-## Run the application
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents**
+
+- [Downloading the sample](#downloading-the-sample)
+- [Costs](#costs)
+- [Provisioning an instance](#provisioning-an-instance)
+- [Running the application](#running-the-application)
+- [Cleaning up](#cleaning-up)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+
+## Downloading the sample
+
+Download the sample app and navigate into the app directory:
+
+1.  Clone the [Python samples
+    repository](https://github.com/GoogleCloudPlatform/python-docs-samples), to
+    your local machine:
+
+        git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
+
+    Alternatively, you can [download the
+    sample](https://github.com/GoogleCloudPlatform/python-docs-samples/archive/master.zip)
+    as a zip file and extract it.
+
+2.  Change to the sample directory.
+
+        cd python-docs-samples/bigtable/hello
+
+
+## Costs
+
+This sample uses billable components of Cloud Platform, including:
+
++   Google Cloud Bigtable
+
+Use the [Pricing Calculator][bigtable-pricing] to generate a cost estimate
+based on your projected usage.  New Cloud Platform users might be eligible for
+a [free trial][free-trial].
+
+[bigtable-pricing]: https://cloud.google.com/products/calculator/#id=1eb47664-13a2-4be1-9d16-6722902a7572
+[free-trial]: https://cloud.google.com/free-trial
+
+
+## Provisioning an instance
+
+Follow the instructions in the [user
+documentation](https://cloud.google.com/bigtable/docs/creating-instance) to
+create a Google Cloud Platform project and Cloud Bigtable instance if necessary.
+You'll need to reference your project id and instance id to run the
+application.
+
+
+## Running the application
 
 First, set your [Google Application Default Credentials](https://developers.google.com/identity/protocols/application-default-credentials)
 
@@ -23,20 +79,29 @@ Install the dependencies with pip.
 $ pip install -r requirements.txt
 ```
 
-Run the application. Replace the command-line parameters with values for your cluster.
+Run the application. Replace the command-line parameters with values for your instance.
 
 ```
-$ python main.py my-project my-cluster us-central1-c
+$ python main.py my-project my-instance
 ```
 
 You will see output resembling the following:
 
 ```
-Create table Hello-Bigtable-1234
+Create table Hello-Bigtable
 Write some greetings to the table
 Scan for all greetings:
         greeting0: Hello World!
         greeting1: Hello Cloud Bigtable!
         greeting2: Hello HappyBase!
-Delete table Hello-Bigtable-1234
+Delete table Hello-Bigtable
 ```
+
+
+## Cleaning up
+
+To avoid incurring extra charges to your Google Cloud Platform account, remove
+the resources created for this sample.
+
+- [Delete the Cloud Bigtable
+  instance](https://cloud.google.com/bigtable/docs/deleting-instance).

samples/hello/main.py

@@ -29,17 +29,17 @@
 from gcloud import bigtable
 
 
-def main(project_id, cluster_id, zone, table_id):
+def main(project_id, instance_id, table_id):
     # [START connecting_to_bigtable]
     # The client must be created with admin=True because it will create a
     # table.
     with bigtable.Client(project=project_id, admin=True) as client:
-        cluster = client.cluster(zone, cluster_id)
+        instance = client.instance(instance_id)
         # [END connecting_to_bigtable]
 
         # [START creating_a_table]
         print('Creating the {} table.'.format(table_id))
-        table = cluster.table(table_id)
+        table = instance.table(table_id)
         table.create()
         column_family_id = 'cf1'
         cf1 = table.column_family(column_family_id)
@@ -107,13 +107,11 @@ def main(project_id, cluster_id, zone, table_id):
         formatter_class=argparse.ArgumentDefaultsHelpFormatter)
     parser.add_argument('project_id', help='Your Cloud Platform project ID.')
     parser.add_argument(
-        'cluster', help='ID of the Cloud Bigtable cluster to connect to.')
-    parser.add_argument(
-        'zone', help='Zone that contains the Cloud Bigtable cluster.')
+        'instance_id', help='ID of the Cloud Bigtable instance to connect to.')
     parser.add_argument(
         '--table',
         help='Table to create and destroy.',
         default='Hello-Bigtable')
 
     args = parser.parse_args()
-    main(args.project_id, args.cluster, args.zone, args.table)
+    main(args.project_id, args.instance_id, args.table)

samples/hello/main_test.py

@@ -33,8 +33,7 @@ def test_main(cloud_config, capsys):
         random.randrange(TABLE_NAME_RANGE))
     main(
         cloud_config.project,
-        cloud_config.bigtable_cluster,
-        cloud_config.bigtable_zone,
+        cloud_config.bigtable_instance,
         table_name)
 
     out, _ = capsys.readouterr()

samples/hello/requirements.txt

@@ -1 +1 @@
-gcloud[grpc]==0.16.0
+gcloud[grpc]==0.17.0