Effortless roadmap visualisation tool
The Ganttilla draws roadmap based on the JSON
descriptor files in the assets directory.
To make the most of it, you can automate generation of descriptor file. This project provides scripts that turns GitLab or GitHub milestones to blocks(see the diagram below), along with links and due date. Alternatively, you can write your own script to transform any data into the format Ganttilla uses.
With script ready run it from time to time (using cron for example) to regenerate data.
Effortless roadmap visualisation tool. Visit the demo page here to verify how it works.
The Ganttilla draws roadmap based on the JSON
descriptor files in the assets directory.
The fastest way to generate a descriptor is running following command:
docker run --rm -it -v ${PWD}/descriptors:/ganttilla/generated-descriptors ocadotechnology/ganttilla:latest gitlab
Available commands are github
and gitlab
. After answering a few questions you can find your descriptor under ${PWD}/descriptors
.
To generate descriptor files for GitLab project, set following environment variables:
GITLAB_URL
GITLAB_PROJECT_ID
GITLAB_TOKEN
GANTTILLA_OUTPUT_FILENAME
This will use milestones defined in the project and create blocks that represent them.
Then run the following script:
python scripts/run.py gitlab
To generate descriptor files for GitHub project, set following environment variables:
GITHUB_USERNAME
GITHUB_REPOSITORY
GITHUB_TOKEN
GANTTILLA_OUTPUT_FILENAME
Then run the following script:
python scripts/run.py github
To generate descriptor files for Jira project, set following environment variables:
JIRA_PROJECT
JIRA_URL
JIRA_USERNAME
JIRA_TOKEN
JIRA_START_DATE_FIELD
- usually a custom field
JIRA_END_DATE_FIELD
- usually a custom field
GANTTILLA_OUTPUT_FILENAME
Set optional variable JIRA_CUSTOM_JQL
if you want some customisation to your JQL query instead of just getting all issues assigned to a project.
This will use milestones defined in the project and create blocks that represent them.
The description file should contain list of objects, each one representing block of work. Take for example the src/assets/descriptors/empire.json.
Fields start_date
and end_date
should store dates in yyyy-MM-dd pattern. The swimlane
field is optional.
[
{
"title": "Destroy the Death Star",
"description": "Blow up that thing",
"start_date": "2018-12-10",
"end_date": "2019-03-09",
"link": "https://github.com/ocadotechnology/ganttilla",
"swimlane": "Freedom"
}
]
Having trouble with Ganttilla? We'd like to help!
Ganttilla uses GitHub's integrated issue tracking system to record bugs and feature requests. If you want to raise an issue, please follow the recommendations below:
You need docker
installed on your computer.
docker run -dit -p 4200:80 --name ganttilla ocadotechnology/ganttilla:latest
Go to your browser and type http://localhost:4200.
docker run -dit -p 4200:80 -v /opt/ganttilla/first-order.json:/ganttilla/descriptors/first-order.json --name ganttilla ocadotechnology/ganttilla:latest
Go to your browser and type http://localhost:4200.
You need npm
installed on your computer.
To start the project locally run:
$ npm install
$ npm start
To build the project run:
$ npm install
$ npm run-script build
You need docker
installed on your computer.
To build Docker image run:
docker build -t ocadotechnology/ganttilla:latest .
Ganttilla is Open Source software released under the Apache 2.0 license.
Copyright © 2018 Ocado