Make the IPAM CLI plugin installable via datumctl

.github/workflows/release.yml

@@ -43,3 +43,36 @@ jobs:
       image-overlays: config/base
       image-name: ghcr.io/milo-os/ipam
     secrets: inherit
+
+  # Build and publish the milo-ipam datumctl plugin as per-platform archives +
+  # checksums.txt, attached as GitHub release assets. Only runs on version tags
+  # (vX.Y.Z); independent of the container/kustomize jobs above. The produced
+  # asset names are consumed by the datumctl plugin catalog entry in
+  # milo-os/cli-plugins (plugins/ipam.yaml).
+  publish-plugin:
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Install Syft CLI
+        run: curl -sSfL https://raw.githubusercontent.com/anchore/syft/main/install.sh | sudo sh -s -- -b /usr/local/bin
+
+      - name: Set up Go
+        uses: actions/setup-go@v6
+        with:
+          go-version-file: go.mod
+
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          distribution: goreleaser
+          version: "~> v2"
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,6 +1,9 @@
 # Compiled binary
 /ipam
 
+# GoReleaser build output
+/dist/
+
 # Local test infrastructure (kind cluster, kind managed by task test-infra:cluster-up)
 /.test-infra/
 

.goreleaser.yaml

@@ -0,0 +1,66 @@
+# GoReleaser config for the milo-ipam datumctl plugin.
+#
+# Release a version by pushing a semver tag (vX.Y.Z). The Release workflow runs
+# goreleaser, which builds the plugin for each supported platform and publishes
+# per-platform archives + checksums.txt as GitHub release assets. The datumctl
+# plugin catalog entry (milo-os/cli-plugins, plugins/ipam.yaml) references these
+# exact asset names, so the archive name_template below must not change casually.
+#
+# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
+version: 2
+
+project_name: milo-ipam
+
+before:
+  hooks:
+    - go mod tidy
+
+builds:
+  - id: milo-ipam
+    main: ./cmd/milo-ipam
+    binary: milo-ipam
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - darwin
+      - windows
+    goarch:
+      - amd64
+      - arm64
+    # Inject the release version (the git tag without its leading "v") so the
+    # published binary's --plugin-manifest and `milo-ipam --version` report the
+    # version it was released under, rather than the in-source default.
+    ldflags:
+      - -s -w
+      - -X main.pluginVersion={{ .Version }}
+
+archives:
+  - id: milo-ipam
+    # name template renders OS title-cased (Linux/Darwin/Windows) and amd64 as
+    # x86_64, matching goreleaser's common convention and the datumctl plugin
+    # catalog entry (milo-ipam_Darwin_arm64, milo-ipam_Linux_x86_64, ...).
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- title .Os }}_
+      {{- if eq .Arch "amd64" }}x86_64
+      {{- else if eq .Arch "386" }}i386
+      {{- else }}{{ .Arch }}{{ end }}
+    formats: [tar.gz]
+    format_overrides:
+      - goos: windows
+        formats: [zip]
+
+checksum:
+  name_template: checksums.txt
+
+sboms:
+  - artifacts: archive
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^test:"
+      - "^chore:"

cmd/milo-ipam/manifest.go

@@ -12,8 +12,7 @@ import (
 
 const (
 	pluginName        = "ipam"
-	pluginVersion     = "0.1.0"
-	pluginDescription = "Manage IP address space (pools and prefixes) on Datum"
+	pluginDescription = "Manage IP address space (pools and prefixes) across the platform"
 	// pluginAPIVersion is the version of the datumctl <-> plugin contract this
 	// binary speaks, not the IPAM API version.
 	pluginAPIVersion = 1
@@ -24,6 +23,13 @@ const (
 	minAPIVersion = "ipam.miloapis.com/v1alpha1"
 )
 
+// pluginVersion is the plugin's release version. It defaults to "0.0.0" to mark
+// an unreleased local build and is overridden at release time by goreleaser via
+// -ldflags "-X main.pluginVersion=<version>" (the git tag without its leading
+// "v"), so a published binary reports the version it was released under. It is
+// a var (not a const) precisely so the linker can set it.
+var pluginVersion = "0.0.0"
+
 // pluginManifest is the document emitted in response to --plugin-manifest.
 type pluginManifest struct {
 	Name               string `json:"name"`