MCPcopy Index your code
hub / github.com/NVIDIA/ais-k8s

github.com/NVIDIA/ais-k8s @v3.1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v3.1.0 ↗ · + Follow
1,077 symbols 3,000 edges 87 files 486 documented · 45%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

AIStore on Kubernetes

Artifact Hub

AIStore is a lightweight, scalable object storage solution designed for AI applications. This repository serves as a complete toolkit for setting up AIStore in a Kubernetes (K8s) environment.

Overview

  • Documentation/Guide: This guide provides detailed, step-by-step instructions for deploying AIStore on K8s.
  • Ansible Playbooks: These playbooks are designed to streamline the setup of Kubernetes worker nodes for hosting AIStore deployments.
  • Kubernetes Operator: The AIS K8s Operator simplifies critical tasks such as bootstrapping, deployment, scaling, graceful shutdowns, and upgrades. It extends Kubernetes' native API, automating the lifecycle management of AIStore clusters.
  • Helm Charts: Helm charts for deploying AIS resources to be controlled by the operator.
  • Monitoring: Instructions and Helm charts for setting up a Kubernetes-based AIStore monitoring stack.

A Simple System Overview

The diagram illustrates an AIStore deployment on a multi-node K8s cluster, with each node containing a proxy and a target pod. The proxy redirects client requests to the target pods, which handle data storage and retrieval. These pods utilize Persistent Volume Claims (PVCs) bound to Persistent Volumes (PVs) corresponding to actual storage disks. The AIS Operator oversees the entire setup, managing all operations related to the cluster.

system-overview

Small Scale Experimental Deployments

This repository mainly focuses on production deployments of AIStore with multiple nodes and multiple drives per node. If you don't require such scale then consider checking out the different deployment options available.

Deployment Guide

For a clear and detailed roadmap, our Step-by-Step Deployment Guide provides extensive instructions and best practices for setting up AIStore clusters on Kubernetes.

AIStore Operator

The AIS Operator is responsible for managing the resources and lifecycle of AIS clusters in K8s. It is the only recommended and supported method for managing production-level AIS clusters in K8s.

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Method 609
Function 331
Struct 118
TypeAlias 8
Class 7
Interface 4

Languages

Go93%
Python7%

Modules by API surface

operator/api/v1beta1/zz_generated.deepcopy.go144 symbols
operator/api/v1beta1/aistore_types.go107 symbols
operator/pkg/controllers/cluster_controller.go55 symbols
operator/tests/e2e/client_cluster.go52 symbols
operator/pkg/client/api.go48 symbols
operator/api/v1beta1/aisconfig.go47 symbols
operator/pkg/services/authn_api.go42 symbols
operator/api/aisauth/v1alpha1/zz_generated.deepcopy.go42 symbols
operator/tests/tutils/api.go40 symbols
operator/pkg/controllers/common.go34 symbols
operator/pkg/services/aisapi.go26 symbols
operator/api/v1beta1/aistore_webhook.go26 symbols

For agents

$ claude mcp add ais-k8s \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page