Versions Compared

Key

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

Checking out the code

Info

Requirements: git

...

, GitHub Account


  1. Create a remote fork of https://github.com/Taskana/taskana

    Info
    titleFork A Repo (Github Help)

    see https://help.github.com/articles/fork-a-repo/


  2. Configure git to automatically adjust line endings with each commit (optional, but recommended)

    Code Block
    languagebash
    git config --global core.autocrlf input


  3. Create a local clone

    Code Block
    languagebash
    # using https
    git clone https://github.com/<yourname>/taskana.git
    # using ssh
    git clone git@github.com:<yourname>/taskana.git


  4. Configure git to automatically validate your commit messages (more information: Contribution Guide)

    Code Block
    languagebash
    cd taskana
    git config core.hooksPath qa/hooks
    1. Optional: Create a symlink to .git/hooks in order to support external tools

      Code Block
      rm -rf .git/hooks
      ln -s $PWD/qa/hooks .git/hooks


  5. Create a remote for the upstream project so that it is later easier to retrieve changes from the main repository.

    Code Block
    languagebash
    cd taskana
    # using https
    git remote add upstream https://github.com/Taskana/taskana.git
    # using ssh
    git remote add upstream git@github.com:Taskana/taskana.git


Build the application(s)

Info

Requirements: java, mavennode, nodeyarn


Info

Version requirements: Java 811, Maven 3Node 16.6.0, Node  12.10.014.2


Info

We use maven wrapper. For windows please use mvnw.cmd instead of the bash script


Full build

Code Block
languagebash
mvn clean install

Taskana Library

Code Block
languagebash
mvn./mvnw clean install -f lib

Rest Api

language
Code Block
bash
mvn clean install -f rest


UI (admin / monitor / workspace)

Code Block
languagebash
cd web
npm installyarn


Warning

When a taskana version is changed please do not forget to build taskana-parent, taskana-rest-parent and taskana-lib-parent
Options:
A) full build

B) See codeblock below


Code Block
mvn clean./mvnw install -N && mvn clean install -N -f lib && mvn clean install -N -f rest
or
mvnpl :taskana-parent,:taskana-common-parent,:taskana-rest-parent,:taskana-history-parent
or
./mvnw install -pl :<module name> -am

...

Start the application(s)

Info

Requirements:  java maven, node

Rest Api

First of all change devMode property to true in taskanaand enableCsrf property to false in taskana-rest-spring-example-boot application.properties file, then follow the next steps.

Code Block
languagebash
cd rest\./mvnw spring-boot:run -pl :taskana-rest-spring-example-boot mvn spring-boot:run

Admin, Monitor and Workplace UI

Info

Make sure to run the following command in /web/ before starting the application:

Code Block
yarn install



Code Block
languagebash
cd web
ngyarn servestart

Then you can open a browser pointing to http://localhost:4200/ url to access to web application.

...