Getting Started Overview

Welcome to KubeStellar A2A! This section will guide you through everything you need to know to get up and running with the most advanced multi-cluster Kubernetes management platform.

What You’ll Learn

By the end of this getting started guide, you’ll be able to:

  • ✅ Install and configure KubeStellar A2A on your system
  • ✅ Execute basic operations across multiple Kubernetes clusters
  • ✅ Deploy applications using Helm with advanced targeting
  • ✅ Use both CLI and AI interfaces for cluster management
  • ✅ Integrate with KubeStellar binding policies and architectures

Prerequisites

Before you begin, make sure you have:

Required

  • Python 3.11 or higher - KubeStellar A2A is built with modern Python
  • kubectl configured - At least Kubernetes cluster accessible
  • Basic Kubernetes knowledge - Understanding of pods, services, deployments
  • uv package manager - For the best development experience
  • Multiple Kubernetes clusters - To fully experience multi-cluster capabilities
  • Helm 3.x - For advanced Helm deployment features

Optional (for AI features)

  • Claude Desktop - For MCP server integration
  • OpenAI API Key - For interactive agent mode (currently supported provider)

Learning Path

Choose your path based on your role and needs:

🚀 Quick Start (5 minutes)

Perfect if you want to see KubeStellar A2A in action immediately.

→ Quick Start Guide

📚 Complete Setup (15 minutes)

Comprehensive installation and configuration for production use.

→ Installation Guide

⚙️ Configuration Deep Dive (10 minutes)

Advanced configuration options and customization.

→ Troubleshooting Guide

Architecture At A Glance

KubeStellar A2A provides multiple ways to interact with your Kubernetes infrastructure:

Key Concepts

Functions

Self-contained operations that can be executed via CLI or AI interface. Examples:

  • get_kubeconfig - Analyze cluster configurations
  • helm_deploy - Deploy Helm charts with binding policies
  • kubestellar_management - Advanced KubeStellar automation

Multi-Cluster Operations

All functions support advanced cluster targeting:

  • Specific clusters: Target named clusters
  • Label selectors: Use Kubernetes-style labels
  • All clusters: Operate across your entire fleet

Namespace Management

Sophisticated namespace handling:

  • All namespaces: --all-namespaces flag
  • Specific namespaces: Target individual namespaces
  • Namespace selectors: Label-based namespace targeting

KubeStellar Integration

Native support for KubeStellar 2024 architecture:

  • WDS/ITS/WEC cluster types
  • Binding Policies for workload placement
  • Work Status tracking and management

Next Steps

Ready to begin? Choose your preferred starting point:

🚀 I want to try it now

Get KubeStellar A2A running in 5 minutes with our quick start guide. → Quick Start

📦 I want the full setup

Complete installation with all features configured for production use. → Installation Guide

Need Help?

Ready to revolutionize your Kubernetes multi-cluster management? Let’s get started! 🚀