/cloud-dirigible

Dirigible is an open source project that provides Integrated Development Environment as a Service (IDEaaS) as well as the runtime engines integration for the running applications

Primary LanguageJavaApache License 2.0Apache-2.0

dirigible

Build Status

Dirigible is an Integrated Development Environment as a Service (IDEaaS) for dynamic applications. It provides both development tools and runtime environment.

dirigible logo

Enjoy Programming Like Never Before

From the end user's perspective (developer), Dirigible runs directly in the browser, therefore does not require any downloads or installations.

From the service provider's perspective (PaaS/SaaS), Dirigible packs all required components in a self-contained software bundle that can be deployed in any Java-based web server, such as Tomcat, Jetty, JBoss.

Dirigible supports access to RDBMS via JDBC. Currently supported versions for RDBMS are HANA 1.x, MaxDB, Sybase ASE (experimental), and PostgreSQL (experimental).

The project started as an internal SAP initiative to address the extension and adaption use-cases related to SOA and Enterprise Services.

Try

You can try a full fledged Dirigible deployment on HANA Cloud Platform. Create your own unlimited free trial account at https://account.hanatrial.ondemand.com/.

You can also try the sandbox instance with restricted functionality that is available at http://trial.dirigible.io.

Get Started

Download

The "fast-track" - you can download the precompiled binaries produced from the released versions from https://github.com/SAP/dirigible/releases/ and skip the build section.

Nevertheless, we highly recommend building the binaries from source in order to have all experimental features that are not available in the releases.

Build

Prerequisites

--- Use Maven 3.0.x! ---

Steps

  1. Clone the project repository or download the latest release.

  2. Go to the com.sap.dirigible/com.sap.dirigible.parent folder.

  3. Build the project via

     mvn clean install

The build should pass successfully. The produced WAR files under sub-folder com.sap.dirigible/com.sap.dirigible.parent/releng are ready to be deployed. There are separated deployable artifacts (WAR files) depending on the usage type and the technical platform.

Deploy

HANA Cloud Platform

Deploy on HANA Cloud Platform with the Cloud SDK.

Prerequisites
Steps

  1. Go to the neo-java-web-sdk-1.xxx/tools SDK folder.

  2. Deploy with command:

     neo deploy --account <your_account> --application <application_name> --user <your_user> --host <target_landscape_host> --source <source_directory> --password <your_password>

  3. Start with command:

     neo start --account <your_account> --application <application_name> --user <your_user> --host <target_landscape_host> --password <your_password> -y

  4. Go to https://account.hanatrial.ondemand.com/cockpit at Authorizations section. Add Developer and Operator role to your user which gives you full access to all features.

Tomcat

The Tomcat specific WAR files can be deployed on Tomcat web container. In this case the built-in Derby database is used.

More information about how to deploy on Tomcat can be found here.

Steps

  1. For simplicity rename the WAR dirigible-all-tomcat-xxx.war to dirigible.war.

  2. Configure Users store:

     <tomcat-users>
         <role rolename="Developer"/>
         <role rolename="Operator"/>
         <role rolename="Everyone"/>
         <user username="dirigible" password="dirigible" roles="Developer,Operator,Everyone"/>
 </tomcat-users>

  3. Open a web browser and go to:

     http://localhost:8080/dirigible

  4. Login with dirigible/dirigible.

Eclipse

The IDE part can be run directly via Eclipse. This is useful when testing new features during development.

Prerequisites
Steps

  1. Import the project as existing Maven project into your local Eclipse environment.

  2. Go to project com.sap.dirigible/com.sap.dirigible.parent/platform/com.sap.dirigible.platform.target and open the file com.sap.dirigible.platform.base.target using the Target Editor.

  3. Click on the Set as Target Platform link and wait until the required bundles get synchronized.

  4. Use dirigible-local.launch file for Run As configuration.

  5. Open a web browser and go to:

     http://localhost:8080/dirigible

CloudFoundry

Prerequisites
Steps

  1. Login to CloudFoundry Platform with:

     cf login -a [CloudFoundry Platform Host]

  2. Deploy on the CloudFoundry supported Cloud Platform with:

     cf push dirigible -p [path to the target directory]/dirigible-all-tomcat-xxx.war -b https://github.com/dirigible-io/java-buildpack

  3. Open a web browser and go to:

     http://dirigible.[CloudFoundry Platform Host]/

  4. Login with user dirigible and password dirigible which are set by default in the custom buildpack used above.

Additional Information

License

This project is copyrighted by SAP AG and is available under the Apache License 2.0. See LICENSE.txt and NOTICE.txt for further details.

Contributors

If you'd like to contribute to Dirigible, please file an issue or send us a pull request.

References

Update Sites