Skip to content

v0.10.0

Choose a tag to compare

@github-actions github-actions released this 27 Oct 12:24
· 27 commits to main since this release
Immutable release. Only release title and notes can be modified.
  • Tasks: oneshot = true makes an entry a task that runs to completion, such as a migration. Servers that depends_on it start once it exits with code 0, and are crashed with a note such as dependency migrate failed: exited with code 1 when it fails. ensure, up --wait and ensure_server run the task again and wait for its end; servers started together share one run. A task has no port, shows as done after a successful run, and counts for portside check only while it runs, when it failed, or when you name it (Tasks).
  • Schedules: schedule = "30 2 * * *" starts a task or server at the times a crontab expression matches, in local time (five fields, names, ranges, lists, steps and @daily style macros). A run missed during sleep or while the daemon was down happens once afterwards, a server still running skips the run, PORTSIDE_TRIGGER is schedule, and enabled = false pauses it. portside status, the dashboard and list_servers show the next run (Schedules).
  • memory_limit (top level or per server, such as "2GB"; "0" turns an inherited one off) stops a server whose processes use more memory, checked with each usage sample (every 30 seconds, every 2 seconds while the dashboard shows usage). It counts as a crash with a note such as used 2.3 GB, over memory_limit 2 GB: the restart policy applies and on_crash gets the note. Worktree copies have their server's limit; containers are not covered (Memory limit).
  • watch = ["src/**/*.py", "pyproject.toml"] restarts a server once changes to the files it matches, relative to its dir, have stopped for about a second, and starts a crashed one again after a change, so fixing the error brings it back. The log names the change (restarting: changed src/app.py (+3 more)) and PORTSIDE_TRIGGER is watch. A server you stopped ignores changes, and a task restarts only while it runs. Files are polled every second, only in directories a pattern can match, skipping .git, node_modules and similar folders unless a pattern names them. The dashboard marks such a server watching (Restart on file changes).
  • Hook commands: PORTSIDE_TIME gives when the event happened (RFC 3339), so a monitor can order reports whose commands finished out of order.
  • Fixed: an automatic restart still waiting for its backoff when the daemon upgraded in place was lost with restore = false, or happened at once with a fresh count of restarts; it now happens at its time in the new daemon and continues the count, unless the config the new daemon loads sets restart = "no".
  • Fixed: a server that was still starting when the daemon upgraded in place no longer stays down with restore = false, nor when the upgrade fails: the start goes on.

Install

With Homebrew on macOS 26 or later (Apple Silicon), the app and the command:

brew install --cask padmk/tap/portside

On macOS or Linux (x86-64, arm64), the command and dashboard, built from source:

brew install --formula padmk/tap/portside

Portside-0.10.0.zip below is the same app, and the portside_*.tar.gz archives hold the command alone. See the README for details.