On Microsoft Azure, Krossboard works as a standalone virtual machine. Each instance discovers and handles AKS clusters on a per resource group basis. This means that, once deployed within a resource group, the instance does automatically discover and handle all your AKS clusters belonging to that group.
This guide shows how to setup Krossboard for an Azure resource group in a couple of minutes.
It’s important to note that Krossboard is published through an Azure Shared Image Gallery.
This installation guide assumes that:
bash >=4terminal (or Azure Cloud Shell) where you can use Azure CLI.
kubectlinstalled and accessible from your terminal.
Open a terminal and perform the following commands to sign in to Azure and export variables required during the installation.
az login export AZURE_TENANT_ID=$(az account show --query "tenantId" | cut -d'"' -f2) export AZURE_SUBSCRIPTION_ID=$(az account show --query id | cut -d'"' -f2) echo "AZURE_TENANT_ID => $AZURE_TENANT_ID" echo "AZURE_SUBSCRIPTION_ID => $AZURE_SUBSCRIPTION_ID"
Azure requires that you consent to use a Image gallery from a third party.
Open a web browser and point it to the following URL. Change
$AZURE_TENANT_ID with your tenant ID (see the above steps).
Verify that the application is
krossboard-gallery-app, then check
Consent on behalf of your organization and click Accept.
The commands below shall deploy an instance of Krossboard in a couple of minutes.
Before running the commands, review and set the following variables suitably:
AZURE_GROUPsets the name of the resource group in which your AKS clusters are located.
KB_AZURE_VM_NAMEsets the name of the instance (default is automatically generated).
KB_AZURE_LOCATIONsets the deployment location (default is
centralus– see the list of regions with available images).
KB_AZURE_VM_SIZEsets the VM size (default is
Standard_B1ms– what should be sufficient unless you have a big number of AKS clusters along with many namespaces in the target resource group).
--generate-ssh-keysof Azure CLI, meaning that it uses the local SSH key pair for the instance. The associated SSH username is
# deployment parameters export AZURE_GROUP="YOUR_AZURE_GROUP_WITH_AKS" export KB_AZURE_VM_NAME="krossboard-`date +%F-%s`" export KB_AZURE_VM_SIZE='Standard_B1ms' export KB_AZURE_LOCATION='centralus' curl -so krossboard_azure_install.sh \ https://raw.githubusercontent.com/2-alchemists/krossboard/master/tooling/setup/krossboard_azure_install.sh && \ bash ./krossboard_azure_install.sh
On success a summary of the installation shall be displayed as below:
=== Summary the Krossboard instance === Instance Name => krossboard-2020-08-18-1595880565 Resource Group => prod Krossboard UI => http://220.127.116.11/
During the installation, the Krossboard deployment script discovers and takes over existing AKS clusters (in the same resource group). After the installation, you need apply the following change to enable RBAC access (read-only) to each new AKS cluster.
kubectl create -f https://raw.githubusercontent.com/2-alchemists/krossboard/master/tooling/setup/k8s/clusterrolebinding-aks.yml
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 IP address of the instance is displayed at the end of the installation script. You can also get it on the Azure portal.
The default username and password to sign in are:
It’s highly recommended to change this default password as soon as possible.