Adding Kyma Modules

Objective

After completing this lesson, you will be able to add Kyma modules

Adding Kyma Modules

Usage Scenario

You are planning to use SAP BTP, Kyma runtime, and have heard of the option to use Kyma dashboard for interacting with the underlying Kubernetes cluster. Now, you want to explore Kyma dashboard and learn how to use it.

Learning Objectives

  • Access Kyma dashboard
  • Interact with your Kyma runtime instance using Kyma dashbaord

Task Flow

  1. Access Kyma dashboard
  2. Display Kyma resources of your Kyma runtime instance
  3. Create a new namespace and Pod

Prerequisites

You have successfully created a Kyma runtime instance in the SAP BTP subaccount.

Content

Kyma dashboard is a web-based graphical user interface (GUI) that allows you to interact with your cluster. Since it is part of the open-source project "Kyma", it can also be used standalone, without being provisioned by SAP.

However, SAP is providing a centrally hosted version of Kyma dashboard for SAP BTP, Kyma runtime customers, which is accessible through the SAP BTP cockpit or dashboard.kyma.cloud.sap.

Task 1: Access Kyma dashboard

Follow these steps to quickly access Kyma dashboard:

Steps

  1. Go to your SAP BTP subaccount.

  2. In the Kyma Environment section, select the console URL link.

    Kyma dashbaord link

    Alternatively, you can access the dashboard by providing the kubeconfig file. This method takes more time but allows you to customize storage and privacy settings according to your preferences.

    1. Go to your SAP BTP subaccount.

    2. Download the kubeconfig file from the Kyma Environment section.

  3. Go to https://dashboard.kyma.cloud.sap/clusters.

  4. Select Connect Cluster.

  5. Drop the kubeconfig file into the editor.

  6. Select Next step and edit the dashboard's configuration if needed.

  7. When you reach the final step, select Connect Cluster.

Task 2: Display Kyma Resources

Kyma runtime, like Kubernetes, uses namespaces to isolate groups of resources within a cluster. For example, when you enable Kyma runtime, the modules' resources are deployed in the kyma-system namespace, Istio resources in the istio-system namespace, and the kube-system namespace contains various system-level resources and components required for the proper functioning of the Kubernetes cluster. Display the already created resources:

Steps

  1. Go to Namespaces and select the kyma-system namespace.

    kyma-system namesapce

    This page shows you the status of the objects that are deployed in the kyma-system namespace. It directly provides an overview of the overall healthiness of your objects as well as resource consumption (CPU, Memory, Network). Kyma dashbaord contains an overview page for each of your namespaces.

  2. In the Workloads section, you can see different objects grouped by categories. You can choose the respective category to see the available object of a certain kind. To view all the Pods that are created in the kyma-systemnamespace, select Pods.

    Pods
  3. Use the toggle to select All Namespaces instead of the specific namespace.

    Pods in all namespaces

    Now, you can see all the Pods that are created in all namespaces of your Kyma runtime instance.

Task 3: Create a New Namespace and Pod

Steps

  1. From the Cluster Details page, go to Namespaces.

  2. Select Create.

  3. Provide the name of your namespace and select Create.

  4. Go to WorloadsPods and select Create.

  5. Paste the following configuration into the editor:

    Code Snippet
    12345678
    apiVersion: v1 kind: Pod metadata: name: my-pod spec: containers: - name: my-container image: nginx:1.21.3
  6. Select Create.

    Note

    Feel free to play around and create different kinds of resources in your newly created namespace. All objects in your Kyma runtime instance can be configured using the respective manifest in the YAML format.

    Some objects also have a graphical editor, which allows you to create and edit objects without having to write the YAML manifest by hand.

    If you are unsure about how to create different objects, don't worry! We'll cover these topics in the next lessons.

  7. To delete the namespace, select Delete from its overview page.

Result

In this exercise, you've learned how to access Kyma dashboard and use its navigation. Now, you can use it to interact with your Kubernetes cluster. You've also found out how to work with namespaces and how to manage resources.

Log in to track your progress & complete quizzes