This project contains Terraform scripts to provision the AWS cloud infrastructure resources that are required to deploy SAS Viya 4 product offerings. Here is a list of resources that this project can create:
- Amazon VPC and Security Group
- Managed Amazon Elastic Kubernetes Service (EKS)
- Self-managed node groups with required labels and taints
- Infrastructure to deploy the SAS Viya CAS server in SMP or MPP mode
- Amazon Elastic Block Storage (EBS) for NFS
- Amazon Elastic File System (EFS)
- Amazon Relational Database Service (RDS)
This project helps you to automate the cluster-provisioning phase of SAS Viya deployment. To learn about all phases and options of the SAS Viya deployment process, see Getting Started with SAS Viya and Azure Kubernetes Service in SAS® Viya® Operations.
Once the cloud resources are provisioned, use the viya4-deployment project to deploy SAS Viya 4 in your cloud environment. For more information about SAS Viya 4 requirements and documentation for the deployment process, refer to the SAS Viya 4 Operations Guide.
Use of these tools requires operational knowledge of the following technologies:
This project supports two options for running Terraform scripts:
-
Terraform installed on your local machine
-
Using a Docker container to run Terraform (Docker is required)
For more information, see Docker Usage. Using Docker to run the Terraform scripts is recommended.
The following are also required:
- Access to an AWS account with a user that is associated with the applied IAM Policy
- Subscription to Ubuntu 20.04 LTS - Focal
- Terraform v1.0.0
- kubectl - v1.19.9
- jq v1.6
- AWS CLI (optional; useful as an alternative to the AWS Web Console) v2.1.29
Ubuntu 18.04 LTS is the operating system that is used on the jump server and NFS server VMs. Ubuntu creates the /mnt location as an ephemeral drive, so it cannot be used as the root location of the jump_rwx_filestore_path variable.
Run the following commands from a terminal session:
# clone this repo
git clone https://github.com/sassoftware/viya4-iac-aws
cd viya4-iac-awsIn order to create and destroy AWS resources on your behalf, Terraform needs an AWS account that has sufficient permissions to perform all the actions defined in the Terraform manifest. See Authenticating Terraform to Access AWS for details.
Terraform scripts require variable definitions as input. Review and modify default values to meet your requirements. Create a file named
terraform.tfvars to customize any input variable value documented in the CONFIG-VARS.md file.
To get started, you can copy one of the example variable definition files provided in the examples folder. For more information about the variables that are declared in each file, 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 AWS Console.
You have the option to specify variable definitions that are not included in terraform.tfvars or to use a variable definition file other than
terraform.tfvars. See Advanced Terraform Usage for more information.
Create and manage the required cloud resources. Perform one of the following steps, based on whether you are using Docker:
- run Terraform directly on your workstation
- run the Docker container (recommended)
See the Troubleshooting page for information about possible issues that you might encounter.
We welcome your contributions! See CONTRIBUTING.md for details on how to submit contributions to this project.
This project is licensed under the Apache 2.0 License.