Setting and Configuring Kubectl for Kyma

Install the kubectl CLI

1. Follow the instructions to install the kubectl CLI for your operating system from the official documentation.

2. Verify that the kubectl CLI is installed correctly by executing the following command in your terminal or command line:

   Code snippet

   Copy code

   kubectl version --client

   Expand

   If the installation was successful, you should see the version of the kubectl CLI as output.

Install an additional plugin for kubectl to connect to Kyma.

1. The kubelogin plugin can be installed via kubectl's plugin manager krew. To install krew on your local machine, please follow the instructions provided in the official documentation here.

2. To install the kubelogin plugin, execute the following command in your terminal or command line:

   Code snippet

   Copy code

   kubectl krew install oidc-login

   Expand

   Alternatively, you can also install it via choco (Windows) or brew (macOS/Linux):

   Code snippet

   Copy code

   # Homebrew (macOS and Linux)
   brew install int128/kubelogin/kubelogin
   
   # Chocolatey (Windows)
   choco install kubelogin

   Expand

Configure the kubectl CLI to connect to your SAP BTP, Kyma runtime instance.

1. Create the .kube directory if it does not exist yet:

   On macOS/Linux:

   Code snippet

   Copy code

   mkdir ~/.kube

   Expand

   On Windows:

   Code snippet

   Copy code

   mkdir %USERPROFILE%\.kube

   Expand

2. Go to your SAP BTP subaccount overview page and select the link for the KubeconfigURL to download the kubeconfig file for your SAP BTP, Kyma runtime instance.

   

   This will download a kubeconfig.yaml file.

3. Move the kubeconfig.yaml file to the .kube directory and rename it to config.

4. After doing so, check that your .kube directory contains the config file.

   

   Note

   The kubeconfig file contains the credentials for your SAP BTP, Kyma runtime instance. Therefore, it is important to keep it secure. For this reason, we do not show the content of the file in this exercise. And typically, all .dotfolders are hidden in your file system by default. You can change this behavior in your operating system settings.

5. Verify that the kubeconfig file is configured correctly by executing the following command in your terminal or command line:

   Code snippet

   Copy code

   kubectl cluster-info

   Expand

6. If the configuration was successful, you should see the following output:

   

Use the kubectl CLI to connect to your SAP BTP, Kyma runtime instance.

1. Execute the following command to get a list of all available resources in your SAP BTP, Kyma runtime instance:

   Code snippet

   Copy code

   kubectl get all

   Expand

2. Get a list of your nodes in your SAP BTP, Kyma runtime instance:

   Code snippet

   Copy code

   kubectl get nodes

   Expand

3. Get a list of your pods in your SAP BTP, Kyma runtime instance:

   Code snippet

   Copy code

   kubectl get pods

   Expand

4. Get a list of your deployments in your SAP BTP, Kyma runtime instance:

   Code snippet

   Copy code

   kubectl get deployments

   Expand

5. Create a new namespace in your SAP BTP, Kyma runtime instance:

   Code snippet

   Copy code

   kubectl create namespace my-namespace

   Expand

6. Get a list of all namespaces in your SAP BTP, Kyma runtime instance:

   Code snippet

   Copy code

   kubectl get namespaces

   Expand

7. Delete the namespace you just created:

   Code snippet

   Copy code

   kubectl delete namespace my-namespace

   Expand

   Result

   You have successfully installed the kubectl CLI and configured it to connect to your SAP BTP, Kyma runtime instance. You have also learned how to use the kubectl CLI to interact with your SAP BTP, Kyma runtime instance.