02a2dd9d7a
When the directory is created during the build process, it is as root. This prevents us deleting root-owned files inside the directory during make clean. In client/build/, we get around this because the directory contains a tracked file, so it's created during git checkout. We make this the case for build-external by adding a hidden, empty file to track. This won't fix existing checkouts though, so we also add a fix-up step to make clean. The use of .gitignore as the empty file to track is taken from https://git.wiki.kernel.org/index.php/GitFaq#Can_I_add_empty_directories.3F Specifically: "If you really need a directory to exist in checkouts you should create a file in it. .gitignore works well for this purpose"
Scope UI
Getting Started (using local node)
- You need nodejs 4.2.2 and a running
weavescopecontainer - Setup:
npm install - Develop:
BACKEND_HOST=<dockerhost-ip> npm startand then openhttp://localhost:4042/
This will start a webpack-dev-server that serves the UI and proxies API requests to the container.
Getting Started (using node in a container)
- You need a running
weavescopecontainer - Develop:
make WEBPACK_SERVER_HOST=<dockerhost-ip> client-startand then openhttp://<dockerhost-ip>:4042/
This will start a webpack-dev-server that serves the UI from the UI build container and proxies API requests to the weavescope container.
Test Production Bundles Locally
- Build:
npm run build, output will be inbuild/ - Serve files from
build/:BACKEND_HOST=<dockerhost-ip> npm run start-productionand then openhttp://localhost:4042/
Coding
This directory has a .eslintrc, make sure your editor supports linter hints.
To run a linter, you also run npm run lint.
Logging
To enable logging in the console, activate it via localStorage in the dev tools console:
localStorage["debug"] = "scope:*"
The Scope UI uses debug for logging, e.g.,:
const debug = require('debug')('scope:app-store');
debug('Store log message');
Gotchas
Got a blank screen when loading http://localhost:4042?
Make sure you are accessing the right machine:
If you're running npm start on a virtual machine with IP 10.0.0.8, you need to point your browser to http://10.0.0.8:4042.
Also, you may need to manually configure the virtual machine to expose ports 4041 (webpack-dev-server) and 4042 (express proxy).