Skip to main content

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 one 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 only 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! 🚀