Exercise: Deploying TypeScript NestJS Application to SAP BTP

Objectives

After completing this lesson, you will be able to:

  • Deploying TypeScript NestJS application to SAP BTP

Deploying TypeScript NestJS application to SAP BTP

Deploying application to SAP BTP

In this exercise, you will learn how to deploy the application to SAP BTP.

Prerequisites

For the complete execution of current exercise, you must execute the following activities first, using SAP Business Application Studio:

  1. Execute the following exercises:
    • Creating your free trial account in SAP BTP
    • Setting up the mock server, so that you have the Mock server program available in the cloud-s4-sdk-book folder.
  2. Run the following commands in a terminal, in case you didn't do it already in previous exercises, to clone the Git repository for the course:
    Code snippet
    cd ~/projects
    git clone https://github.com/SAP-samples/cloud-sdk-learning-journey.git
    Expand
  3. Choose FileOpen Folder and open the /home/user/projects/cloud-sdk-learning-journey/ folder.

Steps

  1. Checkout the branch tsnestjs_v4.0_deploytocf in SAP Business Application Studio

    1. Run the following commands in the terminal.

      Code snippet
      cd ~/projects/cloud-sdk-learning-journey
      git checkout -f tsnestjs_v4.0_deploytocf
      Expand
  2. Login to Cloud Foundry, using the terminal

    1. Make sure you have the API Endpoint, the email and the Password of your Cloud Foundry account.

    1. In the terminal, run

      Code snippet
      cf login
      Expand

      Enter the required information and make sure that login is successful.

  3. Build and push the project to SAP BTP

    1. Build and push the application to SAP BTP by running the following commands in the terminal, replace YOUR_APIKEY_GOES_HERE with your API Key, eventually get your API Key at https://api.sap.com/api/API_BUSINESS_PARTNER/overview):

      Code snippet
      cd cloudsdk_bp_ts
      cf create-service destination lite mydestination
      cf create-service xsuaa application myxsuaa
      npm i
      npm run build
      cf push
      cf set-env cloudsdk_bp_ts DESTINATION_NAME bpdestination
      cf set-env cloudsdk_bp_ts APIKEY YOUR_APIKEY_GOES_HERE
      cf restage cloudsdk_bp_ts
      Expand
      Note
      You will have to login to your SAP BTP Cloud Foundry account before running the cf commands. Since the application depends on xsuaa and destination service, we need to create an instance of these services before deploying the application
    2. Verify that the application is successfully deployed in SAP BTP and the myxsuaa and mydestination services are bound to the application

  4. Create a destination named bpdestination in the SAP BTP subaccount with the following values

    FieldValue
    Namebpdestination
    TypeHTTP
    URLhttps://sandbox.api.sap.com/s4hanacloud
    Proxy TypeInternet
    AuthenticationNoAuthentication
    1. In the SAP BTP Cockpit, access your Subaccount overview and navigate to ConnectivityDestinations

    2. Create a new destination using the given info, as indicated in the following figure.

  5. Query the Business Partner API of SAP S/4HANA Cloud

    1. Find out the URL of the application. After successful completion of the command cf push, the URL is displayed on the screen

      You can find the same URL in the subaccount overview, navigating to Cloud FoundrySpacesDevcloudsdk_bp_tsApplication Routes

    2. Open a new tab and browse to https://APPLICATION_URL/business-partner. APPLICATION_URL is the URL you copied after executing the cf push command

    3. Verify that you are able to retrieve all the business partners

      Note
      The destination values can be modified to connect to an actual SAP S/4HANA Cloud system. Also, the SAP API Business Hub does not support CREATE, UPDATE operations
  6. Optional: code walk-through.

    1. Review code in the following source files:

      File nameComments on code changes
      manifest.yml

      Configuration values are as follows...

      1. Provide basic application information like name, memory, timeout, path etc.
      2. Specify that the application depends on myxsuaa and mydestination services
      requests.httpProvides various HTTP requests that can be submitted to query the Business Partner API
      commands.txtProvides various commands that can be run on the terminal

Log in to track your progress & complete quizzes