GCP-specific server setup instructions

These instructions are part of the instructions for Setting up upspinserver. Please make sure you have read that document first.

Build upspinserver-gcp and upspin-setupstorage-gcp

To use Google Cloud Storage fetch the gcp.upspin.io repository and use the upspinserver-gcp and upspin-setupstorage-gcp variants.

Fetch the repository and its dependencies:

local$ go get -d gcp.upspin.io/cmd/...

Install the upspin-setupstorage-gcp command:

local$ go install gcp.upspin.io/cmd/upspin-setupstorage-gcp

Build the upspinserver-gcp binary:

local$ GOOS=linux GOARCH=amd64 go build gcp.upspin.io/cmd/upspinserver-gcp

Create a Google Cloud Project

First create a Google Cloud Project and associated Billing Account by visiting the Cloud Console. See the corresponding documentation here and here for help. For the project name, we suggest you use a string similar to your domain. (We will use example-com.)

Then, install the Google Cloud SDK by following the official instructions.

Finally, use the gcloud tool to enable the required APIs:

local$ gcloud components install beta
local$ gcloud config set project example-com
local$ gcloud auth login
local$ gcloud beta services enable iam.googleapis.com
local$ gcloud beta services enable storage_api

Create a Google Cloud Storage bucket

Use the gcloud tool to obtain “application default credentials” so that the upspin setupstorage-gcp command can make changes to your Google Cloud Project:

local$ gcloud auth application-default login

Now use upspin setupstorage-gcp to create a storage bucket and an associated service account for accessing the bucket. Note that the bucket name must be globally unique among all Google Cloud Storage users, so it is prudent to include your domain name in the bucket name. (We will use example-com-upspin.)

local$ upspin setupstorage-gcp -domain=example.com -project=<project> example-com-upspin

It should produce output like this:

Service account "upspinstorage@example-com.iam.gserviceaccount.com" created.
Bucket "example-com-upspin" created.
You should now deploy the upspinserver binary and run 'upspin setupserver'.

Continue

You can now continue following the instructions in Setting up upspinserver.