GCP Installation Guide
Instructions to install in GCP infra
Last updated
Was this helpful?
Instructions to install in GCP infra
Last updated
Was this helpful?
Minimal Installation:
You need a system with a minimum of 16 CPUs. We recommend using 2 nodes with 8 cores each, totalling 32GB.
All machines must reside in the same zone to avoid data transfer charges across zones. Our Obsrv installer will automatically create the GKE cluster for you.
Networking Environment:
The networking requirements change w.r.t the type of cluster we are creating. Follow this to find out different types of clusters supported by Google Cloud in the region you are installation.
By default our setup script creates a Single Zonal Public Cluster and the required VPC’s for it.
Installation of Obsrv requires the following CLI tools as prerequisites. Please note that the following instructions for installing the prerequisites are provided only for Linux based operating systems. Please follow the instructions for the specific tools depending upon your operating system.
Terraform CLI version 1.5.x or older. Versions above 1.5.x are not MPL licensed.
Download from here -
Terragrunt CLI version 0.48 or later.
Download from here -
Terrahelp version 0.7.5 or later
Helm version 3.10.2 or later
Clone the obsrv-automation
repository:
Navigate to the setup directory:
Update Configuration Files:
Update the vars/cluster_overrides.tfvars
file to match your environment and requirement settings. Example configuration in cluster_overides.tf
GCS Bucket:
Obsrv installation requires a GCS bucket to be created which will be subsequently used for storing the cluster state. The bucket name will then be referenced in the installation script mentioned below. For e.g, if the bucket created is obsrv-cluster-state, please export it as a environment variable as show below, which will be referenced in the terragrunt.hcl
under the environment variable GOOGLE_TERRAFORM_BACKEND_BUCKET. The bucket will be created automatically if it doesn’t exist. The region can be updated by passing it in an environment variable GOOGLE_TERRAFORM_BACKEND_BUCKET_REGION
Run Installation Script: Execute the following command to start the installation process:
Monitor Installation Progress: The script will begin installing Obsrv within the GKE cluster. Monitor the progress and follow any on-screen prompts or instructions.
Completion: Once the installation process is complete, verify that Obsrv has been successfully installed and configured within your GKE cluster.
Take latest code from obsrv-automation
repository
Ensure all the configuration configured during the installation is properly updated in all places.
Run the terraform to upgrade the cluster to the latest versions.
Download from here -
Download from here -
Install Google Cloud SDK by following the instructions
Install additional dependencies to authenticate with GKE. Please see for reference.
Create a project on google cloud and export it as a variable. Please see for reference.
Enable the Kubernetes Engine API for the created project. Please see for reference.
Note: if you are changing the region, also check if the instance type is supported in that region. If not please change the instance type from the supported list which can be found in this