Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
cancel
Showing results for 
Search instead for 
Did you mean: 
dvankempen
Product and Topic Expert
Product and Topic Expert








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

For more partner-focused hands-on developer series, see

To be informed when new posts are published about partner-related content in the video tutorials series, follow tag

Questions? Please post as comment.

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

Thanks!



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

 



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.

https://youtu.be/XWbCEz5VLdI?list=PLkzo92owKnVwySEcbf_FCf-ToasK4hXc9

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


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.

https://youtu.be/Jc7OBsw-lW0

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

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


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.

https://youtu.be/bQQAqFJ8-4w

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


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.

https://youtu.be/rRU9QGI9tKo

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


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

References


For the documentation, see

SAP Developers Tutorials


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


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 milestone and, as sign of current interest, still tickle the counters each month.