Add OLM Plugin for Day-2 Operator Management

Signed-off-by: chiragkyal <[email protected]>

Author: chiragkyal

.claude-plugin/marketplace.json

@@ -63,6 +63,11 @@
       "name": "must-gather",
       "source": "./plugins/must-gather",
       "description": "A plugin to analyze and report on must-gather data"
+    },
+    {
+      "name": "olm",
+      "source": "./plugins/olm",
+      "description": "A plugin for managing day-2 operators using Operator Lifecycle Manager"
     }
   ]
-}
+}

plugins/olm/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+    "name": "olm",
+    "description": "A plugin for managing day-2 operators using Operator Lifecycle Manager",
+    "version": "0.0.1",
+    "author": {
+        "name": "chiragkyal"
+    }
+}

plugins/olm/README.md

@@ -0,0 +1,193 @@
+# OLM Plugin
+
+A plugin for managing day-2 operators in OpenShift clusters using Operator Lifecycle Manager (OLM).
+
+## Features
+
+- Search and discover operators across all catalog sources
+- Install operators and verification
+- List installed operators with health status
+- Check detailed operator health and troubleshoot issues
+- Safely uninstall operators with optional CRD and namespace cleanup
+- Automatic channel discovery and smart defaults
+- Context-aware troubleshooting recommendations
+
+## Prerequisites
+
+- Claude Code installed
+- OpenShift CLI (`oc`) installed and configured
+- Access to an OpenShift cluster with cluster-admin or sufficient RBAC permissions
+
+
+## Commands
+
+### `/olm:search` - Search for Operators
+
+Search for available operators in OperatorHub catalogs.
+
+**Usage:**
+```bash
+/olm:search cert-manager                              # Search by keyword
+/olm:search                                           # List all operators
+/olm:search prometheus --catalog community-operators  # Search specific catalog
+/olm:search external-secrets-operator --exact         # Exact name match
+```
+
+**Arguments:**
+- `query` (optional): Search term for filtering operators
+- `--catalog <name>` (optional): Limit search to specific catalog
+- `--exact` (optional): Only show exact name matches
+
+See [commands/search.md](commands/search.md) for full documentation.
+
+---
+
+### `/olm:install` - Install Operators
+
+Install operators from OperatorHub.
+
+**Usage:**
+```bash
+/olm:install openshift-cert-manager-operator                         # Basic install
+/olm:install openshift-cert-manager-operator my-namespace            # Custom namespace
+/olm:install openshift-cert-manager-operator ns stable-v1            # Specific channel
+/olm:install prometheus community-operators stable community-operators  # Different catalog
+```
+
+**What it does:**
+- Creates namespace and OperatorGroup
+- Creates Subscription with auto-discovered or specified channel
+- Monitors installation progress and verifies CSV status
+- Reports deployment and pod status
+
+**Arguments:**
+- `operator-name` (required): Name of the operator
+- `namespace` (optional): Target namespace (defaults to operator name)
+- `channel` (optional): Subscription channel (auto-discovered if not provided)
+- `source` (optional): CatalogSource name (defaults to "redhat-operators")
+
+See [commands/install.md](commands/install.md) for full documentation.
+
+---
+
+### `/olm:list` - List Installed Operators
+
+View all operators installed in the cluster.
+
+**Usage:**
+```bash
+/olm:list                           # List all operators
+/olm:list cert-manager-operator     # List in specific namespace
+/olm:list --all-namespaces          # Explicit cluster-wide view
+```
+
+**What it does:**
+- Shows operator status, versions, and channels
+- Identifies operators requiring attention (failed, installing, etc.)
+- Provides summary statistics
+- Suggests troubleshooting commands for problematic operators
+
+**Arguments:**
+- `namespace` (optional): Target namespace
+- `--all-namespaces` or `-A` (optional): List cluster-wide
+
+See [commands/list.md](commands/list.md) for full documentation.
+
+---
+
+### `/olm:status` - Check Operator Status
+
+Get detailed health and status information for a specific operator.
+
+**Usage:**
+```bash
+/olm:status openshift-cert-manager-operator           # Auto-discover namespace
+/olm:status external-secrets-operator my-namespace    # Specific namespace
+```
+
+**What it does:**
+- Shows CSV, Subscription, and InstallPlan status
+- Lists deployments and pods with health information
+- Displays recent events and warnings
+- Provides context-aware troubleshooting recommendations
+- Checks for available updates
+
+**Arguments:**
+- `operator-name` (required): Name of the operator
+- `namespace` (optional): Namespace (auto-discovered if not provided)
+
+See [commands/status.md](commands/status.md) for full documentation.
+
+---
+
+### `/olm:uninstall` - Uninstall Operators
+
+Safely uninstall operators with optional resource cleanup.
+
+**Usage:**
+```bash
+/olm:uninstall openshift-cert-manager-operator                    # Basic uninstall
+/olm:uninstall operator-name my-namespace                          # Custom namespace
+/olm:uninstall operator-name namespace --remove-crds              # Include CRDs
+/olm:uninstall operator-name namespace --remove-crds --remove-namespace  # Full cleanup
+/olm:uninstall operator-name namespace --force                     # Skip confirmations
+```
+
+**What it does:**
+- Removes Subscription and CSV
+- Removes operator deployments
+- Optionally removes CRDs (with confirmation - **cluster-wide impact**)
+- Optionally removes namespace (with confirmation)
+- Provides detailed uninstallation summary
+
+**Arguments:**
+- `operator-name` (required): Name of the operator
+- `namespace` (optional): Target namespace (defaults to operator name)
+- `--remove-crds` (optional): Remove CRDs - **CAUTION: affects entire cluster**
+- `--remove-namespace` (optional): Remove namespace
+- `--force` (optional): Skip confirmation prompts
+
+See [commands/uninstall.md](commands/uninstall.md) for full documentation.
+
+---
+
+## Example Workflows
+
+**Discover and install:**
+```bash
+/olm:search cert-manager
+/olm:install openshift-cert-manager-operator
+/olm:status openshift-cert-manager-operator
+/olm:uninstall openshift-cert-manager-operator
+```
+
+**Monitor operators:**
+```bash
+/olm:list
+/olm:status external-secrets-operator
+```
+
+## Troubleshooting
+
+### Operator not found
+```bash
+/olm:search <operator-name>                           # Search for operator
+oc get packagemanifests -n openshift-marketplace      # List manually
+```
+
+### Installation issues
+```bash
+/olm:status <operator-name>                           # Check detailed status
+oc get csv -n <namespace>                             # Check CSV manually
+oc describe csv <csv-name> -n <namespace>             # Detailed CSV info
+```
+
+### Uninstallation issues
+```bash
+# CSV won't delete
+oc get csv <csv-name> -n <namespace> -o yaml | grep finalizers
+
+# Namespace stuck in Terminating
+oc api-resources --verbs=list --namespaced -o name | \
+  xargs -n 1 oc get --show-kind --ignore-not-found -n <namespace>
+```