Kyma

Appearance

Deploying and Accessing Busola in a Kubernetes Cluster ​

Architecture ​

Busola Kubernetes architecture

To expose Busola, you can use APIRule, Ingress, or create your own exposing mechanism. For more details about environment configuration, see Environment-Specific Settings.

Deploying Busola in a Kubernetes Cluster ​

Follow these steps to deploy Busola in a Kubernetes cluster:

  1. Set the NAMESPACE shell environment variable and create your namespace:

    bash
    export NAMESPACE={YOUR_NAMESPACE_NAME}
kubectl create namespace ${NAMESPACE}

  2. Choose one of the following installation options that suit your case.

Accessing Busola Installed in a Kubernetes Cluster ​

You can access Busola using the kubectl port forward command or your Kubernetes cluster with Istio installed.

kubectl ​

Run the following command:

bash
kubectl port-forward --namespace "${NAMESPACE}" services/busola 3001:3001

Kubernetes Cluster with Istio Installed ​

Prerequisites ​

Procedure ​

Follow these steps to access your Busola page:

  1. To install the Istio required resources, run the following command from the Busola root folder:

    bash
    (cd resources && kubectl apply --namespace "${NAMESPACE}" -k istio)

  2. To get the Busola address, run:

    bash
    kubectl get --namespace "${NAMESPACE}" virtualservices.networking.istio.io

NOTE

The VirtualService creation takes a few minutes.

Under HOSTS, you should see an address that you can use to access the Busola page.

Logging into Busola ​

After accessing Busola using one of the methods above, you need to provide your kubeconfig to connect to it.

Providing Kubeconfig ​

  1. Open your web browser and navigate to one of the following:

    • http://localhost:3001, if using kubectl port-forward
    • The address from the Istio VirtualService

  2. On the Busola login page, choose Connect to provide cluster connection details.

  3. Provide your kubeconfig, either by uploading the kubeconfig file or by pasting the kubeconfig content in the text area, and select Next Step.

  4. Choose your preferred storage configuration, and select Next Step.

  5. Choose Connect Cluster to establish connection to your cluster.

After successful login, you should see the Busola dashboard with your cluster resources.