README.md

SAS Viya 4 Infrastructure as Code (IaC) for Google Cloud

Overview

This project contains Terraform scripts to provision Google Cloud infrastructure resources required to deploy SAS Viya 4 platform products. Here is a list of resources this project can create -

• VPC Network and Network Firewalls
• Managed Google Kubernetes Engine (GKE) cluster
• System and User GKE Node pools with required Labels and Taints
• Infrastructure to deploy SAS Viya platform CAS in SMP or MPP mode
• Shared Storage options for SAS Viya platform - Google Filestore (ha) or NFS Server (standard)
• Google Cloud SQL for PostgreSQL instance, optional

Once the cloud resources are provisioned, see the viya4-deployment repository to deploy SAS Viya 4 platform products. If you need more information on the SAS Viya 4 platform products refer to the official SAS® Viya® platform Operations documentation for more details.

Prerequisites

Operational knowledge of

• Terraform
• Docker
• Google Cloud
• Kubernetes

Required

• Access to a Google Cloud "Project" with these API Services enabled.

• A Google Cloud Service Account.

• Terraform or Docker

  • Terraform

    • Terraform - v1.8.5
    • kubectl - v1.29.7
    • jq - v1.6
    • gcloud CLI - (optional - useful as an alternative to the Google Cloud Platform Portal) - v479.0.0
    • gke-gcloud-auth-plugin - (optional - only for provider based Kubernetes configuration files) - >= v1.26

  • Docker

    • Docker

Getting Started

Clone this project

Run these commands in a Terminal session:

# clone this repository
git clone https://github.com/sassoftware/viya4-iac-gcp

# move to directory
cd viya4-iac-gcp

Authenticating Terraform to access Google Cloud

See Terraform Google Cloud Authentication for details.

Customize Input Values

Create a file named terraform.tfvars to customize any input variable value documented in the CONFIG-VARS.md file. For starters, you can copy one of the provided example variable definition files in ./examples folder. For more details on the variables declared refer to the CONFIG-VARS.md file.

NOTE: You will need to update the cidr_blocks in the variables.tf file to allow traffic from your current network. Without these rules, access to the cluster will only be allowed via the Google Cloud Console.

When using a variable definition file other than terraform.tfvars, see Advanced Terraform Usage for additional command options.

Creating and Managing the Cloud Resources

Create and manage the Google Cloud resources by either

• using Terraform directly on your workstation, or
• using a Docker container.

Troubleshooting

See troubleshooting page.

Contributing

We welcome your contributions! Please read CONTRIBUTING.md for details on how to submit contributions to this project.

License

This project is licensed under the Apache 2.0 License.

Additional Resources

Google Cloud

• Google Cloud CLI - https://cloud.google.com/sdk/gcloud
• Terraform on Google Cloud - https://cloud.google.com/docs/terraform
• Terraform and Google Cloud Service Accounts - https://medium.com/@gmusumeci/how-to-create-a-service-account-for-terraform-in-gcp-google-cloud-platform-f75a0cf918d1
• GKE intro - https://cloud.google.com/kubernetes-engine

Terraform

• Google Provider - https://www.terraform.io/docs/providers/google/index.html
• Google GKE - https://www.terraform.io/docs/providers/google/r/container_cluster