- Please use aws-terraform-cloud-q for all new Terraform deployments.
- This repo will be left as is for previous deployments that reference it.
Terraform Module which creates a Qumulo Cloud Cluster in AWS.
This is primarily meant to help in spinning up clusters and provides an alternate method to CloudFormation.
This module requires the AWS Provider >= 2.53
It also requires the AMI ID of the Qumulo Cloud Software. You can find AMIs for the Qumulo Cloud Software on the AWS Marketplace or by Contacting Qumulo Sales.
IMPORTANT: The master branch is used in source just as an example. In your code, do not pin to master because there may be breaking changes between releases.
Instead pin to a release tag (e.g. ?ref=tags/x.y.z).
module "qumulo_cluster" {
source = "git::https://github.com/Qumulo/terraform-aws-qumulo-cluster.git?ref=master"
ami_id = "ami-0641894224608b956" # us-west-2 Qumulo-Cloud-3.0.0.2-release-5tib
cluster_name = "Qumulo"
instance_type = "m5.8xlarge"
node_count = 4
key_pair_name = "admin_ssh_key"
subnet_id = "subnet-abcdef"
security_group_ids = ["sg-1234567"]
tags = {
User = "jdoe"
Department = "IT"
}
}NOTE: This module does not support input values changing while preserving data on the cluster. It is designed to ease launching and terminating whole clusters at once, not to make changes to active clusters. Data loss will occur on a deployed cluster if a plan apply recreates any of the nodes managed by the module.
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| ami_id | The AMI ID for the Qumulo Cloud Software you wish to deploy | string | - | yes |
| cluster_name | What to name the cluster. Must be 2-15 chars, no spaces. | string | - | yes |
| instance_type | Desired EC2 Instance Type. | string | m5.8xlarge | no |
| key_pair_name | EC2 SSH key pair to ssh to the "admin" user | string | - | yes |
| node_count | Number of Nodes (min: 4, max: 100) | number | 4 | no |
| subnet_id | ID of VPC subnet you want to spawn the cluster in | string | - | yes |
| security_group_ids | List of security groups you want to attach to nodes | list(string) | - | yes |
| tags | Additional tags to add to instances | map(string) | {} | no |
| Name | Description |
|---|---|
| instance_ids | Ec2 instance ids of all nodes |
| private_ips | List of all private IPs for all nodes in cluster |
| public_ips | List of all public IPs for all nodes in cluster (this can be empty if your VPC setting is not to assign public IPs) |
| temp_admin_password | Password used to authenticate as admin on the WebUI |
File a GitHub issue is the recommended way.
Note: This project is provided as a public service to the AWS/Terraform community and not directly supported by Qumulo's paid enterprise support. It is intended to be used by expert users only.
Copyright © 2020 Qumulo, Inc.
See LICENSE for full details
MIT License
Copyright (c) 2020 Qumulo
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
All other trademarks referenced herein are the property of their respective owners.