From 5df643711a74a7d1499538514bc053a98da1889f Mon Sep 17 00:00:00 2001 From: Michael Costello Date: Wed, 18 Nov 2026 16:03:06 -0500 Subject: [PATCH] feat: Point the Milo plugin entries at the Milo catalog assistant, billing, ipam, search, and telemetry also live in milo-os/cli-plugins, which is where they are maintained from now on. Removing them here outright would break upgrade for everyone who installed them from this catalog. Each entry now carries a deprecated block naming milo-os/cli-plugins as the replacement catalog. datumctl v0.25.0 and later shows a warning with the commands to add that catalog and install from it, skips these plugins in install --all-available for users who don't have them, and lets a bare-name install prefer the replacement once the Milo catalog is added. Older datumctl releases ignore the field and keep installing and upgrading from here. The release automation only rewrites version, download URLs, and checksums, so the block survives future updates. The README marks the five plugins deprecated and shows how to switch. index.yaml regenerates from these manifests after merge. Resolves: #266 Co-Authored-By: Claude Opus 5.5 --- README.md | 19 ++++++++++++++----- plugins/assistant.yaml | 4 ++++ plugins/billing.yaml | 4 ++++ plugins/ipam.yaml | 4 ++++ plugins/search.yaml | 4 ++++ plugins/telemetry.yaml | 4 ++++ 6 files changed, 34 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index d66202a..15774d1 100644 --- a/README.md +++ b/README.md @@ -7,14 +7,14 @@ The official plugin catalog for [datumctl](https://github.com/datum-cloud/datumc | Name | Description | |------|-------------| | [alb](plugins/alb.yaml) | Create and manage Application Load Balancers on Datum Cloud | -| [assistant](plugins/assistant.yaml) | Chat with Patch, the Datum Cloud assistant, and browse your conversation history | -| [billing](plugins/billing.yaml) | View metered usage and spend for your organization or project | +| [assistant](plugins/assistant.yaml) | **Deprecated:** moved to the [Milo catalog](https://github.com/milo-os/cli-plugins). Chat with Patch, the Datum Cloud assistant, and browse your conversation history | +| [billing](plugins/billing.yaml) | **Deprecated:** moved to the [Milo catalog](https://github.com/milo-os/cli-plugins). View metered usage and spend for your organization or project | | [compute](plugins/compute.yaml) | Deploy and manage containerized workloads on Datum Cloud | | [dns](plugins/dns.yaml) | Manage DNS zones and records on Datum Cloud | -| [ipam](plugins/ipam.yaml) | Manage IP address space (pools and prefixes) across the platform | +| [ipam](plugins/ipam.yaml) | **Deprecated:** moved to the [Milo catalog](https://github.com/milo-os/cli-plugins). Manage IP address space (pools and prefixes) across the platform | | [network](plugins/network.yaml) | Create and manage networks and network services on Datum Cloud | -| [search](plugins/search.yaml) | Search for resources across the platform by kind, name, and project scope | -| [telemetry](plugins/telemetry.yaml) | Query logs for your Datum Cloud projects | +| [search](plugins/search.yaml) | **Deprecated:** moved to the [Milo catalog](https://github.com/milo-os/cli-plugins). Search for resources across the platform by kind, name, and project scope | +| [telemetry](plugins/telemetry.yaml) | **Deprecated:** moved to the [Milo catalog](https://github.com/milo-os/cli-plugins). Query logs for your Datum Cloud projects | ## Using this catalog @@ -35,6 +35,15 @@ datumctl compute --help Plugins for the Milo platform live in the [Milo catalog](https://github.com/milo-os/cli-plugins), which you add with `datumctl plugin index add milo-os milo-os/cli-plugins`. +The assistant, billing, ipam, search, and telemetry plugins have moved there, and their entries here are deprecated. They keep installing from this catalog until they are removed. datumctl v0.25.0 and later warns when you install, upgrade, or list them and shows the commands to switch: + +```sh +datumctl plugin index add milo-os milo-os/cli-plugins +datumctl plugin install milo-os/ipam +``` + +After you switch, `datumctl plugin upgrade` updates the plugin from the Milo catalog. + ## Submitting a plugin 1. Add the `datumctl-plugin` topic to your plugin's GitHub repository. diff --git a/plugins/assistant.yaml b/plugins/assistant.yaml index 5cd0354..7af8ed5 100644 --- a/plugins/assistant.yaml +++ b/plugins/assistant.yaml @@ -5,6 +5,10 @@ metadata: spec: shortDescription: Chat with Patch, the Datum Cloud assistant, and browse your conversation history homepage: https://github.com/milo-os/assistant + deprecated: + message: assistant moved to the Milo plugin catalog. + replacement: + catalog: milo-os/cli-plugins version: v0.0.14 platforms: - selector: diff --git a/plugins/billing.yaml b/plugins/billing.yaml index 91515b3..29daabd 100644 --- a/plugins/billing.yaml +++ b/plugins/billing.yaml @@ -5,6 +5,10 @@ metadata: spec: shortDescription: View metered usage and spend for your organization or project homepage: https://github.com/milo-os/billing + deprecated: + message: billing moved to the Milo plugin catalog. + replacement: + catalog: milo-os/cli-plugins version: v0.9.0 platforms: - selector: diff --git a/plugins/ipam.yaml b/plugins/ipam.yaml index d937fa0..5133f53 100644 --- a/plugins/ipam.yaml +++ b/plugins/ipam.yaml @@ -5,6 +5,10 @@ metadata: spec: shortDescription: Manage IP address space (pools and prefixes) across the platform homepage: https://github.com/milo-os/ipam + deprecated: + message: ipam moved to the Milo plugin catalog. + replacement: + catalog: milo-os/cli-plugins version: v0.5.6 platforms: - selector: diff --git a/plugins/search.yaml b/plugins/search.yaml index c5655fd..3b2e731 100644 --- a/plugins/search.yaml +++ b/plugins/search.yaml @@ -5,6 +5,10 @@ metadata: spec: shortDescription: Search for resources across the platform by kind, name, and project scope homepage: https://github.com/milo-os/search + deprecated: + message: search moved to the Milo plugin catalog. + replacement: + catalog: milo-os/cli-plugins version: v0.8.12 platforms: - selector: diff --git a/plugins/telemetry.yaml b/plugins/telemetry.yaml index a3cf3ec..fb86c30 100644 --- a/plugins/telemetry.yaml +++ b/plugins/telemetry.yaml @@ -5,6 +5,10 @@ metadata: spec: shortDescription: Query logs for your Datum Cloud projects homepage: https://github.com/milo-os/telemetry + deprecated: + message: telemetry moved to the Milo plugin catalog. + replacement: + catalog: milo-os/cli-plugins version: v0.6.10 platforms: - selector: