On Amazon AWS, Krossboard works as a standalone EC2 virtual machine. Each instance discovers and handles EKS clusters on a per AWS region basis. This means that, once installed and properly configured in a region, the instance does automatically discover and handle all your EKS clusters in that region.
This guide shows how to setup Krossboard for an AWS region in a couple of minutes.
First note that Krossboard is published as ready-to-use public AWS images. This release approach aims to make its deployment as simple than creating an AWS virtual machine.
This installation guide assumes that:
jqinstalled and accessible from your terminal.
The commands below shall deploy an instance of Krossboard in a couple of minutes.
Beforehand review the following parameters and adapt them if applicable.
KB_AWS_REGIONwith the region of your EKS clusters (default is
eu-central-1). This must be a region where Krossboard is currently available.
KB_AWS_KEY_PAIRwith a valid key pair in EC2. If you want to create a new key pair, read this documentation.
KB_AWS_INSTANCE_TYPEwith the instance type (default is
t2.small– what should be sufficient unless you have a big number of EKS clusters along with many namespaces in the target region).
export KB_AWS_KEY_PAIR='MyKeyPair' export KB_AWS_REGION='eu-central-1' export KB_AWS_INSTANCE_TYPE='t2.small' curl -so krossboard_aws_install.sh \ https://raw.githubusercontent.com/2-alchemists/krossboard/master/tooling/setup/krossboard_aws_install.sh && \ bash ./krossboard_aws_install.sh
On success a summary of the installation shall be displayed as below:
=== Summary the Krossboard instance === Instance Name => krossboard-2020-08-27-1598480511 Instance ID => i-02ba079c0decfcff9 Region => eu-central-1 Key Pair => krossboard-test Krossboard UI => http://22.214.171.124/
During the installation, the Krossboard deployment script discovers and takes over existing EKS clusters (in the same region). After the installation, you need apply the following change to enable RBAC access (read-only) to each new EKS cluster.
KB_ROLE_ARN='ARN_OF_KROSSBOARD_ROLE' KB_AWS_REGION='YOUR_TARGET_REGION' curl -so krossboard_aws_configure_new_clusters.sh https://raw.githubusercontent.com/2-alchemists/krossboard/master/tooling/setup/krossboard_aws_configure_new_clusters.sh bash ./krossboard_aws_configure_new_clusters.sh $KB_ROLE_ARN
ARN_OF_KROSSBOARD_ROLE with the ARN of the role bound to your instance of Krossboard, and
YOUR_TARGET_REGION with your target AWS region.
Open a browser tab and point it to the Krossboard URL displayed at the end of the installation script. Note: It may take a few seconds before the instance finishes its initialization, during this time you may experience a loading error in the browser.
The default username and password to sign in are:
It’s highly recommended to change this default password as soon as possible.