Eyrie Principals

Eyrie Principals documents the design philosophy and architecture behind Eyrie. These pages explain the core concepts — playbooks, scopes, the deployment lifecycle, the job system, cloud abstraction, and the object model — so that contributors and power users can understand why Eyrie works the way it does.

• Playbooks
  • What is a Deployment Book?
  • Books and Steps
  • Step Data Serialization
  • Step Applicability
  • Nesting and Composability
  • Versioning
  • Named Book Slots on Deployments
  • The Principal
• Scopes and Config
  • Config Scope Refactor
  • Cluster Assignment
  • Root Subdomain
  • Pause and Drop Timers
  • Access Control
  • Scope Transition Gating
• Deployment Lifecycle
  • States
  • Actions
    • action_deploy
    • action_pause
    • action_drop
  • Error States
  • Type-Dispatched Actions
  • Scheduled Pause and Drop
  • State vs Repository State
• Jobs
  • Job Model
  • Job Lifecycle
  • Step Serialization
  • Retry Mechanism
  • Integration with OCA queue_job
  • Estimated Durations and Timeouts
  • Bus Notifications
• Cloud Abstraction
  • Cloud Provider Model
  • Cloud Provided Mixin
  • Type-Specific Method Dispatch
  • Linode Integration
  • Cloudflare Integration
  • Extensibility
• Object Model
  • Hierarchy: Project → Deployment Group → Deployment
  • Clusters
  • Namespaces
  • Repositories and Branches
  • Datasources
  • Monitors
  • Project Users