summaryrefslogtreecommitdiffhomepage
path: root/tools/unitctl/README.md
diff options
context:
space:
mode:
authorAva Hahn <a.hahn@f5.com>2024-07-31 13:39:37 -0700
committerAva Hahn <110854134+avahahn@users.noreply.github.com>2024-08-01 10:51:43 -0700
commita91b961d620dc17c98b998a9142050defe46b56e (patch)
tree9a186ab53e8cb49ae9f4387066a2834e3cd1ec51 /tools/unitctl/README.md
parent43faf99d0347c13ddffecb4aaaf76d5771116d53 (diff)
downloadunit-a91b961d620dc17c98b998a9142050defe46b56e.tar.gz
unit-a91b961d620dc17c98b998a9142050defe46b56e.tar.bz2
tools/unitctl: make application directory configurable
* default behavior is now a read write application mount * use can specify a flag (-r) to mount app dir as read only Signed-off-by: Ava Hahn <a.hahn@f5.com>
Diffstat (limited to 'tools/unitctl/README.md')
-rw-r--r--tools/unitctl/README.md11
1 files changed, 8 insertions, 3 deletions
diff --git a/tools/unitctl/README.md b/tools/unitctl/README.md
index e6fca477..9f7e010b 100644
--- a/tools/unitctl/README.md
+++ b/tools/unitctl/README.md
@@ -112,7 +112,7 @@ The new containers will then be shown in a call to
$ unitctl instances new /tmp/2 $(pwd) 'unit:wasm'
Pulling and starting a container from unit:wasm
Will mount /tmp/2 to /var/run for socket access
-Will READ ONLY mount /home/ava/repositories/nginx/unit/tools/unitctl to /www for application access
+Will mount /home/user/repositories/nginx/unit/tools/unitctl to /www for application access
Note: Container will be on host network
```
@@ -131,12 +131,17 @@ To the subcommand `unitctl instances new` the user must provide three arguments:
For example: `127.0.0.1:7171`.
2. **A path to an application:**
In the example, `$(pwd)` is provided. The Unit container will mount
- this READ ONLY to `/www/`. This will allow the user to configure
- their Unit container to expose an application stored on the host.
+ this to `/www/`. This will allow the user to configure their
+ Unit container to expose an application stored on the host.
3. **An image tag:**
In the example, `unit:wasm` is used. This will be the image that unitctl
will deploy. Custom repos and images can be deployed in this manner.
+In addition to the above arguments, the user may add the `-r` flag. This flag will
+set the Docker volume mount for the application directory to be read only. Do note
+that this flag will break compatibility with WordPress, and other applications
+which store state on the file system.
+
After deployment the user will have one Unit container running on the host network.
### Lists active applications and provides means to restart them