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.
|