@localstack/lstk_darwin_amd64 0.17.0 → 0.18.0
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 +14 -1
- package/lstk +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -56,6 +56,7 @@ Running `lstk` will automatically handle configuration setup and start LocalStac
|
|
|
56
56
|
- **Extensions** — Git-style `lstk-<name>` executables extend the CLI with new commands
|
|
57
57
|
- **Self-update** — check for and install the latest `lstk` release with `lstk update`
|
|
58
58
|
- **Shell completions** — bash, zsh, and fish completions included
|
|
59
|
+
- **Structured JSON output** — pass `--json` to a supported command (`stop`, `reset`, `update` today, more planned) for a machine-readable envelope instead of formatted text; see [docs/structured-output.md](docs/structured-output.md)
|
|
59
60
|
|
|
60
61
|
## Authentication
|
|
61
62
|
|
|
@@ -96,6 +97,14 @@ type = "azure" # or "snowflake"
|
|
|
96
97
|
port = "4566"
|
|
97
98
|
```
|
|
98
99
|
|
|
100
|
+
For CI or other non-interactive use, pass `--type` (shorthand `-t`) to select the emulator without editing config. It records the selection in your config file — creating it on first run, or switching the `type` in place when it differs — so later commands (`stop`, `status`, `logs`, `volume`, …) resolve the same emulator:
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
LOCALSTACK_AUTH_TOKEN=<token> lstk start --type azure --non-interactive
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
Switching an existing config keeps the other block fields; a custom `image` blocks the switch (it pins a specific product — use a separate `--config` file instead).
|
|
107
|
+
|
|
99
108
|
The chosen emulator must be running before you set up or use its CLI integration below.
|
|
100
109
|
|
|
101
110
|
> [!NOTE]
|
|
@@ -223,7 +232,7 @@ volumes = ["/data:/var/lib/localstack"]
|
|
|
223
232
|
`lstk start` degrades gracefully when the common enterprise blockers (Docker Hub unreachable, a forward proxy, TLS interception, or an unreachable license server) make a network request fail:
|
|
224
233
|
|
|
225
234
|
- If the image cannot be pulled but is already present locally, `lstk` warns and starts the local image instead of failing.
|
|
226
|
-
- If the license server cannot be reached, `lstk` skips its pre-flight check and lets the emulator validate the license at startup. A definitive rejection from the server (e.g. an invalid token) stays fatal.
|
|
235
|
+
- If the license server cannot be reached, or it rejects the configured image tag as unrecognized (e.g. a `dev` nightly or a custom enterprise-mirror tag), `lstk` skips its pre-flight check and lets the emulator validate the license at startup. A definitive rejection from the server (e.g. an invalid token) stays fatal.
|
|
227
236
|
|
|
228
237
|
Pair this with a custom `image` in the config to point at a locally loaded image or an internal-registry mirror.
|
|
229
238
|
|
|
@@ -245,6 +254,7 @@ lstk --non-interactive
|
|
|
245
254
|
|---|---|
|
|
246
255
|
| `LOCALSTACK_AUTH_TOKEN` | Auth token used for non-interactive runs or to skip browser login |
|
|
247
256
|
| `LOCALSTACK_DISABLE_EVENTS=1` | Disables telemetry event reporting |
|
|
257
|
+
| `LSTK_STARTUP_TIMEOUT` | How long `lstk start` waits for the emulator to become healthy before acting (Go duration, e.g. `90s`, `5m`). Defaults: 20s interactively (shows a keep-waiting/stop prompt; "keep waiting" re-arms the deadline), 60s non-interactively (fails with the last container logs, leaving the emulator running for inspection). |
|
|
248
258
|
| `LSTK_OTEL=1` | Enables OpenTelemetry trace export (disabled by default). When enabled, standard `OTEL_EXPORTER_OTLP_*` env vars are respected by the SDK (e.g. `OTEL_EXPORTER_OTLP_ENDPOINT` defaults to `http://localhost:4318`). Requires an OTLP-compatible backend to receive and visualize telemetry — for local development, `make otel` starts one (UI at http://localhost:16686). |
|
|
249
259
|
| `DOCKER_HOST` | Override the Docker daemon socket (e.g. `unix:///home/user/.colima/default/docker.sock`). When unset, lstk tries the default socket and then probes common alternatives (Colima, OrbStack). |
|
|
250
260
|
|
|
@@ -318,6 +328,9 @@ lstk
|
|
|
318
328
|
# Start non-interactively (e.g. in CI)
|
|
319
329
|
LOCALSTACK_AUTH_TOKEN=<token> lstk --non-interactive
|
|
320
330
|
|
|
331
|
+
# Select the emulator non-interactively (records it in config)
|
|
332
|
+
LOCALSTACK_AUTH_TOKEN=<token> lstk start --type snowflake --non-interactive
|
|
333
|
+
|
|
321
334
|
# Stop the running emulator
|
|
322
335
|
lstk stop
|
|
323
336
|
|
package/lstk
CHANGED
|
Binary file
|