Skip to Content
Technical Articles
Author's profile photo Denys van Kempen

SAP BTP Kyma Runtime Getting Started | Video Tutorial Series

This video tutorial series shows getting started with the SAP Business Technology Platform, Kyma environment covering prerequisites, procedure (how-to), result, and next steps using both the web console and command line tools for automation.

For the video tutorials about extending SAP solutions, see

For some background information about container engines, orchestration, Kubernetes, Kyma open source and the SAP Business Technology Platform Kyma runtime, see

For information about DIY Kyma deployments, see

Questions? Post as comment.

Useful? Give us a like and share on social media.

Thanks!

/wp-content/uploads/2016/02/sapnwabline_885687.png

On Your Marks

Getting Started

Before we can deploy our first microservice-in-a-container or function-as-code into the Kyma runtime, we (administrators, that is), first need to set things up. In this article, we cover all the required steps starting with the documentation (always be prepared)

  • Prerequisites: subaccounts and entitlements
  • Create service instance
  • Assign role collections
  • Register SAP system(s)

The focus of the documentation is on using the SAP BTP Cockpit web user interface. In this tutorial series we will also show you how we can achieve the same result using the SAP BTP CLI (command line interface).

The tutorial series assumes you have done your SAP BTP onboarding. If not, take a look at

BTP CLI

For the optional command line equivalents, you only need to be familiar with the basics.

btp help
btp --info
btp login
btp target

For the BTP command line tool, see

YouTube Playlist

For the complete playlist, visit the SAP HANA Academy channel on YouTube

 

/wp-content/uploads/2016/02/sapnwabline_885687.png

Introduction

Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR), using the information published to the SAP Help Portal, the Kyma project website, and the SAP Discovery Center.

Time Markers

0:00 – Introduction

0:30 – SAP Help Portal

1:15 – Kyma Project

3:20 – BTP Regions

4:20 – Setup and development information

5:00 – Tutorials

6:20 – Discovery Center

References

For the mentioned resources, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Subaccounts and Entitlements

Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR), covering the requirements for the runtime: subaccounts and entitlements using the SAP BTP cockpit console and the SAP BTP CLI.

Time Markers

0:00 – Introduction

0:35 – SAP BTP Cockpit

1:10 – Service assignments

2:00 – Create subaccount

3:00 – Create subaccount using BTP CLI

3:30 – Entity assignments

4:20 – Assign accounts entitlements using BTP CLI

BTP CLI Commands

To create subaccounts

# create a subaccount
# regions: ap, br, ca, eu, jp, us, 
# providers: 10 (aws), 20 (azure), 30 (gcp) 
btp create accounts/subaccount 
 --display-name cf-eu20 --region eu20 --subdomain cf-eu20-qwerty

To assign entitlements

# query subaccount ID(s)
btp list accounts/subaccount

# assign entitlements
# plan = aws, azure, gcp
btp assign accounts/entitlement 
 --to-subaccount xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx 
 --for-service kymaruntime --plan aws --amount 1

# list entitlements
btp list accounts/entitlement 
  --subaccount xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx 

References

For the available regions, see the SAP Discovery Center

The Kyma runtime was initially hosted from Azure data centers. In 2021, AWS and GCP were added. Note that the region where the Kubernetes cluster can be deployed may differ from the region where the subaccount was created, e.g. for GCP US Central (Iowa),

For sizing information, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Create Service Instance

Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR) and create a service instance of the Kyma runtime using the SAP BTP cockpit and the BTP CLI.

Time Markers

0:00 – Introduction

0:30 – SAP BTP Cockpit Subaccount Overview

1:30 – Service Marketplace

1:45 – Create instance dialog

4:20 – AWS, Azure, GCP

5:45 – Create instance

7:00 – BTP CLI

BTP CLI Commands

Although we can pass JSON on the command line by escaping the double quotes with a backslash, using a file is recommended.

Name is a required parameter, region, and machine type are optional and default to the smallest type (in case of Azure a single type is available).

{
    "name": "give-the-cluster-a-name",
    "region": "europe-west3",
    "machineType": "n2-standard-8"
}

To create an service instance

# list subaccounts for ID
btp list accounts/subaccount

# create Kyma runtime
btp create accounts/environment-instance 
 --subaccount xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx 
 --environment kyma --service kymaruntime --plan azure 
 --parameters azure.json

# list all environment instances 
btp list accounts/environment-instance 
 -sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# get details for single environment instances 
btp get accounts/environment-instance <ID>
 -sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# delete an environment instance
btp delete accounts/environment-instance <ID>
 -sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
 --confirm

References

For the documentation, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Security > Role Collections

Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR) and show how to assign the Kyma Runtime Namespace Admin and Developer role collections to a user using the SAP BTP Cockpit and the BTP CLI. We also download the kubeconfig configuration file and access the Kubernetes cluster using kubectl.

Time Markers

0:00 – Introduction

0:45 – Roles and Role Collections

2:00 – Kyma Dashboard – Add new namespace

3:20 – Download Kubeconfig

4:00 – Kubectl delete namespace

4:20 – BTP CLI

BTP CLI Commands

To (un)assign user to (from) role collections, the following commands can be used.

# list roles for subaccount
btp list security/role
 -sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx   

# list role collections for subaccount
btp list security/role-collection 
 -sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx   

# assign role collection to user
btp assign security/role-collection KymaRuntimeNamespaceAdmin___x_xxxxxx 
 --to-user e.g@sap.com 
 -sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# unassign role collection to useress
btp unassign security/role-collection KymaRuntimeNamespaceAdmin___x_xxxxxx 
 --from-user e.g@sap.com 
 -sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

Kubectl Commands

To connect to the Kyma (Kubernetes) cluster, download the kubeconfig YAML file from the Kyma Dashboard. When using a non-default location, you can define the path to the kubeconfig file as environment variable (see references).

export KUBECONFIG=path_to/kubeconfig.yml
kubectl version --short

You can use the Kyma Dashboard web UI or the kubectl command line tool to create, change, and delete namespaces.

As a managed service, the Kubernetes and Kyma system namespaces are not accessible.

# namespace (ns)
kubectl get ns
kubectl describe ns
kubectl delete ns

References

For information about kubeconfig, see

For information about how to download kubectl, see

For older versions (compatible with the Kyma (Kubernetes) cluster, try

For information about Kubernetes namespaces, see

For the role and role collection documentation, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Register an SAP SuccessFactors System

Video Tutorial

For the video tutorials about extending SAP solutions, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Register an SAP S/4HANA Cloud System

References

For the documentation, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Register an SAP Marketing Cloud System

References

For the documentation, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Register an SAP Customer Experience System

References

For the documentation, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Register an SAP Commerce Cloud Mock System

References

For a tutorial explaining how to deploy an SAP Commerce mock application to the Kyma runtime, see

/wp-content/uploads/2016/02/sapnwabline_885687.png

Share and Connect

Questions? Please post as comment.

Useful? Give us a like and share on social media.

Thanks!

If you would like to receive updates, connect with me on

For the author page of SAP PRESS, visit

Over the years, for the SAP HANA Academy, SAP’s Partner Innovation Lab, and à titre personnel, I have written a little over 300 posts here for the SAP Community. Some articles only reached a few readers. Others attracted quite a few more.For your reading pleasure and convenience, here is a curated list of posts which somehow managed to pass the 10k-view mile stone and, as sign of current interest, still tickle the counters each month.

/wp-content/uploads/2016/02/sapnwabline_885687.png

Assigned Tags

      Be the first to leave a comment
      You must be Logged on to comment or reply to a post.