This document created to provide a clear set of instructions for running and using the vastcloud preflight checker tool, this tool designed to allow users validate their cloud ecosystem readiness for the deployment of Vast On Cloud, running this tool allow checking that all prerequisite are in place and will assist to save time and reduce costs.
Run the below command to trigger the preflight-checker
Note that all tests should pass for a successful cluster deployment. Note that you can run the test separately for your convenience, use the --help or autocomplete for more details.
vastcloud cluster preflight --provider gcp [Your cluster name]When prompted for the authentication test, answer Yes
/.vast > vastcloud cluster preflight --provider gcp vastdata-voc 5m 20s
┃ Run authentication check?
┃
┃ Yes! No.Expected results:
Authentication Status
Polaris: OK production-gcp @ https://api.gcp.polaris.vastdata.com
GCP: OK ADC presentNow you will be prompted for the Polaris deployment lookup check. Answer Yes when prompted.
Run Polaris deployment lookup?
┃
┃ Yes! No.You’ll be prompted to approve deployment details in Polaris for permissions check, review, and answer.
Polaris deployment
Name vastdata-voc
Provider gcp
Region us-central1
Zone us-central1-a
Instance type z3-highmem-88-highlssd
State running
Node count 8
Storage (usable TB) 210
GCP project vast-on-cloud
┃ Run permission checks?
┃
┃ Yes! No.Expected results:
IAM Permissions
Discovering GCP projects from Polaris clusters...
Discovered 1 GCP project(s) from Polaris clusters.
Permission check: GCP
Identity: vast.admin@vastdata.com
── Project: vast-on-cloud (1/1) ──
Privileged roles detected: roles/owner — storage permission probe failures are overridden.
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Operation │ Status │
├─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ config/login │ OK │
│ cluster list │ OK │
│ cluster create │ OK │
│ cluster delete │ OK │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
You can: config/login, cluster list, cluster create, cluster deleteNow you should be prompted for the Tools check. Hit Yes to continue.
Run required tools check?
┃
┃ Yes! No.Expected results:
Required Tools
terraform Terraform v1.14.6
gcloud OKThe next phase is the infrastructure test. Hit yes to proceed.
Run GCP infrastructure (APIs, network, quotas)?
┃
┃ Yes! No.Now enter your project ID vast-on-clouod in this example).
GCP project ID
┃ Enter the GCP project ID
┃ > vast-on-cloudChoose your subnet.
Looking up cluster "vastdata-voc" in Polaris for region...
┃ Pick a subnet.
┃ vast-on-cloud-main
┃ vast-on-cloud-main-function-access-connector-1
┃ > vast-on-cloud-main-jumboExpected results:
GCP API Enablement
compute.googleapis.com PASS
servicenetworking.googleapis.com PASS
cloudfunctions.googleapis.com PASS
artifactregistry.googleapis.com PASS
cloudbuild.googleapis.com PASS
networkmanagement.googleapis.com PASS
networksecurity.googleapis.com PASS
monitoring.googleapis.com PASS
logging.googleapis.com PASS
secretmanager.googleapis.com PASS
GCP Network Infrastructure
╭──────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────╮
│ Resource │ Value │ Status │
├──────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
│ Subnet │ vast-on-cloud-main-jumbo (us-central1) │ PASS │
│ VPC │ vast-on-cloud-jumbo │ PASS │
│ Private Google Access │ enabled │ PASS │
╰──────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────╯
GCP Service CIDR Firewall Rules
╭──────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────╮
│ CIDR │ Purpose │ Status │
├──────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
│ 35.191.0.0/16 │ Health Checks │ PASS │
│ 130.211.0.0/22 │ Health Checks │ PASS │
│ 199.36.153.8/30 │ Private Google APIs │ PASS │
│ 35.235.240.0/20 │ IAP (SSH/RDP) │ PASS │
│ 35.199.192.0/19 │ Cloud DNS │ PASS │
╰──────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────╯
GCP Z3 Quota Validation
╭──────────────────────────────────────────────────────────┬──────────────────────────────────────────────────────────┬──────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────╮
│ Quota │ Current │ Required │ Status │
├──────────────────────────────────────────────────────────┼──────────────────────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────┤
│ Z3 vCPUs │ 14000 vCPUs │ >= 1500 vCPUs │ PASS │
│ Z3 Local SSD │ 5057745 GB │ >= 1000000 GB │ PASS │
╰──────────────────────────────────────────────────────────┴──────────────────────────────────────────────────────────┴──────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────╯The next phase is the network connectivity test, hit Yes to continue.
Run pre-checker (network connectivity)?
┃
┃ Yes! No.You’ll be prompted to enter the project ID again.
GCP project ID
┃ Enter the GCP project ID for the pre-checker
┃ > vast-on-cloudThis part may take a few minutes, hold on patiently.
This phase will test all needed ports and connectivity
The expected output will list all port tests and status; you should get Connectivity check completed successfully message if all tests pass.
The results will be saved to a local log file under:
/Users/USER-NAME/.vast/preflight/terraform/gcp/checker/log/checker-results-vastdata-voc-20260510-104657.log
The next phase will be the conflict test, hit Yes to proceed.
┃ Run resource conflict check?
┃
┃ Yes! No.Expected results:
Resource Conflicts
No conflicting resources found.When done, you will see a summary of all test results. If all tests pass, you are ready to deploy the cluster.
Preflight Summary
╭──────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────╮
│ Stage │ Status │ Detail │
├──────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
│ authentication │ OK │ │
│ polaris deployment │ OK │ │
│ permissions │ OK │ │
│ tools │ OK │ │
│ gcp infrastructure │ OK │ │
│ pre-checker │ OK │ │
│ conflicts │ OK │ │
╰──────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────╯
~/.vast >