Deploy a basic GCP cluster

When you finish, a three-node Qumulo cluster runs in one zone of your GCP project, and you can sign in to its web UI.

Before you start

• A GCP project and subnetwork that meet the GCP project prerequisites
• Application Default Credentials (gcloud auth application-default login) or GOOGLE_APPLICATION_CREDENTIALS set
• Terraform 1.11 or later

1. Copy the configuration

Save this as main.tf in an empty directory.

terraform {
  required_version = ">= 1.11"
  required_providers {
    qumulo = {
      source  = "qumulo-terraform-registry.s3.us-east-1.amazonaws.com/qumulo/qumulo"
      version = "~> 1.0"
    }
  }
}

provider "qumulo" {
  gcp {
    project_id = "your-gcp-project-id" # <-- Replace with your project ID
    region     = "us-central1"         # <-- Replace with your region
  }
}

resource "qumulo_filesystem_gcp" "cluster" {
  cluster_name        = "qumulo"
  deployment_name     = "qumulo"
  subnetwork          = "qumulo-subnet" # <-- Replace with your subnetwork name or self-link
  node_count          = 3
  instance_type       = "n2-highmem-8"
  admin_password      = "YourSecurePassword123!" # <-- Replace with your admin password
  allow_cidrs         = ["10.0.0.0/8"]           # <-- Replace with your client networks
  deletion_protection = true
}

output "endpoint_ips" {
  value = qumulo_filesystem_gcp.cluster.endpoint_ips
}

output "web_ui" {
  value = "https://${qumulo_filesystem_gcp.cluster.endpoint_ips[0]}"
}

Replace the five values marked <-- Replace, and leave the rest as written.

Note

The configuration turns on deletion_protection, so terraform destroy refuses to run. To remove the cluster later, set deletion_protection = false and run terraform apply first.

2. Apply

terraform init -upgrade
terraform plan
terraform apply

The plan ends with Plan: 1 to add, 0 to change, 0 to destroy. The apply finishes within the provider's 90-minute create timeout and ends with Apply complete! Resources: 1 added, 0 changed, 0 destroyed., followed by the endpoint_ips and web_ui outputs.

3. Check the cluster

Open the web_ui address in a browser on a network inside allow_cidrs, and accept the cluster's self-signed certificate. Sign in as admin with the password you set, and the web UI shows the cluster named qumulo.

Next

Run the nodes on your own image with Deploy a GCP cluster from a custom image, or look up any attribute in the qumulo_filesystem_gcp reference. If a step fails, see Troubleshoot a GCP deployment.