Skip to content

AKMON v0.6.0

Latest

Choose a tag to compare

@github-actions github-actions released this 08 Nov 17:05

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.0 and uv tool install akmon==0.6.0 work. 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 as okg; it did
    not, and no okg release will.
  • Python package: the wheel akmon-0.6.0-py3-none-any.whl is attached to
    this release. Install it with uv tool install or pip 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.whl and their metadata says Name: akmon.
    okg --version and okg.__version__ read their version from that package.
    Messages that suggest an extra or an added package now name akmon.
  • Release tooling reads each release's own package name. Older releases
    named okg still check, and installed upgrades pick the right wheel name for
    the version they fetch. The PyPI workflow uploads only a wheel whose metadata
    names akmon, 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/view stays. Old view
    records stay in the graph.

Breaking changes

  • The distribution is renamed from okg to akmon. A dependency on okg
    must become a dependency on akmon. Pin akmon>=0.6.0. The command okg and
    the import okg do not change, so scripts and code that use them need no edit.
  • Remove okg before installing akmon. Both packages install the same
    okg command and the same okg Python package, and removing okg later
    would delete files akmon needs.
  • 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-diagnostics is removed. A request for console
    metrics that names only retired view: keys now gets an empty answer that
    says so.

Upgrading from 0.5.0

  1. Remove the old package: uv tool uninstall okg or pip uninstall okg.
  2. Install the new one: uv tool install akmon or pip install akmon.
  3. Run okg --version. It prints okg 0.6.0.
  4. There is no new migration file and no setting changes. Run
    okg up <deployment> --plan and okg 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.