@solcreek/dew 0.7.50 → 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 +38 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -89,6 +89,38 @@ 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
|
+
|
|
97
|
+
To reach a service running on the **macOS host** (e.g. a websocket gateway
|
|
98
|
+
in the VM calling back to a host RPC), use the hostname `host.internal`
|
|
99
|
+
(alias `host.dew.internal`) — dew's equivalent of `host.docker.internal`.
|
|
100
|
+
It resolves to the VM's NAT gateway in both the guest and its containers,
|
|
101
|
+
so you never hardcode the `192.168.64.x` gateway IP. The host service must
|
|
102
|
+
bind `0.0.0.0` (not `127.0.0.1`) to be reachable from the VM.
|
|
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
|
+
|
|
92
124
|
### Share instantly
|
|
93
125
|
|
|
94
126
|
Temporary public HTTPS URL for any local port. Zero config, zero account.
|
|
@@ -205,7 +237,9 @@ performance prefer a native `linux/arm64` image.
|
|
|
205
237
|
```
|
|
206
238
|
Dev:
|
|
207
239
|
dew up [dir] Start dev environment
|
|
208
|
-
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
|
|
209
243
|
dew down Stop dev environment
|
|
210
244
|
|
|
211
245
|
Share:
|
|
@@ -225,7 +259,9 @@ Infrastructure:
|
|
|
225
259
|
|
|
226
260
|
Advanced:
|
|
227
261
|
dew run [--] <cmd> Execute in ephemeral VM
|
|
228
|
-
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
|
|
229
265
|
dew assets ... Manage VM images
|
|
230
266
|
dew update Update to latest version
|
|
231
267
|
|