Mirrord Operator Skill

Purpose

Help users set up mirrord operator for team/enterprise use:

• Install operator via Helm
• Configure licensing and settings
• Manage multi-user access
• Troubleshoot operator issues

When to Use This Skill

Trigger on questions like:

• "How do I install mirrord operator?"
• "Set up mirrord for my team"
• "Configure mirrord licensing"
• "Operator not working"

References

Read troubleshooting guidance from this skill's references/ directory:

• references/troubleshooting.md - Common operator issues and solutions

Prerequisites

Before operator setup, verify:

# Kubernetes cluster access
kubectl cluster-info

# Helm installed
helm version

# User has cluster-admin or sufficient RBAC
kubectl auth can-i create deployments --namespace mirrord

Installation

Step 1: Add Helm repository

helm repo add metalbear https://metalbear-co.github.io/charts
helm repo update

Step 2: Install operator

Trial/evaluation (no license):

helm install mirrord-operator metalbear/mirrord-operator \
  --namespace mirrord --create-namespace

Production (with license):

helm install mirrord-operator metalbear/mirrord-operator \
  --namespace mirrord --create-namespace \
  --set license.key=<LICENSE_KEY>

Step 3: Verify installation

# Check operator pod is running
kubectl get pods -n mirrord

# Check operator logs
kubectl logs -n mirrord -l app=mirrord-operator

Configuration Options

Common Helm values

# values.yaml
license:
  key: "your-license-key"      # or use keyRef for secrets

# Namespaces where mirrord can run
roleNamespaces: []              # empty = all namespaces

operator:
  port: 443                     # can use 3000 or 8443 if 443 is restricted
  resources:
    limits:
      cpu: 200m
      memory: 200Mi             # enough for ~200 concurrent sessions

# Feature flags
sqsSplitting: false             # SQS queue splitting
kafkaSplitting: false           # Kafka queue splitting

# Agent settings
agent:
  tls: false                    # secure agent connections (requires agent 3.97.0+)

Install with custom values:

helm install mirrord-operator metalbear/mirrord-operator \
  --namespace mirrord --create-namespace \
  -f values.yaml

User Configuration

Once operator is installed, users need to enable operator mode in their mirrord config:

{
  "operator": true,
  "target": "pod/my-app"
}

Or via CLI:

mirrord exec --operator --target pod/my-app -- node app.js

Common Issues

RBAC Setup

For multi-user access, create appropriate roles:

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: mirrord-user
rules:
- apiGroups: ["mirrord.metalbear.co"]
  resources: ["targets", "sessions"]
  verbs: ["get", "list", "create", "delete"]

Upgrade Operator

helm repo update
helm upgrade mirrord-operator metalbear/mirrord-operator \
  --namespace mirrord \
  -f values.yaml

Uninstall

helm uninstall mirrord-operator --namespace mirrord
kubectl delete namespace mirrord

Response Guidelines

1. Check prerequisites first — kubectl, helm, cluster access
2. Ask about licensing — do they have a license key?
3. Verify installation — always check pods are running
4. Help with RBAC — multi-user setups need proper permissions

Learn More

• Operator Documentation
• Helm Chart
• Licensing