项目作者: covid-taskforce-cplp

项目描述 :
[draft] Unofficial dockerized version of HXLdash ("Create data visualisations quickly by leveraging the HXL - Humanitarian eXchange Language") for local development. The hosted version (maintained by British Red Cross) is at https://hxldash.com/
高级语言: Python
项目地址: git://github.com/covid-taskforce-cplp/hxldash-docker.git
创建时间: 2020-04-03T21:10:11Z
项目社区:https://github.com/covid-taskforce-cplp/hxldash-docker

开源协议:The Unlicense

下载


hxldash-docker

[draft] Unofficial dockerized version of HXLdash (“Create data visualisations
quickly by leveraging the HXL - Humanitarian eXchange Language”
) for local
development. The hosted version (maintained by British Red Cross) is at
https://hxldash.com

The source code of hxldash is at https://github.com/SimonbJohnson/quickX3.

Usage

TODO: remove non-relevant parts copied from https://github.com/fititnt/uwazi-docker

The hxldash-docker requires docker-compose installed. See
requirements(To Do). If you are a developer, can also check some
advanced information on development-instructions.md(To Do) and a
draft of production-instructions.md(To Do; Not planned).

Install

Run these commands on your terminal only the first time:

  1. git clone https://github.com/covid-taskforce-cplp/hxldash-docker.git
  2. cd hxldash-docker
  3. # Install/Re-install from empty data
  4. docker-compose run -e IS_FIRST_RUN=true --rm hxldash-docker

Run

Without docker-compose

  1. docker build -t hxldash .
  2. docker run -it --rm --name hxldash-app hxldash -p 8000:8000

With docker-compose

  1. # Run uwazi on background (automatic restart on reboot unless stopped)
  2. docker-compose up -d hxldash

Open your browser at http://127.0.0.1:8000.

Basic docker commands

  1. # Stop all containers from this uwazi-docker and do not restart again until you explicit ask for it
  2. docker-compose stop
  3. # Using "-d" param to run uwazi and its dependencies on background
  4. docker-compose up -d hxldash
  5. # No "-d" param, start uwazi, MongoDB & Elastic Search and see what is happening inside the containers
  6. docker-compose up hxldash
  7. # See what containers are running now
  8. docker ps
  9. # See all docker volumes
  10. docker volume ls
  11. # TODO: add commands specific to hxldash-docker
  12. # # See docker volumes that stores data from uwazi-docker (hint: these ones to backup & restore)
  13. # docker volume ls | grep 'mongodb_data1\|uploaded_documents'
  14. # # Want some GUI to see what is happening on MongoDB? Use nosqlclient
  15. # docker-compose up -d mongo-gui-mongoclient
  16. # # Want some GUI to see what is happening on Elastic Search? Try Dejavu
  17. # docker-compose up -d elasticsearch-gui-dejavu

Commands for debug

  1. # To log directly on a running container, in this case the hxldash
  2. docker-compose exec hxldash bash
  3. # To watch logs of all containers managed by this docker-compose.yml
  4. docker-compose logs -f

Docker image

To use pre-build docker images

See https://hub.docker.com/r/covidtaskforcecplp/hxldash.

Upload image do Docker Hub

If you have access to the organization https://hub.docker.com/u/covidtaskforcecplp, you can build locally and publish with this command:

  1. docker build -t covidtaskforcecplp/hxldash .
  2. docker push covidtaskforcecplp/hxldash

License

Public Domain

To the extent possible under law, the authors of @covid-taskforce-cplp
waived all copyright and related or neighboring rights to this work to
Public Domain.