Skip to content

DMihaylova/dirigible

 
 

Repository files navigation

Eclipse Dirigible™

Build Status Build Status Eclipse License Download Dirigible Maven Central GitHub contributors FOSSA Status

Eclipse 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, MaxDB, Sybase ASE, PostgreSQL, H2, and Derby.

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

Instant Trial

You can try the sandbox instance to have a quick look on the functionality you are interested http://trial.dirigible.io.

Get Started

Download

The "fast-track" - you can download the precompiled binaries produced from the Hudson builds from http://download.eclipse.org/dirigible 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

2.x

Prerequisites
Steps
  1. Clone the project repository - master-2.x branch or download the latest 2.x sources.

  2. Go to the org.eclipse.dirigible/org.eclipse.dirigible.parent folder.

  3. Build the project with:

     mvn clean install
    

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

3.x

Prerequisites
Steps
  1. Clone the project repository - master branch or download the latest 2.x sources.

  2. Go to the root folder.

  3. Build the project with:

     mvn clean install
    

The build should pass successfully. The produced WAR files under target sub-folder releng are ready to be deployed. There are separated deployable artifacts (WAR files) depending on the usage type.

Deploy

Trial

Trial package combines the deployable artifacts of Dirigible along with the Tomcat web container and Derby database. It is useful for quick exploration of Dirigible features.

Steps
  1. Build the project with:

    mvn clean install -P trial

The build should pass successfully. Find the produced produced executable JAR file under target sub-folder at org.eclipse.dirigible/org.eclipse.dirigible.parent/releng.

  1. Run with:

    java -jar dirigible-all-tomcat-trial-executable.jar

  2. Open a web browser and go to:

     http://localhost:8080/dirigible/services/ui/anonymous.html	
    

HANA Cloud Platform

Deploy on HANA Cloud Platform with the Cloud SDK.

Prerequisites
Steps
  1. Go to the neo-java-web-sdk-2.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. Run preparation command

     mvn eclipse:eclipse 
    
  2. Import the project as existing Maven project into your local Eclipse environment.

  3. Go to project org.eclipse.dirigible/org.eclipse.dirigible.parent/platform/org.eclipse.dirigible.platform.target and open the file org.eclipse.dirigible.platform.base.target using the Target Editor.

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

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

  6. 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]/dist/tomcat/allinone/ROOT.war -b https://github.com/dirigiblelabs/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.

Docker

Prerequisites
Steps
  1. Pull the already built container from Docker Hub

     docker pull dirigiblelabs/dirigible-trial
    
  2. Start the container

     docker run -p 8888:8080 dirigiblelabs/dirigible-trial <&- &
    
  3. Open a web browser and go to:

     http://localhost:8888/
    
  4. Optionally you can enhance and customize the Dockerfile from here

Additional Information

License

This project is copyrighted by SAP SE and is available under the Eclipse Public License v 1.0. See LICENSE.txt and NOTICE.txt for further details.

FOSSA Status

Contributors

If you like to contribute to Dirigible, please read the Contributor's guide.

References

Update Sites

About

Eclipse Dirigible™ Project

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 77.4%
  • Java 13.7%
  • CSS 5.4%
  • HTML 3.5%