Adding FE dev instructions

[tinok]

This adds short instructions on using npm run watch to rebuild static files during FE development in kpi.

[noliveleger]

I would add two other lines:

$kobo-install> python run.py --build-kpi
$kobo-install> python run.py -cf restart kpi

Be aware that `kpi` takes few minutes to restart and to be up&running

[jnm]

@noliveleger, restarting isn't sufficient to use a newly-built image.

host:~/Documents/kobo/dockdev/kobo-install$ docker ps | sed -n '1p;/kpi/p'
CONTAINER ID        IMAGE                                                                  COMMAND                  CREATED             STATUS              PORTS                              NAMES
f79d983dccab        50948607b605                                                           "/bin/bash -c 'exec …"   30 minutes ago      Up About a minute   8000/tcp                           kobo-docker_kpi_1
host:~/Documents/kobo/dockdev/kobo-install$ python run.py -cf restart kpi
Restarting kobo-docker_kpi_1 ... done
host:~/Documents/kobo/dockdev/kobo-install$ docker ps | sed -n '1p;/kpi/p'
CONTAINER ID        IMAGE                                                                  COMMAND                  CREATED             STATUS              PORTS                              NAMES
f79d983dccab        50948607b605                                                           "/bin/bash -c 'exec …"   30 minutes ago      Up 2 seconds        8000/tcp                           kobo-docker_kpi_1

Instead, I'd suggest ./run.py -cf up -d kpi, which should notice that the container is using an out-of-date image and recreate the container:

host:~/Documents/kobo/dockdev/kobo-install$ ./run.py -cf up -d kpi
WARNING: Found orphan containers (kobo-docker_redis_cache_1, kobo-docker_postgres_1, kobo-docker_mongo_1, kobo-docker_redis_main_1) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up.
Recreating kobo-docker_kpi_1 ... done
host:~/Documents/kobo/dockdev/kobo-install$ docker ps | sed -n '1p;/kpi/p'
CONTAINER ID        IMAGE                                                                  COMMAND                  CREATED             STATUS              PORTS                              NAMES
65dbfcc2891f        kpi:dev.1573945934                                                     "/bin/bash -c 'exec …"   5 seconds ago       Up 4 seconds        8000/tcp                           kobo-docker_kpi_1

[Abdulfetakeyradin]

Thanks

[noliveleger]

Thanks to @jnm work, this could be simplified to:
$kobo-install> ./run.py -cf run -p 3000:3000 --rm kpi npm run watch

To use this new option, two-databases is merged.

[jnm]

probably need some docs related to https://www.flowdock.com/app/kobotoolbox/kobo/threads/oHknJLFhaDrfnSUtNXY2QNoxhCK (maybe applies only to old installs?)

[jnm]

Let's also add a message to the run.py output and possibly a new --npm-run-watch flag that does the equivalent of ./run.py -cf run -p 3000:3000 --rm kpi npm run watch

https://www.flowdock.com/app/kobotoolbox/support/threads/L98VRtgJ23hevNvov8mBrBqtWJk

[ahmadshahkhadem123]

how see kobotoolbox URL and used URL in Mobile kobo app