SAP BTP Kyma Runtime Getting Started | Video Tutorial Series

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

• SAP BTP Developer Onboarding | Hands-on Video Tutorials

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

• Download and Start Using the btp CLI Client

YouTube Playlist

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

• SAP BTP, Kyma runtime (SKR)

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

• Kyma Environment | SAP Business Technology Platform
• Kyma Docs | open-source
• SAP BTP, Kyma Runtime | SAP Discovery Center

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

About the plans, see

• Available Plans in the Kyma Environment

For the available regions, see the SAP Discovery Center

• Kyma runtime | Service Catalog

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),

• Kyma runtime now offers Google Cloud Platform as well
• Kyma runtime now available on AWS
• Kyma runtime available in trial – and now we are complete

For sizing information, see

• Flexibility with the sizing of SAP BTP, Kyma runtime
• Easier start with Kyma runtime

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

• Create the Kyma Environment Instance
• Working with Environments Using the btp CLI

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

• Organizing Cluster Access Using kubeconfig Files
• kubectl Cheat Sheet

For information about how to download kubectl, see

• kubernetes.io/docs/tasks/tools/

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

• www.downloadkubernetes.com

For information about Kubernetes namespaces, see

• Namespaces
• Namespaces Walkthrough

For the role and role collection documentation, see

• Assign Roles in the Kyma Environment
• Managing Users and Their Authorizations Using the btp CLI

Extending SAP Cloud Solutions

SAP Extension Center

With the SAP BTP, Kyma environment up and running, we can proceed with the integration of (one or more) SAP Cloud solutions.

Video Tutorial

For the video tutorials about extending the Kyma runtime, see

• SAP BTP Kyma Runtime – Extending SAP SuccessFactors | Video Tutorial Series
• SAP BTP Kyma Runtime – Extending SAP S/4HANA Cloud | Video Tutorial Series
• SAP BTP Kyma Runtime – Extending SAP Customer Experience (coming up)

References

For the documentation, see

• Extending SAP Customer Experience Products in the Kyma Environment

SAP Developers Tutorials

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

• Deploy Commerce Mock Application in the Kyma Runtime by Jamie Cawley

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

• LinkedIn > linkedin.com/in/dvankempen
• Twitter > @dvankempen

For the author page of SAP PRESS, visit

• Denys van Kempen