Terraform Module - AWS Cloud Cluster Deployment
Terraform module which deploys a new Rubrik Cloud Cluster in AWS.
Documentation
Here are some resources to get you started! If you find any challenges from this project are not properly documented or are unclear, please raise an issue and let us know! This is a fun, safe environment - don't worry if you're a GitHub newbie!
Usage
module "rubrik_aws_cloud_cluster" {
source = "rubrikinc/rubrik-cloud-cluster/aws"
aws_region = "us-west-1"
aws_subnet_id = "subnet-1234567890abcdefg"
aws_ami_filter = ["rubrik-mp-cc-7*"]
cluster_name = "rubrik-cloud-cluster"
admin_email = "build@rubrik.com"
admin_password = "RubrikGoForward"
dns_search_domain = ["rubrikdemo.com"]
dns_name_servers = ["192.168.100.5"."192.168.100.6"]
ntp_server1_name = "8.8.8.8"
ntp_server2_name = "8.8.4.4"
}Inputs
The following are the variables accepted by the module.
Instance/Node Settings
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| aws_region | The region to deploy Rubrik Cloud Cluster nodes. | string | yes | |
| aws_instance_type | The type of instance to use as Rubrik Cloud Cluster nodes. CC-ES requires m5.4xlarge. | string | m5.4xlarge | no |
| aws_disable_api_termination | If true, enables EC2 Instance Termination Protection on the Rubrik Cloud Cluster nodes. | bool | true | no |
| aws_tags | Tags to add to the resources that this Terraform script creates, including the Rubrik cluster nodes. | map | no | |
| number_of_nodes | The total number of nodes in Rubrik Cloud Cluster. | int | 3 | no |
| aws_ami_owners | AWS marketplace account(s) that owns the Rubrik Cloud Cluster AMIs. | list | ["679593333241"] | no |
| aws_ami_filter | Cloud Cluster AWS AMI name pattern(s) to search for. Use ["rubrik-mp-cc-*"]. Where is the major version of CDM. | list | yes | |
| aws_image_id | AWS Image ID to deploy. Set to 'latest' or leave blank to deploy the latest version as determined by aws_ami_filter. |
string | latest | no |
| aws_key_pair_name | Name for the AWS SSH Key-Pair being created or the existing AWS SSH Key-Pair being used. | string | no | |
| aws_public_key | The public key material needed to create an AWS Key-Pair for use with Rubrik Cloud Cluster. | string | no | |
| private_key_recovery_window_in_days | Recovery window in days to recover script generated ssh private key. | string | 30 | no |
Note: When using the aws_tags variable, the "Name" tag is automatically used by this TF for those resources that support it.
Note: The aws_ami_filter and aws_ami_owners variables are only used when the aws_image_id variable is blank or set to latest
Note: When using the aws_image_id variable, see Selecting a specific image for details on finding images.
Note: When using the aws_key_pair_name variable, if a new AWS SSH Key-Pair is being created and no name is specified, a name will be automatically generated.
Note: When using the aws_public_key variable, if a new AWS SSH Key-Pair is being created and no material is provided, new key material will be auto generated.
Network Settings
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| aws_vpc_cloud_cluster_nodes_sg_name | The name of the security group to create for Rubrik Cloud Cluster to use. | string | Rubrik Cloud Cluster | no |
| cloud_cluster_nodes_admin_cidr | The CIDR range for the systems used to administer the Cloud Cluster via SSH and HTTPS. | string | 0.0.0.0/0 | no |
| aws_vpc_cloud_cluster_hosts_sg_name | The name of the security group to create for Rubrik Cloud Cluster to communicate with EC2 instances. | string | Rubrik Cloud Cluster Hosts | no |
| aws_cloud_cluster_nodes_sg_ids | Additional security groups to add to Rubrik cluster nodes. | string | no | |
| aws_subnet_id | The VPC Subnet ID to launch Rubrik Cloud Cluster in. | string | yes |
Storage Settings
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| cluster_disk_type | Disk type for the data disks (st1, sc1 or gp2). Use gp2 for CC-ES. Use sc1 for 48TB CC nodes. Use st1 for all others. | string | gp2 | no |
| cluster_disk_size | The size (in GB) of each data disk on each node. Cloud Cluster ES only requires 1 512 GB disk per node. | string | 512 | no |
| cluster_disk_count | The number of disks for each node in the cluster. Set to 1 to use with S3 storage for Cloud Cluster ES. | int | 1 | no |
Bootstrap Settings
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| cluster_name | Unique name to assign to Rubrik Cloud Cluster. Also used for EC2 instance name tag. For example, rubrik-1, rubrik-2 etc. | string | yes | |
| admin_email | The Rubrik Cloud Cluster sends messages for the admin account to this email address. | string | yes | |
| admin_password | Password for the Rubrik Cloud Cluster admin account. | string | RubrikGoForward | no |
| dns_search_domain | List of search domains that the DNS Service will use to resolve hostnames that are not fully qualified. | list | yes | |
| dns_name_servers | List of the IPv4 addresses of the DNS servers. | list | ["169.254.169.253"] | no |
| ntp_server1_name | The FQDN or IPv4 addresses of network time protocol (NTP) server #1. | string | 8.8.8.8 | yes |
| ntp_server1_key_id | The ID # of the key for NTP server #1. Typically is set to 0. (Required with ntp_server1_key & ntp_server1_key_type) |
int | 0 | no |
| ntp_server1_key | Symmetric key material for NTP server #1. (Required with ntp_server1_key_id and ntp_server1_key_type) |
string | no | |
| ntp_server1_key_type | Symmetric key type for NTP server #1. (Required with ntp_server1_key and ntp_server1_key_id) |
string | no | |
| ntp_server2_name | The FQDN or IPv4 addresses of network time protocol (NTP) server #2. | string | 8.8.4.4 | yes |
| ntp_server2_key_id | The ID # of the key for NTP server #2. Typically is set to 1. (Required with ntp_server1_key & ntp_server1_key_type) |
int | 1 | no |
| ntp_server2_key | Symmetric key material for NTP server #2. (Required with ntp_server1_key_id and ntp_server1_key_type) |
string | no | |
| ntp_server2_key_type | Symmetric key type for NTP server #2. (Required with ntp_server1_key and ntp_server1_key_id) |
string | no | |
| timeout | The number of seconds to wait to establish a connection the Rubrik cluster before returning a timeout error. | int | 15 | no |
Prerequisites
There are a few services you'll need in order to get this project off the ground:
-
Terraform v1.2.2 or greater
-
Rubrik Provider for Terraform - provides Terraform functions for Rubrik
- Only required to run the sample Rubrik Bootstrap command
-
The Rubik Cloud Cluster product in the AWS Marketplace must be subscribed to. Otherwise an error like this will be displayed:
Error: creating EC2 Instance: OptInRequired: In order to use this AWS Marketplace product you need to accept terms and subscribe. To do so please visit https://aws.amazon.com/marketplace/pp?sku=<sku_number>
If this occurs, open the specific link from the error, while logged into the AWS account where Cloud Cluster will be deployed. Follow the instructions for subscribing to the product.
Changes
Several variables have changed with this iteration of the script. Upgrades to existing deployments may cause unwanted changes. Be sure to check the changes of terraform plan before terraform apply to avoid disruptive behavior.
How You Can Help
We glady welcome contributions from the community. From updating the documentation to adding more functionality, all ideas are welcome. Thank you in advance for all of your issues, pull requests, and comments!
License
About Rubrik Build
We encourage all contributors to become members. We aim to grow an active, healthy community of contributors, reviewers, and code owners. Learn more in our Welcome to the Rubrik Build Community page.
We'd love to hear from you! Email us: build@rubrik.com