On GCP, Krossboard is available as ready-to-use virtual machine images. This release approach makes its deployment as simple than creating a GCP virtual machine.
Once deployed, the Krossboard instance is able to automatically discover and handle your GKE clusters. By default, the discovery works on a per GCP project basis, meaning that the instance does automatically discover and handle all your GKE clusters belonging to the project in which it’s deployed.
This guide shows how to setup Krossboard for a given GCP project. It’ll take you a couple of minutes to make it up and running.
This installation guide assumes that:
bash >=4terminal with gcloud installed and configured to get access o your GCP project. Or, alternatively, you may use Google Cloud Shell.
The commands below shall deploy an instance of Krossboard in a couple of minutes.
Before launching the installation, review and set the following variables suitably:
GCP_PROJECTsets the ID of the target project (i.e. where your GKE clusters are located).
GCP_ZONEsets the deployment zone (default is
GCP_INSTANCE_TYPEsets the instance type (default is
# user-provided parameters export GCP_PROJECT="my-gke-project" export GCP_ZONE="us-central1-a" export GCP_INSTANCE_TYPE="g1-small" curl -so krossboard_gcp_install.sh \ https://raw.githubusercontent.com/2-alchemists/krossboard/master/tooling/setup/krossboard_gcp_install.sh && \ bash ./krossboard_gcp_install.sh
If you have the following prompt:
API [compute.googleapis.com] not enabled on project . Would you like to enable and retry (this will take a few minutes)? (y/N)?
yes to enable Compute Engine API.
On success a summary of the installation shall be displayed as below:
=== Summary the Krossboard instance === Instance Name => krossboard-v20200818t1597750044-preview Project => krossboard-demo Krossboard UI => http://126.96.36.199/
Open a browser tab and point it to the Krossboard URL displayed at the end of the installation script.
It may take a few seconds before the instance finishes its initialization, during this time you may experience a loading error in the browser.
Here are the default username and password to sign in:
It’s highly recommended to change this default password as soon as possible.
In case of problem, first checkout the Troubleshooting Page for an initial investigation.
If the problem you’re experiencing is not listed there, open a ticket on the Krossboard GitHub Page.
Alternatively, if you do have an active support contract, you can also send an email directly to our customer support service:
support at krossboard.app.