Getting Started

Welcome to the KubeStellar Getting Started Guide! 🚀

This guide will help you set up and start using KubeStellar for multi-cluster Kubernetes orchestration.

Prerequisites

Before you begin, make sure you have:

Kubernetes clusters (2 or more)
kubectl installed and configured
Helm 3 or later
Basic understanding of Kubernetes concepts

Installation Steps

Step 1: Install KubeStellar Core


kubectl apply -f https://github.com/kubestellar/kubestellar/releases/latest/download/kubestellar.yaml

Step 2: Verify Installation

Check that all KubeStellar components are running:


kubectl get pods -n kubestellar-system

Expected output:


NAME                                   READY   STATUS    RESTARTS   AGE
kubestellar-controller-manager-xxx     1/1     Running   0          30s
kubestellar-webhook-xxx                1/1     Running   0          30s

Step 3: Register Your Clusters


kubectl apply -f - <<EOF
apiVersion: control.kubestellar.io/v1alpha1
kind: WorkloadCluster
metadata:
  name: cluster-1
spec:
  kubeconfig:
    secretRef:
      name: cluster-1-kubeconfig
      namespace: kubestellar-system
EOF

Quick Example

Deploy a sample application across multiple clusters:


apiVersion: control.kubestellar.io/v1alpha1
kind: BindingPolicy
metadata:
  name: nginx-deployment
spec:
  clusterSelectors:
    - matchLabels:
        environment: production
  downsync:
    - apiGroup: apps
      resources: [deployments]
      namespaces: [default]

Next Steps

📚 Read the API Documentation
🎯 Follow the Tutorials
💬 Join our Community

✅ You’re all set to start orchestrating with KubeStellar!