Skip to Content

Deploy a CAP Business Application to SAP Business Technology Platform

test
0 %
Deploy a CAP Business Application to SAP Business Technology Platform
Details

Deploy a CAP Business Application to SAP Business Technology Platform

Iwona Hahn
Iwona Hahn
February 24, 2021
Created by
Iwona Hahn
November 18, 2019
Beginner
30 min.
SAP Cloud Application Programming Model, SAP Business Technology Platform, Tutorial, Node.js, Beginner
This tutorial shows you how to deploy your SAP Cloud Application Programming Model (CAP) application to SAP Business Technology Platform, Cloud Foundry environment.

You will learn

  • How to deploy your business service on SAP Business Technology Platform (SAP BTP) using the SAP Cloud Application Programming Model (CAP) and binding appropriate service instances. See the Developer Guide for Cloud Foundry for more details.
QR code

Prerequisites

Step 1: Enhance project configuration for SAP HANA
View Full Instructions

It’s now time to switch to SAP HANA as a database.

  1. If cds watch is still running in Visual Studio Code, press CTRL+C in the command line to stop the service.

  2. In Visual Studio Code add the following configuration in the file package.json of your my-bookshop project. Overwrite any existing cds configuration:

    "cds": {
  "features": {
    "fiori_preview": true
  },
    "requires": {
      "db": {
        "kind": "sql"
      }
    }
  }

    fiori_preview:true enables SAP Fiori preview also in production mode as you saw it in your local application in the previous tutorial in step 4. This feature is meant to help you during development and should not be used in productive applications.

    kind:sql declares the requirement for an SQL database. It evaluates to sqlite in the development profile (active by default), while in production it equals hana. This way you don’t need to modify this file if you want to switch between the two databases.

    Don’t edit the gen/db/package.json file.

  3. In the command line add the SAP HANA driver as a dependency to your project:

npm add @sap/hana-client --save

In case of problems, see the Troubleshooting guide in the CAP documentation for more details and check that you’ve installed the latest long-term support (LTS) version of Node.js.

Done
Log on to answer question
Step 2: Identify SAP BTP Cloud Foundry endpoint
View Full Instructions

The Cloud Foundry API endpoint is required so that you can log on to your SAP BTP Cloud Foundry space through Cloud Foundry CLI.

  1. Go to the SAP BTP Trial Cockpit and choose Enter Your Trial Account.

    business technology platform cockpit view

  2. Navigate to the Subaccount overview:

    subaccount tile

  3. Navigate to your Subaccount and copy the Cloud Foundry API Endpoint value:

    CF API endpoint value

  4. Go back to Visual Studio Code to the command line. Authenticate with your login credentials using the following command:

cf login

This will ask you to select CF API, org, and space.

The API Endpoint is taken by default. If you want to change the API Endpoint use cf api <CF_API_ENDPOINT> to change the API. Replace <CF_API_ENDPOINT> with the actual value you obtained in the previous step.

Done
Log on to answer question
Step 3: Deploy using cf push
View Full Instructions

SAP BTP, Cloud Foundry environment has a built-in cf push command to deploy applications. It needs the application files plus an optional manifest.yml file to push the application code and to bind the relevant services to the application.

  1. As cf push can only bind but not create services, you need to create the SAP HANA service manually (along with an HDI container and a database schema). In the command line add:

    cf create-service hanatrial hdi-shared my-bookshop-db

    This process takes some minutes.

    Check the status of your service using cf service my-bookshop-db.

    If service creation fails, see the Troubleshooting guide in the CAP documentation for more details.

  2. Now, build and deploy both the database part and the actual application and add:

    cds build --production
cf push -f gen/db
cf push -f gen/srv --random-route

    This process takes some minutes.

    The first part of the command creates the SAP HANA table and view definitions along with manifest.yaml files in both in gen/db and gen/srv folders. Look at gen/db/manifest.yaml and see that it binds to the my-bookshop-db service that you’ve created in the previous step.

    See the section Deploy using cf push in the CAP documentation for more details.

  3. In the deploy log, find the application URL in the routes line at the end:

    name:              my-bookshop-srv
requested state:   started
routes:            my-bookshop-srv-....cfapps.....hana.ondemand.com

  4. Open this URL in the browser and try out the provided links, for example, .../catalog/Books. Application data is fetched from SAP HANA. If enabled in step 1 you can also try the Fiori preview.

    application preview

  1. As cf push can only bind but not create services, you need to create the SAP HANA service manually (along with an HDI container and a database schema). In the command line add:

    cf create-service hanatrial hdi-shared my-bookshop-db

    This process takes some minutes.

    Check the status of your service using cf service my-bookshop-db.

    If service creation fails, see the Troubleshooting guide in the CAP documentation for more details.

  2. Now, build and deploy both the database part and the actual application and add:

    cds build --production && cf push -f gen/db && cf push -f gen/srv --random-route

    This process takes some minutes.

    The first part of the command creates the SAP HANA table and view definitions along with manifest.yaml files in both in gen/db and gen/srv folders. Look at gen/db/manifest.yaml and see that it binds to the my-bookshop-db service that you’ve created in the previous step.

    See the section Deploy using cf push in the CAP documentation for more details.

  3. In the deploy log, find the application URL in the routes line at the end:

    ```Shell/Bash
name:              my-bookshop-srv
requested state:   started
isolation segment: trial
routes:            my-bookshop-srv-....cfapps.....hana.ondemand.com
```

  4. Open this URL in the browser and try out the provided links, for example, .../catalog/Books. Application data is fetched from SAP HANA. If enabled in step 1 you can also try the Fiori preview.

    application preview
Which categories can you see in your browser?
×

Give us 55 seconds of your time to help us improve

Next Steps

Navigate tutorial steps

QR Code

QR code
Back to top