terraform-cloud-function-api

Deploy a Node.js API on Google Cloud Functions using Terraform

Prerequisites

• terraform
• node (latest version supported by Cloud Functions)
• gcloud

Develop

1. Write your code on src/ and run:

# Run function locally
npm run dev

2. Write tests on test/

npm run test

Deploy

0. Create a Google Cloud account and set up Billing

1. Initialize the CLI

gcloud init

2. Create a new project

# Replace PROJECT_ID with your Project ID.
gcloud projects create PROJECT_ID --name="My App"

3. Set the project as default

gcloud config set project PROJECT_ID

4. Enable billing

# List billing accounts
gcloud beta billing accounts list

# Link a billing account to project
gcloud beta billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

5. Create the initial bucket

This bucket will store the .tfstate files.

gsutil mb gs://PROJECT_ID-tfstate

6. Rename terraform.tfvars.example

# Development
mv terraform/environments/development/terraform.tfvars.example terraform/environments/development/terraform.tfvars

# Production
mv terraform/environments/production/terraform.tfvars.example mv terraform/environments/production/terraform.tfvars

7. On terraform/, find and replace PROJECT_ID with your Project ID.

8. Deploy 🤞

# Development
cd terraform/environments/development

# Production
cd terraform/environments/production

terraform init
terraform plan
terraform apply

You will see the function URL at the end of the result.

Destroy

To shut everything down, run the following commands on this order:

# Delete all infrastructure
terraform destroy

# Optional: delete the project
gcloud projects delete PROJECT_ID

Troubleshooting

Deployment

When deploying for the first time, it can happen that Cloud Functions API and Cloud Build API are still being enabled and terraform apply will fail. Just wait a few minutes and run the command again.

License

MIT 2020 Ruan Martinelli