Make sure you have downloaded go (aka Golang) and that it is on your ${PATH}. After doing this, the Makefile will handle installing isolated dependencies to run this sample.

To list clusters run

make list_clusters

This consistently fails (at least with a service account). If you'd like to run it with a user account instead of a service account, you first will need to mint an account with

gcloud login

using the gcloud CLI tool. After doing this, you can use that token by adding a flag to the make command:

make list_clusters USE_APP_DEFAULT=True

To list tables in a cluster

make list_tables

This will need to be a cluster you have created (see "Creating a Cluster in the UI" below).

Finally, to create a table in an existing cluster, run

make list_tables_with_create

This will create a table named omg-finally. If you'd like to use a different table name, you can edit

tableName := "omg-finally"

in main_with_table_admin_and_create.go. However, the script is just for demonstration, so it shouldn't matter.

1. Visit Google Cloud Console

2. Either create a new project or visit an existing one

3. In the project, click "APIs & auth > APIs". The URI should be of the form

   https://console.developers.google.com/project/{project-id}/apiui/apis/library
   

4. On this page, search for bigtable, and click both Cloud Bigtable API and Cloud Bigtable Table Admin API.

5. For each API, click "Enable API" (if not already enabled)

1. Visit Google Cloud Console

2. Either create a new project or visit an existing one

3. In the project, click "APIs & auth > Credentials". The URI should be of the form

   https://console.developers.google.com/project/{project-id}/apiui/credential
   

4. On this page, click "Create new Client ID", select "Service account" as your "Application type" and then download the JSON key provided. The downloaded file should resemble keyfile.json.sample.

After downloading, move this key to the local directory holding this code.

1. Visit Google Cloud Console

2. Either create a new project or visit an existing one

3. In the project, click "Storage > Cloud Bigtable". The URI should be of the form

   https://console.developers.google.com/project/{project-id}/bigtable/clusters
   

4. On this page, click Create a cluster and take note of the "Cluster ID" and "Zone" you use when creating it.

You will need configuration for your own account and the code pulls this from consts.go.

1. Execute

   cp consts.go.sample consts.go

2. Edit consts.go to match your own project

   1. The ProjectID in consts.go to match the project ID in the project you used above. (Make sure you use the Project ID, not the Project Number)
   2. You may name ClusterID and Zone anything you like, but these should come from a cluster that already exists (see above for how to create a cluster).
   3. Change KeyFile to the path of the service account key file that you downloaded above.

This was previously a gist and has been updated here.