Psoxy Deployment Example - GCP

This is a template repo for a Terraform configuration that deploys the Worklytics pseudonymization proxy (psoxy) on GCP.

Usage

Prereqs

You'll need:

• a Bash-like shell environment on Linux, MacOS, or WSL on Windows.
• git installed, although it is usually included on those platforms (check with git --version).
• an GCP project account and credentials, as described in Psoxy's Getting Started - GCP docs
• the prerequisites for Psoxy itself, although this example will attempt to help you check those

Setup

See GitHub's documentation for more details.

1. Click the 'Use this template' button in the upper right corner of this page.

   • choose a name for your copy of this repo
   • leave "Include all branches" unchecked

2. Clone the resulting repo to your machine. Example command below, just fill in your org and repo names.

git clone https://github.com/{{YOUR_ORG_ID}}/{{YOUR_REPO_NAME}}.git

3. Check your prereqs. Review versions and install anything needed.

./check-prereqs

4. Authenticate your tools as needed:

• auth GCloud CLI - gcloud auth login to authenticate, then gcloud auth list to verify you have expected account/user
• auth Azure CLI if using Microsoft 365 data sources - az login --allow-no-subscription to authenticate, then az account list to verify you have expected account/user

5. Initialize your configuration using our helper script. Follow the prompts.

./init

6. Review your terraform.tfvars file; customize as needed (eg, comment out data sources you don't need, verify configuration options).

7. Run terraform plan and review results to understand what will be created. Customize your terraform.tfvars or main.tf file if needed.

terraform plan

8. Run terraform apply to create the resources.

terraform apply