@solcreek/dew 0.7.51 → 0.7.52
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +31 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -89,6 +89,11 @@ port = 8025
|
|
|
89
89
|
`dew up` then boots the project and its services in one VM; containers use
|
|
90
90
|
the VM network, so the dev server reaches them on `localhost`.
|
|
91
91
|
|
|
92
|
+
`--services-only` (alias `--no-dev`) boots just the services — handy when
|
|
93
|
+
the app itself runs on the host and only its backing services live in dew.
|
|
94
|
+
This is the docker-compose-shaped path: several arbitrary OCI images,
|
|
95
|
+
health-gated and port-forwarded, in one microVM with no container daemon.
|
|
96
|
+
|
|
92
97
|
To reach a service running on the **macOS host** (e.g. a websocket gateway
|
|
93
98
|
in the VM calling back to a host RPC), use the hostname `host.internal`
|
|
94
99
|
(alias `host.dew.internal`) — dew's equivalent of `host.docker.internal`.
|
|
@@ -96,6 +101,26 @@ It resolves to the VM's NAT gateway in both the guest and its containers,
|
|
|
96
101
|
so you never hardcode the `192.168.64.x` gateway IP. The host service must
|
|
97
102
|
bind `0.0.0.0` (not `127.0.0.1`) to be reachable from the VM.
|
|
98
103
|
|
|
104
|
+
### Run any container
|
|
105
|
+
|
|
106
|
+
Run a single OCI image in a microVM — no Docker daemon, sub-second boot,
|
|
107
|
+
automatic `--net=host` and port forwarding:
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
dew run --image redis:7-alpine -p 6379:6379
|
|
111
|
+
dew run --image axllent/mailpit -p 8025:8025 -e MP_SMTP_AUTH_ACCEPT_ANY=1
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Each `dew run` is ephemeral and isolated, so several run side by side
|
|
115
|
+
without contending for a shared disk. For a long-lived VM that persists
|
|
116
|
+
state, `--name` gives it its own disk so named instances coexist:
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
dew vm start --name ci --profile standard # a second VM alongside the default
|
|
120
|
+
dew exec --name ci -- ./run-tests.sh
|
|
121
|
+
dew vm stop --name ci
|
|
122
|
+
```
|
|
123
|
+
|
|
99
124
|
### Share instantly
|
|
100
125
|
|
|
101
126
|
Temporary public HTTPS URL for any local port. Zero config, zero account.
|
|
@@ -212,7 +237,9 @@ performance prefer a native `linux/arm64` image.
|
|
|
212
237
|
```
|
|
213
238
|
Dev:
|
|
214
239
|
dew up [dir] Start dev environment
|
|
215
|
-
dew up --with postgres,redis Dev with services
|
|
240
|
+
dew up --with postgres,redis Dev with built-in services
|
|
241
|
+
dew up --init Write a starter dew.toml
|
|
242
|
+
dew up --services-only Boot services without a dev server
|
|
216
243
|
dew down Stop dev environment
|
|
217
244
|
|
|
218
245
|
Share:
|
|
@@ -232,7 +259,9 @@ Infrastructure:
|
|
|
232
259
|
|
|
233
260
|
Advanced:
|
|
234
261
|
dew run [--] <cmd> Execute in ephemeral VM
|
|
235
|
-
dew
|
|
262
|
+
dew run --image <ref> Run an OCI image in a microVM
|
|
263
|
+
dew exec [--name <vm>] <cmd> Execute in a running VM
|
|
264
|
+
dew vm start/stop [--name] Manage long-lived (named) VMs
|
|
236
265
|
dew assets ... Manage VM images
|
|
237
266
|
dew update Update to latest version
|
|
238
267
|
|