Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Java
  • Maven
  • Here we describe the setup in IntelliJ, but you can use an IDE of your choice
  • Docker / Docker Compose

Development Environment

In this setup we will start the backend, connect, and the processors in your IDE. The UI and all the other services run in docker.

...

  1. Clone Installer [Link]

    Code Block
    languagebash
    titlePrepare Installer
    # SSH
    git clone git@github.com:apache/incubator-streampipes-installer.git
    
    # HTTPS
    git clone https://github.com/apache/incubator-streampipes-installer.git 
    
    # switch to development branch
    git checkout dev


  2. Open CLI directory

    Code Block
    languagebash
    titlePrepare Installer
    cd incubator-streampipes-installer
    cd cli


  3. Configure StreamPipes for backend development

    Code Block
    languagebash
    titlePrepare Installer
    ./spstreampipes env --set-template backend-dev
    # Updates the file 'system'. All StreamPipes services required for development are selected

Set-Up repository


  1. Start third party services (e.g. CouchDB, Kafka, ... in docker)

    Clone StreamPipes [Link]

    Code Block
    languagebash
    titlePrepare Installer
    # SSH
    git clone git@github.com:apache/incubator-streampipes.git
    # HTTPS
    git clone https://github.com/apache/incubator-streampipes.git up -d


Set-Up repository

  1. Open the project in your IDE

...

  1. Add a new application with the following Run/Debug Configurations
  2. Main class: org.apache.streampipes.backendservice.core.StreamPipesBackendApplication
  3. Use classpath of module: streampipes-backendservice-core
  4. Environment variables: streampipes-service-backendcore/development/env
  5. Apply, OK & Start the application
  6. Navigate to "http://localhost:8030/streampipes-backend/" to see if the backend is running. You should see the following message:

Image Removed

Set-Up Connect Master

  1. Add a new application with the following Run/Debug Configurations
  2. Main class: org.apache.streampipes.connect.container.master.init.AdapterMasterContainer
  3. Use classpath of module: streampipes-connect-container-master
  4. Environment variables: streampipes-connect-container-master/development/env
  5. Apply, OK & Start the application
  6. Navigate to "http://localhost:8099/" to check if the connect master is running. You should see the following message:

Instead of the development file, we also provide a startup configuration for IntelliJ under development/runConfigurations, which should be added automatically to the project.

Image AddedImage Removed