README.md

DEV261 - Build Extensions with SAP BTP, Kyma Runtime

Description

This repository contains the material for the SAP TechEd 2021 session called DEV261 - "Build Extensions with SAP BTP, Kyma Runtime".

The video replay is now available.

Overview

This session introduces attendees to making use of the advantages that come along with Kubernetes in the context of their SAP BTP projects. SAP BTP, Kyma runtime is the fully managed Kubernetes runtime based on the open-source project "Kyma". This cloud-native solution allows the developers to extend SAP solutions with serverless Functions and combine them with containerized microservices. The offered functionality ensures smooth consumption of SAP and non-SAP applications, running workloads in a highly scalable environment, and building event- and API-based extensions.

During this session, you will learn how to make use of SAP BTP services in the context of a Kyma-based project.

This application will also make use of the services:

• SAP Launchpad service
• SAP HANA Cloud
• SAP Alert Notification
• SAP HTML5 Application Repository

⚠ NOTE: Particularly the enablement of SAP BTP, Kyma runtime and instance creation of SAP HANA Cloud takes around 1 hour. Therefore, it is recommended that you finalize Getting Started ahead of time.

The overall solution will finally look like this:

You will also see how to setup your continuous integration and delivery pipeline using "SAP Continuous Integration and Delivery" for deploying a CAP application.

Requirements

To follow the exercises in this repository, you can also use a free SAP BTP trial account or you make use of the free tier inside your SAP BTP global account. Details are described on SAP.com.

Furthermore, you need to have the following tools and frameworks installed on your computer:

• kubectl
• nodejs version 14.*
• jq - for JSON processing in CLI
• Docker Desktop installed with a valid public account

  ⚠ NOTE: Be aware of the terms of Docker for usage in enterprises. For details see link

⚠ NOTE: The various hands-on exercises uses docker and Kubernetes extensively. A basic knowledge of these technologies will also be helpful.

• For MS Windows clients, it is recommended to use PowerShell

Exercises

• Getting Started
  • FORK AND CLONE REPO
  • SAP BTP SUBACCOUNT CONFIGURATION
  • SAP KYMA RUNTIME
  • SAP LAUNCHPAD SERVICES
  • SAP CLOUD FOUNDRY CONFIGURATION
  • SAP CONTINUOUS INTEGRATION & DELIVERY SERVICE
  • SAP HANA CLOUD
• Exercise 1 - CREATE THE XSUAA SERVICE INSTANCE
• Exercise 2 - PREPARE APP FOR LOCAL USE (optional)
• Exercise 3 - CONFIGURE THE SAP CICD SERVICE
  • Exercise 3.1 - CREATE THE GITHUB CREDENTIAL
  • Exercise 3.2 - CREATE THE DOCKER CREDENTIAL
  • Exercise 3.3 - CONFIGURE KUBECONFIG
  • Exercise 3.4 - ADD THE GITHUB REPOSITORY
  • Exercise 3.5 - CREATE THE CICD JOBS
    • Exercise 3.5.1 - CAP-ORDERS-SERVICE
    • Exercise 3.5.2 - ORDERS-HTML5-DEPLOYER - OPTIONAL
    • Exercise 3.5.3 - ORDERS-DB-DEPLOYER- OPTIONAL
    • Exercise 3.5.4 - CAPUITOOLS - OPTIONAL
• Exercise 4 - GENERATE TOOLS BASE IMAGE
• Exercise 5 - GENERATE THE CAP DATABASE
  • Exercise 5.1 - DEPLOYMENT OPTION 1 - SAP CICD
  • Exercise 5.2 - DEPLOYMENT OPTION 2 - kubectl
  • Exercise 5.3 - DEPLOYMENT OPTION 3 - Helm
• Exercise 6 - DEPLOY HTML5 APP AND LAUNCHPAD CONFIG
  • Exercise 6.1 - DEPLOYMENT OPTION 1 - SAP CICD
  • Exercise 6.2 - DEPLOYMENT OPTION 2 - kubectl
  • Exercise 6.3 - DEPLOYMENT OPTION 3 - Helm
• Exercise 7 - BUILD AND DEPLOY CAP SERVICE
  • Exercise 7.1 - DEPLOYMENT OPTION 1 - SAP CICD
  • Exercise 7.2 - DEPLOYMENT OPTION 2 - kubectl
  • Exercise 7.3 - DEPLOYMENT OPTION 3 - Helm
• Exercise 8 - CONFIGURE LAUNCHPAD
• Exercise 9 - REQUIRE OAUTH FOR THE ACTION
• Exercise 10 - SAP ALERT NOTIFICATION CONFIGURATION
• Exercise 11 - MOCK APPLICATION

How to obtain support

Support for the content in this repository is available during the actual time of the online session for which this content has been designed. Otherwise, you may request support via the Issues tab.

Contributing

If you wish to contribute code, offer fixes or improvements, please send a pull request. Due to legal reasons, contributors will be asked to accept a DCO when they create the first pull request to this project. This happens in an automated fashion during the submission process. SAP uses the standard DCO text of the Linux Foundation.

Code of Conduct

Please note, that we have a code of conduct, please follow it in all your interactions with the project.

License

Copyright (c) 2021 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE file.