docker-windows-watch/README.md

# docker-windows-watch

Another shim to allow Linux containers running on Docker for Windows to watch for file changes in bind mounts. This requires Node.js 8+, but has no other dependencies.

## Usage

`node.exe docker-windows-watch.js`

Watches the bind mounts of all running containers, and monitors the starting and stopping of containers, and starts and stops watching as appropriate.

`node.exe docker-windows-watch.js container_name container_name...`

If you specify one or more container names, only bind mounts on these containers will be watched. The starting and stopping of containers is still monitored.

## Limitations

Probably many. This is a very new tool. No error handling. No sanity checking of watch events. Some of this might be on the horizon.

## Under the hood

This tool directly queries the Docker Engine API to look up containers, monitor starting/stopping containers, and send commands to them. It finds all of the bind mounts for the appropriate container(s), and determines the real Windows path and the Linux container's path for each one. It uses `fs.watch` to watch the directory from within Windows, and for each change it sends a `chmod + /mounted/path/of/modified.file` to the container.

## License

[The Unlicense](LICENSE).
update readme 2018-07-06 20:06:35 +00:00			`# docker-windows-watch`

update readme 2018-07-11 13:36:06 +00:00			`Another shim to allow Linux containers running on Docker for Windows to watch for file changes in bind mounts. This requires Node.js 8+, but has no other dependencies.`
update readme 2018-07-06 20:06:35 +00:00
			`## Usage`

update readme 2018-07-07 03:02:05 +00:00			`node.exe docker-windows-watch.js`
update readme 2018-07-06 20:06:35 +00:00
update readme 2018-07-07 02:03:10 +00:00			`Watches the bind mounts of all running containers, and monitors the starting and stopping of containers, and starts and stops watching as appropriate.`

update readme 2018-07-07 03:02:05 +00:00			`node.exe docker-windows-watch.js container_name container_name...`
update readme 2018-07-07 02:03:10 +00:00
need names, not ids 2018-07-11 13:57:05 +00:00			`If you specify one or more container names, only bind mounts on these containers will be watched. The starting and stopping of containers is still monitored.`
update readme 2018-07-06 20:06:35 +00:00
			`## Limitations`

update readme 2018-07-07 03:18:03 +00:00			`Probably many. This is a very new tool. No error handling. No sanity checking of watch events. Some of this might be on the horizon.`
update readme 2018-07-06 20:06:35 +00:00
			`## Under the hood`

update readme 2018-07-11 13:36:06 +00:00			This tool directly queries the Docker Engine API to look up containers, monitor starting/stopping containers, and send commands to them. It finds all of the bind mounts for the appropriate container(s), and determines the real Windows path and the Linux container's path for each one. It uses `fs.watch` to watch the directory from within Windows, and for each change it sends a `chmod + /mounted/path/of/modified.file` to the container.
update readme 2018-07-06 20:06:35 +00:00
			`## License`

update readme 2018-07-11 13:36:06 +00:00			`[The Unlicense](LICENSE).`