TUTORIALS

Run real Apache software, with an agent governed by Aegis.

Every tutorial puts Aegis between an IDE agent and one piece of real Apache software on a single machine. Start with the Hello World guide for the shape of the setup, then pick a deep-dive walkthrough or the project you already operate. New reviewers should read the security guide first.

DEEP DIVES

Complete walkthroughs, step by step.

These carry the full developer path: a tiny dataset or workload, an IDE agent, a governed change, and the same run through both front doors where noted.

Spark and Iceberg from your IDE

Spark 4.0.1 over Spark Connect with Iceberg 1.10.1 tables on a REST catalog. Own host and Knox 3.0.0, with VS Code, Kiro, Cursor, Claude Desktop and the MCP Python SDK. The complete developer path.

Spark and Spark Connect

Spark 4.0.1 monitoring REST API and Spark Connect through a scripted client. Run Spark jobs and SQL through an agent.

Iceberg REST catalog

The Iceberg 1.10.1 RESTCatalogServer with resource scopes, approvals and destructive-operation receipts over namespaces, properties and drops.

Kafka and Kafka Connect

A Kafka 3.9.1 KRaft broker and a Connect worker. Govern topic administration and the connector lifecycle.

Apache Flink

Flink 1.20.1 jobs, jars, savepoints, stopping and cancellation, each as a governed action.

Break-glass MCP servers

Spark, Kafka, Iceberg and Flink as one independent server each, with a signed server catalog and incident containment end to end. Repository walkthrough.

Evidence boundary: tutorials describe retained historical runs. Read the validation report and claims matrix before treating any integration as release-candidate evidence.

ONE PER PROJECT

An IDE-ready tutorial for each verified project.

These are built by tools/build-project-tutorials.py from each project's retained run. All have historical own-host and Knox records, and every kept audit journal verifies. Each tutorial gives the engine command line, both front doors step by step, VS Code, Kiro and Cursor files, prompts mapped to tools with what Aegis answered, and the full request table of that run.

ProjectVersion exercisedTutorial
Apache ActiveMQ6.3.2 (Jolokia)Open tutorial
Apache Airflow2.9.3Open tutorial
Apache BookKeeper4.18.1Open tutorial
Apache Burr (incubating)0.42.0Open tutorial
Apache Calcite over Avatica1.42.0 / 1.28.0Open tutorial
Apache CouchDB3.4.2Open tutorial
Apache Doris4.1.3Open tutorial
Apache Druid28.0.1Open tutorial
Existing MCP serverPython SDK and filesystem serverOpen tutorial
Apache Flink1.20.1Open tutorial
Apache Flume1.11.0Open tutorial
Apache Hadoop HDFS3.2.1Open tutorial
Apache HBaseRESTOpen tutorial
Apache Hive4.0.1Open tutorial
Apache Iceberg REST catalog1.10.1Open tutorial
Apache Ignite2.18.0Open tutorial
Apache Kafka and Kafka Connect3.9.1Open tutorial
Apache NiFi1.28.1Open tutorial
Apache Pinot1.2.0Open tutorial
Apache Pulsar4.0.13Open tutorial
Apache Ranger2.9.0Open tutorial
Apache Solr9.10.1Open tutorial
Apache Spark4.0.1Open tutorial
Apache Spark Connect4.0.1Open tutorial
Apache Storm2.6.2Open tutorial
Apache Superset4.0.2Open tutorial
Apache ZooKeeper3.9.3Open tutorial

The IDE settings files are checked by DocumentationAssetsTest. The transport was exercised with the official MCP Python SDK in the Spark and Iceberg tutorial; the IDEs themselves were not driven by a test.

NOT YET

Projects with a profile but no run on record.

Atlas, Cassandra, Impala and Paimon each have a configuration profile that passes the contract test, which proves route rendering and governance order, not that the product answers. None has a real run on record, so none has a tutorial yet.

The status and blocker of each are in the adopter real-engine status and the repository adopter catalog.

REFERENCE MAP

Continue in the guides.