This README serves as a quick start guide to deploy Zscaler Cloud Connector resources in an GCP cloud using Terraform. To learn more about the resources created when deploying Cloud Connector with Terraform, see Deployment Templates for Zscaler Cloud Connector.
Use this repository to create the deployment resources required to deploy and operate Cloud Connector in a new or existing virtual private cloud (VPC). The examples directory contains complete automation scripts for both greenfield/POV and brownfield/production use.
The GCP Terraform scripts leverage Terraform v1.1.9 which includes full binary and provider support for macOS M1 chips, but any Terraform version 0.13.7 should be generally supported.
- provider registry.terraform.io/hashicorp/google v5.11.x
- provider registry.terraform.io/hashicorp/random v3.3.x
- provider registry.terraform.io/hashicorp/local v2.2.x
- provider registry.terraform.io/hashicorp/null v3.1.x
- provider registry.terraform.io/providers/hashicorp/tls v3.4.x
- A valid GCP Administrator account to create a terraform service account with access to deploy required resources
- GCP service account json keyfile copied to examples/{deployment type}/credentials/
- GCP Region (E.g. us-central1)
- A valid Zscaler Cloud Connector provisioning URL generated from the Cloud Connector Portal
- Zscaler Cloud Connector Credentials (api key, username, password) are stored in GCP Secrets Manager
- If executing Terraform via the "zsec" wrapper bash script, it is advised that you run from a MacOS or Linux workstation. Minimum installed application requirements to successfully from the script are:
- bash
- curl
- unzip
Use this if you are building an entire cluster from the ground up. These templates include a bastion host and test workloads and are designed for greenfield/POV testing.
Use the Starter Deployment Template to deploy your Cloud Connector in a new VPC.
Use the Starter Deployment Template with ZPA to deploy your Cloud Connector in a new VPC with ZPA DNS zone forward resolver capability.
Use the Starter Deployment Template with ILB to deploy your Cloud Connector in a new VPC and to load balance traffic across multiple Cloud Connectors. Zscaler's recommended deployment method is Internal Load Balancer (ILB). ILB distributes traffic across multiple Cloud Connectors and achieves high availability.
Use the Starter Deployment Template with ILB and ZPA to deploy your Cloud Connector in a new VPC and to load balance traffic across multiple Cloud Connectors. Zscaler's recommended deployment method is Internal Load Balancer (ILB). ILB distributes traffic across multiple Cloud Connectors and achieves high availability. Also includes ZPA DNS zone forward resolver capability.
Brownfield deployment templates are most applicable for production deployments and have more customization options than a "base" deployment. They also do not include a bastion or workload hosts deployed. See Modules for the Terraform configurations for brownfield deployment.
Use the Custom Deployment Template with ILB to deploy your Cloud Connector in new or existing VPCs and load balance traffic across multiple Cloud Connectors. Zscaler's recommended deployment method is Internal Load Balancer (ILB). ILB distributes traffic across multiple Cloud Connectors and achieves high availability. Optionally includes ZPA DNS zone forward resolver capability.