feat: scaffold GARM 12-factor charm with ROCK image (ISD-5718)

.github/workflows/charms_lint_and_unit.yaml

@@ -35,6 +35,7 @@ jobs:
         charm:
           - charms/planner-operator
           - charms/webhook-gateway-operator
+          - charms/garm
     steps:
       - uses: actions/checkout@v6
 

.github/workflows/publish_charms.yml

@@ -19,6 +19,7 @@ jobs:
         charm:
           - planner
           - webhook-gateway
+          # - garm  # not yet functional; uncomment when ready to publish
     name: ${{ github.event_name == 'push' && '' || 'Test ' }}Publish Charm (${{ matrix.charm }})
     runs-on: ubuntu-latest
     steps:

build-garm-rock.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+#
+# Copyright 2026 Canonical Ltd.
+# See LICENSE file for licensing details.
+#
+
+export ROCKCRAFT_ENABLE_EXPERIMENTAL_EXTENSIONS=true
+
+ln -s ./garm-rockcraft.yaml ./rockcraft.yaml
+rockcraft clean
+rockcraft pack
+rm ./rockcraft.yaml

charms/garm/.gitignore

@@ -0,0 +1,9 @@
+venv/
+build/
+*.charm
+.tox/
+.coverage
+__pycache__/
+*.py[cod]
+.idea
+.vscode/

charms/garm/charmcraft.yaml

@@ -0,0 +1,35 @@
+# Copyright 2026 Canonical Ltd.
+# See LICENSE file for licensing details.
+
+name: garm
+
+type: charm
+
+base: ubuntu@24.04
+
+platforms:
+  amd64:
+
+summary: GARM — GitHub Actions Runner Manager charm.
+
+description: |
+  Deploys and manages GARM (GitHub Actions Runner Manager) using the
+  12-factor app framework with SQLite storage and an OpenStack runner provider.
+
+extensions:
+  - go-framework
+
+config:
+  options:
+    garm-listen-address:
+      type: string
+      default: "0.0.0.0"
+      description: Address GARM API server listens on.
+    garm-listen-port:
+      type: int
+      default: 9997
+      description: Port GARM API server listens on.
+    garm-db-path:
+      type: string
+      default: "/etc/garm/garm.db"
+      description: Path to the SQLite database file.