🛠 Google Cloud Setup Guide

This guide prepares your environment for deploying Cloudhopper functions to Google Cloud Functions with the gcp-terraform generator.

---

Google Cloud project

You need a Google Cloud project with billing enabled. Create one in the Google Cloud console if necessary and note its project ID.

---

Install the Google Cloud CLI

Follow the installation guide for your operating system, then sign in:

gcloud auth login
gcloud config set project <project-id>

---

Credentials for Terraform

Terraform's google provider can use a service account key file:

export GOOGLE_APPLICATION_CREDENTIALS="$HOME/keys/cloudhopper-deployer.json"
export GOOGLE_CLOUD_PROJECT="<project-id>"

Alternatively, for local experiments, use your own account through Application Default Credentials:

gcloud auth application-default login

The account needs permission to create Cloud Functions, storage buckets, API Gateway resources and, for scheduled functions, Cloud Scheduler jobs. Terraform reports any API that is not yet enabled in the project, together with the link to enable it.

---

Terraform variables

The generated main.tf in src/main/resources/deployment/gcp-terraform/ declares these variables:

Variable	Example
gcp_project_id	my-project-123
gcp_region	europe-west3
gcp_zone	europe-west3-a
project_name	my-cloudhopper-project
environment	dev
cloudscheduler_service_account_email	scheduler@my-project-123.iam.gserviceaccount.com

The last one is the service account Cloud Scheduler uses to call scheduled functions; it is only used if your project contains a @ScheduledTrigger.

Set the variables in the generated gcp.auto.tfvars, which Terraform loads automatically, or as environment variables (TF_VAR_gcp_project_id, …).

---

Next

Continue with the Quickstart, using the gcp-terraform profile.