Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Draft: Module 1 - Federation Fundamentals

Core concepts, bundle creation, and basic composition.

Overview

This module introduces federated architecture and teaches you to create and compose architecture bundles.

Lessons

Lesson 1: What is Federation?

Core concepts and architecture

  • Why federated architecture?
  • Key concepts: bundles, system index, canonical IDs
  • Federation architecture diagram
  • When to use federation

Lesson 2: Publishing Bundles

Create and distribute repo bundles

  • Bundle structure
  • Publishing commands
  • Bundle contents deep dive
  • Versioning and updates

Lesson 3: Basic Composition

Compose bundles into system index

  • Compose command
  • System index structure
  • Basic cross-repo view
  • Verification and validation

Learning Outcomes

  • ✅ Understand federation concepts
  • ✅ Publish a repo bundle
  • ✅ Compose bundles into system index
  • ✅ View cross-repo architecture

Prerequisites

  • Basic Sruja DSL knowledge
  • Understanding of microservices
  • Command line familiarity

Raw Thoughts

v0.35.0 Features to Cover:

  • sruja publish command
  • sruja compose command
  • Architecture Index MVP with Federated Registry
  • Bundle schema and system index schema

Key Concepts:

  • repo.bundle.json - published architecture artifact
  • system.index.json - composed multi-repo graph
  • Canonical IDs: repo_id::local_id
  • Conflicts array for duplicates