Setup

New to the repo? Start here to get set up correctly.

Windows users — before proceeding, complete these two steps:

1. Enable Developer Mode: Settings -> System -> Advanced -> Developer Mode: On
2. Enable Symlinks: git config --global core.symlinks true

1. Google Cloud SDK

Install the Google Cloud SDK, then authenticate:

gcloud auth login
gcloud auth application-default login

Already have the SDK installed? You still need to run both commands above. The Terraform Google Provider requires Application Default Credentials to authenticate. Skipping this will cause provider authentication failures during plan and apply.

2. Google Group Access

You must be a member of sg-hb-infra-development@thehelperbees.com to run infrastructure builds.

Membership to this group allows the permission to perform Terraform actions. Without it, the build system will fail with a SecurityGroupMembershipRequired error.

Ask DevOps to add you to the group if you haven’t been added already.

3. Install

Download the Zig toolchain (works on both macOS and Windows):

./zig/download.ps1

Install all dependencies

./zig/zig build install