Skip to Content
Technical Articles

How to deploy Eclipse Dirigible in the SAP Cloud Platform Cloud Foundry environment

Overview


Eclipse Dirigible is an open-source cloud development platform that provides capabilities for end-to-end development processes from database modeling and management, through RESTful services using server-side JavaScript, to pattern-based user interface generation, role-based security, external services integration, testing, debugging, operations and monitoring.

Some of the unique features include:

The platform aims to unify open-source business services by providing software developers with a convenient set of tools for building, running, and operating business applications in the Cloud. Dirigible is also part of the Eclipse Cloud Development top-level project.

Setup


Starting with the Eclipse Dirigible 4.3 release, there is a built-in integration with the SAP Cloud Platform Cloud Foundry environment. To deploy Eclipse Dirigible in your Cloud Foundry space, follow these steps:

  • Install the Cloud Foundry CLI. You can either get the latest release on the official release page or use your package manager
  • Clone the Eclipse Dirigible Deployment to the SAP Cloud Platform Cloud Foundry repository
    git clone https://github.com/dirigiblelabs/deployment-sap-cloud-foundry​
  • Navigate to the dirigible folder
  • Replace the following variables in vars.yaml before deploying
    Name Description Default Value
    applicationName The application name (e.g. dirigible) N/A
    subdomain The SAP Cloud Platform Cloud Foundry subdomain N/A
    regionId The SAP Cloud Platform Cloud Foundry region id N/A
    runtimeMemory The runtime memory for the Eclipse Dirigible runtime 2G
    runtimeDiskQuota The runtime disk quota for the Eclipse Dirigible runtime 2G
    runtimeDockerImageTag The docker image version of Eclipse Dirigible latest
    • Replace the subdomain with your subdomain, which you can find in the SAP Cloud Platform cockpit in your Cloud Foundry subaccount  overview page:
    • Replace the regionId with your specific region (e.g. eu10). You can find it in the API endpoint just before hana.ondemand.com. More details on the region specific URLs can be found here.
  • Replace the <applicationName> in xs-security.json, it should match the one that you’ve entered in the vars.yaml
  • Create an XSUAA service instance
    cf create-service xsuaa application <applicationName>-xsuaa -c xs-security.json​

Replace <applicationName> before executing the command, it should match the one that you’ve entered in the vars.yaml

  • Deploy Eclipse Dirigible
    cf push --vars-file vars.yaml
  • Assign the Developer and the Operator role to your user from the SAP Cloud Platform cockpit
    1. Navigate to your subaccount.
    2. Go to SecurityRole Collections.
    3. Create New Role Collection (e.g. dirigible):
    4. Select the newly created role collection (e.g. dirigible).
    5. Add the Developer and the Operator roles to the role collection:
    6. Go to Security → Trust Configuration and select your trust configuration (e.g. SAP ID Service):
    7. Enter your e-mail address and click the Show Assignments button.
    8. Click Assign Role Collection and assign the your role collection (e.g. dirigible):
  • Access the Eclipse Dirigible instance at: https://<applicationName>-<subdomain>.cfapps.<regionId>.hana.ondemand.com
    1. Navigate to your space.
    2. Select the newly created application (e.g. dirigible).
    3. Access the Eclipse Dirigible instance by clicking the application route:
  • Once started, you can begin developing your next business application with Eclipse Dirigible

 

Notes


Next you can follow the Samples section to master some of the basic functionalities, explore the Enterprise JavaScript APIs, check out the YouTube channel for video content or simply visit the official site for news and updates.

2 Comments
You must be Logged on to comment or reply to a post.