Skip to content

Deployment

Jump to bottom
Martin Večeřa edited this page Mar 13, 2018 · 19 revisions

This document describes how to use IntelliJ IDEA to quickly deploy the application to WildFly application server during the development process. You will need Ultimate Edition since the features used here are not available in the Community Edition.

MongoDB Configuration

You will need your own local instance of MongoDB to run the application on your machine.

You can either use docker or the manual way listed below. For docker, run docker run -itd --name my-mongo mongo. To stop it run docker stop my-mongo. To start it again later with the previous data run docker start my-mongo. To discard it, while stopped run docker rm my-mongo.

Alternative manual way:

  1. Install MongoDB
    1. Go to MongoDB Download Center
    2. Download the latest MongoDB for your platform
    3. Install MongoDB according to the instructions on the website
  2. Run MongoDB
    1. Run mongod in the command line
    2. Keep it running during the development process

You can use MongoDB plugin for IntelliJ IDEA to see the actual content of the database.

WildFly Configuration

In order to be able to deploy the application by one click, you will need to configure WildFly in your IDE:

  1. Prepare WildFly application server
    1. Open a command line in the engine folder
    2. Run mvn clean install -DskipTests
    3. Go to war/target folder
    4. Copy wildfly-10.1.0.Final to some other location (preferably outside of the project)
  2. Enable JBoss Integration plugin
    1. Open IntelliJ IDEA
    2. Go to File -> Settings -> Plugins
    3. Find and check JBoss Integration
    4. Apply the changes and restart the IDE
  3. Add a new application server
    1. Go to File -> Settings -> Build, Execution, Deployment -> Application Servers
    2. Click on a green plus button (Add application server)
    3. Select the path to your copy of wildfly-10.1.0.Final directory
    4. Save the changes
  4. Modify Run/Debug Configurations
    1. Go to Run -> Run/Debug Configurations
    2. Click on a green plus button
    3. Select JBoss Server -> Local
    4. Change the name to Lumeer WildFly
    5. Choose the previously added application server
    6. Change the URL to http://localhost:8080/lumeer-engine
    7. On the Deployment tab add new artifact engine-war:war
    8. Save the settings

Application Deployment

After you have successfully configured both MongoDB and WildFly, you can run the application from your IDE:

  1. Deploy the application
    1. Select previously created Lumeer WildFly configuration in the top right corner of the screen.
    2. Click run button and wait for the deployment
    3. Access some REST endpoint from your browser
  2. Redeploy the application
    1. Make some changes in the code
    2. Click Update application button in the left panel on the bottom of the screen
    3. Choose if you want to restart the whole server or just redeploy the application

Web UI Deployment

See web-ui README.

Clone this wiki locally