Splunk AI Operator

---

The Splunk AI Operator is a Kubernetes operator that enables customers to manage AI workloads using standardized CRDs, Helm charts, and Kubernetes primitives without reliance on any specific cloud provider’s tooling or rigid infrastructure. This repo includes the Splunk AI Operator, and multiple CRDs to manage the Splunk AI Platform and Splunk AI Services.

Getting Started

Quick Install

# Install using Helm OCI registry (Recommended - Helm 3.8+)
helm install splunk-ai-operator \
  oci://ghcr.io/splunk/charts/splunk-ai-operator \
  --version 0.1.0 \
  --namespace splunk-ai-operator-system \
  --create-namespace

# Or install using kubectl
kubectl apply -f https://github.com/splunk/splunk-ai-operator/releases/download/v0.1.0/install-v0.1.0.yaml

See Installation Guide for detailed instructions and all installation methods.

Prerequisites

• Kubernetes: v1.31+ cluster
• kubectl: v1.11.3+
• Helm: v3.8+ (for Helm installation)
• Go: v1.23.0+ (for development only)
• Docker: 17.03+ (for development only)

Installation Options

Option 1: Helm OCI Registry (Recommended)

# Requires Helm 3.8+
helm install splunk-ai-operator \
  oci://ghcr.io/splunk/charts/splunk-ai-operator \
  --version 0.1.0 \
  --namespace splunk-ai-operator-system \
  --create-namespace

Option 2: kubectl (Manifests)

# Install operator with all dependencies
kubectl apply -f https://github.com/splunk/splunk-ai-operator/releases/download/v0.1.0/install-v0.1.0.yaml

Option 3: Helm (GitHub Release)

# For compatibility with older Helm versions
helm install splunk-ai-operator \
  https://github.com/splunk/splunk-ai-operator/releases/download/v0.1.0/splunk-ai-operator-0.1.0.tgz \
  --namespace splunk-ai-operator-system \
  --create-namespace

Option 4: From Source (Development)

# Install CRDs
make install

# Build and deploy
make docker-build docker-push IMG=ghcr.io/splunk/splunk-ai-operator:tag
make deploy IMG=ghcr.io/splunk/splunk-ai-operator:tag

Helm Charts

Charts are published to OCI registry and GitHub Releases:

• OCI Registry (GHCR): oci://ghcr.io/splunk/charts/splunk-ai-operator (recommended)
• GitHub Releases: Available as .tgz files for compatibility

# Install from OCI registry
helm install splunk-ai-operator \
  oci://ghcr.io/splunk/charts/splunk-ai-operator \
  --version 0.1.0

# View available versions
# Visit: https://github.com/splunk/splunk-ai-operator/pkgs/container/charts%2Fsplunk-ai-operator

Container Images

Images are published to multiple registries:

• GHCR: ghcr.io/splunk/splunk-ai-operator:v0.1.0
• Docker Hub: splunk/splunk-ai-operator:v0.1.0

# Pull from GHCR (recommended)
docker pull ghcr.io/splunk/splunk-ai-operator:v0.1.0

# Pull from Docker Hub
docker pull splunk/splunk-ai-operator:v0.1.0

Deploy AI Platform

# Create sample AI Platform
kubectl apply -k config/samples/

Uninstall

Helm:

helm uninstall splunk-ai-operator -n splunk-ai-operator

From Source:

kubectl delete -k config/samples/
make undeploy
make uninstall

Documentation

• Installation Guide - Detailed installation instructions
• Helm Deployment - Helm chart installation
• API Reference - Complete CRD specification
• AWS EKS Deployment - Production deployment on AWS
• Configuration Guides - Storage, ingress, and webhook configuration
• Troubleshooting - Common issues and solutions

License

Copyright 2025.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.