Repository navigation
AKMON 0.6.0 follows 0.5.0. Its main change: the installable Python package is
now named akmon, and this is its first release on PyPI, so pip install akmon
and uv tool install akmon work. The command and the Python import keep their
names, so every command below still starts with okg and code still says
import okg. It also removes 8 summary views that nobody read from the console.
There are no new features beyond the rename and no new migration files.
Get it
- PyPI (new): the package is published to PyPI as the project
akmon, so
pip install akmon==0.6.0anduv tool install akmon==0.6.0work. It is
published after the release, by a separate workflow started by hand that
uploads only the wheel the release pipeline built, using PyPI trusted
publishing (PyPI trusts that one workflow, so no upload password or token
exists anywhere). Until that workflow has run, install from the attached
wheel. The 0.5.0 notes said that release would reach PyPI asokg; it did
not, and nookgrelease will. - Python package: the wheel
akmon-0.6.0-py3-none-any.whlis attached to
this release. Install it withuv tool installorpip install, then follow
the quickstart (docs/start/quickstart.md). - Containers and Kubernetes: the Install section at the end lists the
runtime and PostgreSQL images and the Helm chart, each with its digest.
What's new
- The package is named
akmon. Wheels are now named
akmon-<version>-py3-none-any.whland their metadata saysName: akmon.
okg --versionandokg.__version__read their version from that package.
Messages that suggest an extra or an added package now nameakmon. - Release tooling reads each release's own package name. Older releases
namedokgstill check, and installed upgrades pick the right wheel name for
the version they fetch. The PyPI workflow uploads only a wheel whose metadata
namesakmon, so v0.4.0 and v0.5.0 do not go to PyPI. - The console drops 8 unread views. The workspace deployment's 8 summary
views and the two Today-page builders that read them are deleted, so Home and
Sources list 65 producers instead of 73./console/viewstays. Old view
records stay in the graph.
Breaking changes
- The distribution is renamed from
okgtoakmon. A dependency onokg
must become a dependency onakmon. Pinakmon>=0.6.0. The commandokgand
the importokgdo not change, so scripts and code that use them need no edit. - Remove
okgbefore installingakmon. Both packages install the same
okgcommand and the sameokgPython package, and removingokglater
would delete filesakmonneeds. - v0.4.0 and v0.5.0 stay on GitHub, under the name
okg. Their wheels are
attached to their releases and are not on PyPI. - The route
/console/view-diagnosticsis removed. A request for console
metrics that names only retiredview:keys now gets an empty answer that
says so.
Upgrading from 0.5.0
- Remove the old package:
uv tool uninstall okgorpip uninstall okg. - Install the new one:
uv tool install akmonorpip install akmon. - Run
okg --version. It printsokg 0.6.0. - There is no new migration file and no setting changes. Run
okg up <deployment> --planandokg up <deployment>as usual.
To go back to 0.5.0, uninstall akmon first, then install the okg wheel from
the v0.5.0 release.
Known issues
- PyPI is empty until the upload workflow runs.
pip install akmon==0.6.0
works only after the separate publishing workflow has been started for this
release. - Everything listed as a known issue in the 0.5.0 notes is unchanged,
except its PyPI entry: 0.5.0 stays on GitHub.
Install
Everything below was built from the commit this tag names. The tags v0.6.0 (images) and 0.6.0 (chart) are never moved or overwritten; pin a digest to be certain.
| Artifact | Reference | Digest |
|---|---|---|
| Runtime image | ghcr.io/mitdbg/akmon:v0.6.0 |
sha256:c4e47d5b1d34228fff0e0a69cad6de88cba151b71f056ab5e1a6466df74955d8 |
| PostgreSQL image | ghcr.io/mitdbg/akmon-postgres:v0.6.0 |
sha256:20e6a145332ccf4df6f207970ac34abec217495e796575618248db099be11d1d |
| Helm chart | oci://ghcr.io/mitdbg/charts/akmon version 0.6.0 |
sha256:d2540130128009e2c47a9e0dc007c3f22a8389045d2858c1ece5a219b4a00bbd |
helm install okg oci://ghcr.io/mitdbg/charts/akmon --version 0.6.0 -f values.yaml
The chart's appVersion is v0.6.0: with images.okg.tag and digest empty it runs ghcr.io/mitdbg/akmon:v0.6.0, and its PostgreSQL image is ghcr.io/mitdbg/akmon-postgres:v0.6.0.