@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.
Files changed (3) hide show
  1. package/README.md +14 -1
  2. package/lstk +0 -0
  3. 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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@localstack/lstk_darwin_amd64",
3
- "version": "0.17.0",
3
+ "version": "0.18.0",
4
4
  "bin": {
5
5
  "lstk_darwin_amd64": "lstk"
6
6
  },