--- title: "vastcloud Preflight Checker Walkthrough - GCP" slug: "vastcloud-preflight-checker-walkthrough-gcp" description: "Validate your cloud ecosystem readiness with the Vastcloud preflight checker tool. Ensure all prerequisites are met for a successful deployment." updated: 2026-10-28T02:14:35Z published: 2026-10-28T02:14:35Z canonical: "docs.vastdata.com/vastcloud-preflight-checker-walkthrough-gcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt > Use this file to discover all available pages before exploring further. # vastcloud Preflight Checker Walkthrough - GCP > [!NOTE] > 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. ```plaintext vastcloud cluster preflight --provider gcp [Your cluster name] ``` When prompted for the authentication test, answer `Yes ` ```plaintext /.vast > vastcloud cluster preflight --provider gcp vastdata-voc           5m 20s ┃ Run authentication check? ┃ ┃       Yes!     No. ``` Expected results: ```plaintext Authentication Status Polaris:   OK      production-gcp @ https://api.gcp.polaris.vastdata.com GCP:       OK      ADC present ``` Now you will be prompted for the Polaris deployment lookup check. Answer `Yes `when prompted. ```plaintext Run Polaris deployment lookup? ┃ ┃         Yes!     No. ``` You’ll be prompted to approve deployment details in Polaris for permissions check, review, and answer. ```plaintext 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: ```plaintext 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 delete ``` Now you should be prompted for the Tools check. Hit `Yes `to continue. ```plaintext Run required tools check? ┃ ┃       Yes!     No. ``` Expected results: ```plaintext Required Tools  terraform   Terraform v1.14.6  gcloud      OK ``` The next phase is the infrastructure test. Hit `yes `to proceed. ```plaintext Run GCP infrastructure (APIs, network, quotas)? ┃ ┃                  Yes!     No. ``` Now enter your project ID v`ast-on-clouod` in this example). ```plaintext GCP project ID ┃ Enter the GCP project ID ┃ > vast-on-cloud ``` Choose your subnet. ```plaintext 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-jumbo ``` Expected results: ```plaintext 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. ```plaintext Run pre-checker (network connectivity)? ┃ ┃              Yes!     No. ``` You’ll be prompted to enter the project ID again. ```plaintext GCP project ID ┃ Enter the GCP project ID for the pre-checker ┃ > vast-on-cloud ``` > [!WARNING] > This 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. ```plaintext ┃ Run resource conflict check? ┃ ┃        Yes!     No. ``` Expected results: ```plaintext 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. ```plaintext Preflight Summary ╭──────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────╮ │                                    Stage                                     │                                   Status                                    │                                   Detail                                    │ ├──────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤ │ authentication                                                               │ OK                                                                          │                                                                             │ │ polaris deployment                                                           │ OK                                                                          │                                                                             │ │ permissions                                                                  │ OK                                                                          │                                                                             │ │ tools                                                                        │ OK                                                                          │                                                                             │ │ gcp infrastructure                                                           │ OK                                                                          │                                                            │ │ pre-checker                                                                  │ OK                                                                          │                                                                             │ │ conflicts                                                                    │ OK                                                                          │                                                                             │ ╰──────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────╯ ~/.vast > ```