byronjkeith / viya4-iac-azure

This project contains Terraform configuration files to provision infrastructure components required to deploy SAS Viya 4+ VA/VS/VDMML products on Microsoft Azure Cloud.

SAS Viya 4 Infrastructure as Code (IaC) for Microsoft Azure

Overview

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

• Azure Resource Group(s): Primary Resource Group and AKS Resource Group
• Virtual Network, Network Security Groups and Network Security Rules
• Managed Azure Kubernetes Service (AKS) cluster
• System and User AKS Node pools with required Labels and Taints
• Infrastructure to deploy SAS Viya CAS in SMP or MPP mode
• Storage options for SAS Viya - AzureDisk/Files(dev) or NFS Server or Azure NetApp Files(HA)
• Azure DB for PostgreSQL, optional
• Azure Container Registry, optional

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

Prerequisites

Operational knowledge of:

• Terraform
• Docker
• Microsoft Azure Cloud
• Kubernetes

Technical Prerequisites:

This project supports running either via terraform installed on your local machine or via a docker container.

• Access to an Azure Subscription and Identity with 'Contributor' role

  • Terraform

    • Terraform - v0.13.6
    • kubectl - v1.18.8
    • jq - v1.6
    • Azure CLI - v2.19.1 (optional -useful as an alternative to the Azure Portal)

  • Docker

    • Docker

Getting Started

Clone this project

Run these commands in a Terminal session:

# clone this repo
git clone https://github.com/sassoftware/viya4-iac-azure

# move to directory
cd viya4-iac-azure

Authenticating Terraform to access Azure

See Terraform Azure Authentication for details.

Customize Input Values

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

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 cloud resources by either:

• running Terraform directly on your workstation, or
• running 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

Azure resources

• Azure CLI
• Terraform on Azure
• Configure Terraform access to Azure
• AKS intro
• Service Principal for AKS
• Create AKS using Terraform
• Azure Active Directory(AD) & Service Principal(SP) concepts

Terraform resources

• Azure Provider
• Azure AKS