1
Fork 0
This repository has been archived on 2021-06-29. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
docker-windows-watch/README.md

28 lines
1.3 KiB
Markdown
Raw Normal View History

2018-07-06 16:06:35 -04:00
# docker-windows-watch
Another shim to allow Linux containers running on Docker for Windows to watch for file changes in bind mounts. This shim requires a recent version of Node.js, but has no other dependencies.
## Usage
2018-07-06 23:02:05 -04:00
`node.exe docker-windows-watch.js`
2018-07-06 16:06:35 -04:00
2018-07-06 22:03:10 -04:00
Watches the bind mounts of all running containers, and monitors the starting and stopping of containers, and starts and stops watching as appropriate.
2018-07-06 23:02:05 -04:00
`node.exe docker-windows-watch.js container_name container_name...`
2018-07-06 22:03:10 -04:00
If you specify one or more container names or ids, all bind mounts on these containers will be watched. The starting and stopping of containers will not be monitored.
2018-07-06 16:06:35 -04:00
## Limitations
Many. This is a very new tool.
2018-07-06 22:03:10 -04:00
No error handling. Probably reacts poorly to mounted files (as opposed to directories). No sanity checking of watch events. Some of this might be on the horizon.
2018-07-06 16:06:35 -04:00
## Under the hood
2018-07-06 22:03:10 -04:00
This tool directly queries the Docker Engine API to look up containers, find running containers, monitor starting/stopping containers, and send commands to containers. It finds all of the bind mounts for the appropriate container(s), and determines the real Windows path and the Linux container's path to each one. It uses `fs.watch` to watch the directory from within Windows. For each change, it sends `chmod + /mounted/path/of/modified.file` to the container.
2018-07-06 16:06:35 -04:00
## License
The Unlicense.