Welcome to this series of hands on tutorials from the SAP HANA Academy
I'm Philip Mugglestone
in this series, we're covering the SAP Business Technology Platform
in this video tutorial we're going to
get started with the SAP BTP, Kyma runtime environment.
Now we've got our global account here but we don't have any sub accounts yet.
We need to create one but we need to make sure
it's one that's going to actually
work with the SAP BTP, Kyma runtime environment.
So if we go to discovery center we've seen this previously we can search on
SAP BTP, Kyma runtime
we can find the SAP BTP, Kyma runtime run time here
and we can see for example we've got the standard service plan,
we've got the free service plan
and it's available in these data centers.
Now,
just one thing to notice the service plan you see here is not
exactly what you might see actually when you're in the SAP BTP cockpit,
you're more likely to see the actual name of the provider for the standard plan.
Let's go to our cockpit check our entitlements service assignments,
we can filter on SAP BTP, Kyma runtime
and indeed we can see we've got a plan for
each of these environments with the quota of one.
So we should be good to go.
Let's go ahead and create a new sub account.
I'm going to base the name on my project
and as we've seen in previous video tutorials,
I'm going to make sure that sub domains something straightforward
and easy to work with and meaningful to me.
Then I'm going to select my region.
So we were going to work with AWS and US east Virginia.
So that we can see select that one Then we can go ahead and create
once the on boarding of the sub accounts completed we can select the tile
and we can go to entitlements and then we'll need
to configure the entitlements for the SAP BTP, Kyma runtime run time.
So we'll add service plans,
we can search on SAP BTP, Kyma runtime
and we'll select the available plan.
In this case it's the Amazon Web Services plan and add the service plan
and then we'd hit save
so now we should be able to go ahead and actually inst an
xI eight hour runtime environment for SAP BTP, Kyma runtime
So if you go to the overview
we should see that SAP BTP, Kyma runtime environment is now in the list.
Now you can have that in addition to SAP BTP, Cloud Foundry runtime in
addition to SAP BTP, ABAP environment or in
this case just stand alone completely
up to you but this is a multi environment sub account
so you can mix and match these as you choose.
So let's enable SAP BTP, Kyma runtime
and then we'll need to choose the plan again we've just got that
first one here that's the one that's relevant for an AWS region,
we can give it an instance name.
Maybe I'll just put
SAP BTP, Kyma runtime at the end and also a name for the cluster.
I'll stick with the sub account.
We're only gonna have one SAP BTP, Kyma runtime environment per sub account.
That's it Next
now you have the ability to customize this JSON here if
you want to actually change some of the settings for example,
change the machine type that's going to be used,
change the auto scaled min and max et cetera.
I'll stick with the defaults hit next
and then we go ahead and hit create.
Now as it mentions this might take a little bit of time
so whilst we're waiting for that,
what we can do is go over some of the prerequisites in terms of the tooling
that you'd want to have when working with the SAP BTP, Kyma runtime.
Now you're gonna want some kind of mechanism that you can use to edit your files,
a text editor.
I'm going to work with visual studio code but
that's just one of many options you could choose.
And the great thing about that is I can easily open up a new terminal.
So we're going to want to have a number of tools Now, if you're working on a Mac as I am,
then actually the X code command line tools will
actually provide some of those for example GIT and make
Now if you don't have the X code command line tools installed,
you can do that using X code dash select dash dash installed.
That's one way of doing it also you can check if it's installed, you can print
or you can check the current version. If you're working on a windows.
Then you might use chocolatey to actually install some of the things
we're going to see one of the first ones would be GIT.
So we can go and try
see if I've got get installed.
Indeed I have that actually comes with the xcode command tools
and another one of those is also make that normally comes
with the xcode command tools.
But of course you can go and install
those directly yourselves so forget you can go here
and for make,
you can go here.
That's where you get all the information about how to download,
install GIT and make manually.
In the examples we'll be seeing,
we're gonna be working with Node.js so you want to
make sure that Node.js is installed so you can try node
and also npm the node package manager.
It's up to you how you install that there are different ways of doing it.
You can go to Node.js dot org and actually install it explicitly
from a package or you can install it using npm the node version manager
and you can find more details about the node version manager here.
That's quite good because it allows you to have multiple different versions
of node actually installed on the same system at the same time.
Now we're also going to need some tooling for creating our containers
and typically that you might use something like Docker.
So for that we can just go
to docker dot com
if you click on, get started,
you'll see we've got Docker desktop
now you can actually download and install that. Be aware.
There are licensing restrictions for using Docker desktop when
you're working in an enterprise of a certain size.
There are alternatives for example, we might also use something called podman
and you can find more details about it here.
Postman dot io and this is free to use for anyone and that's what I'm going to be using.
You can also avoid needing a container system locally on
your desktop if you use CI/CD for example,
it will use a tool called kaniko.
So what we can do is just check it actually installed
Postman version we see it's up and running
and we've actually got a machine initialized and started
now we'll also need to make sure we post our containers to a
public repository before we can actually
use them from the SAP BTP, Kyma runtime environment.
So for that we can use Docker hub.
So we saw here there's actually a link for Docker hub,
you can click to sign up to it here.
So this is where we'll actually manage our repositories of container images.
Now, one thing that's very important,
you're going to need to know what your docker ID.
is
so we can see here in my case it's going to be the ID hanaacademy
Now we're also going to want to have command line access
to manage our containers and for that we can use kubectl
so we can just check if that is actually installed.
Indeed it is and when you're working
with SAP BTP, Kyma runtime we're also going to need to
have a specific mechanism of doing our login to make sure it's done fully securely
and for that what we can do is install the O I D C dash login component and we can
that using krew,
you can get more information on installing krew here
and then the command we would use would be
kubectl krew install and then oidc-login.
Now we're also probably going to want to have a package manager that we can use and for
that most people would probably want to use helm
so you can find more details about helm here,
helm dot sh package manager for
Kubernetes
and we can just check it installed by trying helm and version
Now we're going to need to make sure we're logged in effectively
to docker and docker hub and we can do that either using the
docker login command or we can use the podman log in command
which effectively will do the same thing if you're using podman.
So that's what I'm gonna do, I'm gonna say podman
log in and then docker io as to where we want to log in to give my user name,
we saw a moment ago and now we need to put in my password
and we're now successfully logged in something else you can do whilst
you're waiting for that to complete is to check out the reference guide
if you go to help and then /docs/BTP
we've seen that previously and then scroll down,
we'll say that we've got a section on the multi cloud environment
and there's a section on the SAP BTP, Kyma runtime environment within their
and this is where you can get lots
more background information and also some of the setup
stuff that we're doing here in terms of
getting up and running with the SAP BTP, Kyma runtime environment.
So you can see basically it's creating
us a kubernetes cluster provisions through the project Gardner
and then it's actually installing the open
source project SAP BTP, Kyma runtime actually in that environment.
So now we can see that the SAP BTP, Kyma runtime environment has been created.
So the first thing we can do is to go to the console
so we can link to the dashboard here will access the console.
So this is the SAP BTP, Kyma runtime console or dashboard.
There are some important things here, for example, we can see the API server address
that's something we're going to be needing at some
point in the future when we're creating our applications also
notice that we've got a section for name spaces
so for example we can create name spaces here.
So what I might do is actually go ahead and create a name space,
we maybe call it DEV for our development and hit create
so we can see some of the information available for our name space now,
what we'll also need to do is get access
from the command line using the kubectl command.
So for that what we can do is just go back,
you'll see that there's a link here to the kubeconfig URL
so we want to do is select that I notice it downloads us a file.
kubeconfig dot YAML Now this has all the connection details that
we need so what we can do from a command line,
if we now have a just quick look we should find yet we've
got our kubeconfig dot YAML we need to set an environment variable called
kubeconfig
to the location of that file so we can do it on a mac,
it would be the export command, on power shell
it will be slightly different on Windows, kubeconfig equals.
And then it's
this location of the file so that we can also do is enable read access
to that file and then we should be able to use the kubectl command,
we've seen this already now that we've got a kubeconfig file,
it should be able to connect to our environment so indeed.
Now when we run it we can see that it's actually able to connect to our system and if
we want to for example look at the different name
spaces we could try kubectl get ns for name spaces
and we can see the different name spaces including the one called dev
that we have just created using the dashboard.
So we're now up and running and ready to go with SAP BTP, Kyma runtime Environment
in order to make it easier to develop extension
applications that you would deploy to the SAP BTP, Kyma runtime environment.
We can also use yeoman generators available
from the SAP HANA Academy So to do that,
we need to make sure we install the yeoman tool now this is
a node module so for that one we would install yeoman globally,
so npm i to install -g for global and then yo for yeoman
and then we would want to install our generator in this case it's generator-saphanaacademy-mta we can install that globally
and then we should be able to use the yo command
and indeed we see we have our SAP HANA Academy MTA generator installed.
Now if you prefer to have something more of a Ui what we can also do
is install the application wizard extension in visual studio code.
If you go to extensions, search on application wizard,
see it comes from SAP and then we can install it
and then we can go to the view and command palette and then we can search on wizard
and open the template wizard and then we'll
see that we've got our generator ready to use
Now if you want to see some more examples of
how you can actually work with the SAP BTP, Kyma runtime,
then you can go to the SAP HANA Academy youtube channel.
If you scroll down, you'll find a number of series for example,
we've got a series in the SAP BTP section,
showing the SAP BTP, Kyma runtime we've also got a series, for example,
when we're looking at the SAP Extension Suite where we're doing different extensions,
for example, extending SAP Commerce Cloud using APIs,
this will use the SAP BTP, Kyma runtime, also extending
SAP C/4HANA using APIs
that also uses the SAP BTP, Kyma runtime.
And if you want to see an example of an application,
we can go to the series on SAP Graph and then in there we
actually have an example of how to use SAP Graph using the yeoman generator
and actually doing all that building, basically full stack application using
the SAP BTP, Kyma runtime. So maybe think about checking that out.
So in this video tutorial we've seen how to get
started with the SAP BTP, Kyma runtime from our SAP BTP cockpit,
we've actually seen the dashboard be created a name space.
We looked at all the prerequisites for different
tools and we also used the kubeconfig URL
so that we can actually log on and access the system using the kubectl command line,
you can find more video tutorials on our Youtube channel
if you'd like to be informed as soon as
new video tutorials are published then please subscribe.
Thanks for watching