Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions docs/release-notes/2.9.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
Durable Workflow CLI 2.9.0

## Start a local Server with only `dw` installed

2.9.0 adds `dw server:start-dev` (cli#161, cli#160). The native Server and a bundled
SQLite database are compiled into `dw`, so you need nothing else to start a local
runtime: no PHP, Docker, Redis, separate Server installation or runtime download.

```bash
dw server:start-dev
# in another terminal
dw env:set local --server=http://127.0.0.1:8080 --token=dev-token --make-default
dw doctor
```

- **It works from an empty directory.** The command creates the schema and the
default namespace, then runs its own timers and maintenance. Your application
workers still run workflow and activity code through an SDK.
- **It is local by design.** It binds only to loopback (`127.0.0.1` by default;
`--host=localhost` and `--host=::1` also work) and refuses any other address.
`--port=0` picks a free port and prints the URL it chose.
- **Authentication is on.** The default development bearer token is
`dev-token`. `--token` sets a custom token, which is never printed.
- **Data persists.** It is stored in `dev-server` beside the CLI config file;
`--data-dir` picks another directory. Only one development Server can use a
directory at a time. The command refuses shared, linked or replaced data
directories and files. It never takes over or upgrades an unrelated PHP
Server database.
- **Ctrl+C stops it cleanly** and keeps its data.

The embedded engine is the native Server from accepted source `3d90086f`. That
is Server main after 3.11.0, including portable storage admission for library
builds. It is meant for development, not production; run a released Server
image for anything shared.

## Friendlier first use

- `dw workflow:start --help` now opens with a quick start
(`dw workflow:start --type=orders.Checkout`, plus `--wait` and `--output=json`).
It lists the essential options before the advanced ones (cli#162, cli#159).
- A mistyped command suggests the nearest command in the namespace you typed
first. For example, `dw workflow:lst` now leads with `workflow:list` instead of
unrelated commands that happen to sort earlier. Suggestions never run a
command for you.

## Other changes

- The CLI now uses the published Rust SDK **4.18.0** (was 4.12.0), built without
its `msrv-1-86` default feature so it can share the native Server's Avro
dependency. Command behavior is unchanged apart from `server:start-dev`.
- Building from source needs Rust 1.99.
- CI pins the repaired central PHP bootstrap (durable-workflow/.github#400). This
doesn't change release artifacts.
2 changes: 1 addition & 1 deletion rust/Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion rust/Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "dw"
version = "2.8.0"
version = "2.9.0"
edition = "2021"
rust-version = "1.99"
description = "Command-line interface for Durable Workflow Server and Cloud"
Expand Down
Loading