Technical Documentation¶
Platform architecture, infrastructure, and development documentation.
Architecture¶
- BigRAE identifier inventory
-
Current-state architecture handbook - System, authority, lifecycle and package ownership
- Install BigRAE on GCP - Install a deployment from a published release
- GitHub-less GCP deployment - Release, foundation, inputs, deploy, update, teardown, and bucket encryption keys without GitHub
- Scenario contract transition - CyberScript, ACES and current RAES
- Per-range model-access design - Proposed architecture, security, operations, ADRs, and implementation backlog for #681
- Model-access contracts - Proposed ownership, allocation, accounting, protocol, and lifecycle contracts
Platform Domains¶
- Platform Overview - Domain architecture
- Mission Control - Presentation layer
- Engine - Range orchestration
- CMS - Content management
- Management - Administration
Infrastructure¶
- Infrastructure Overview - AWS and GCP components
- GCP Infrastructure - GKE, Cloud SQL, Helm, Cloud Armor, and GCP services
- GCP Event Capacity - Versioned shared-service profiles, projections, drift, and the p30 gate
- GDC Provisioning - Range guests on GDC (KubeVirt, pods)
- Range Instantiation Policy - Which range backend may serve which kind of launch
- Networking - Network architecture (both clouds)
- CI/CD - Deployment pipelines
- Machine Images - AMIs (AWS) and GDC images
- Guacamole - Terminal infrastructure
- Manual Deployment - Manual setup steps
Development¶
- Development Overview - Getting started with development
- Local Setup - Local environment
- Developer environment setup - Deploy a development environment from a fork with GitHub Actions
- AWS native identity - Identity and policy operations for AWS development deployments
- Portal on EKS operations - Operate the portal in AWS development deployments
- Terraform - Infrastructure patterns
- CI/CD - Pipeline configuration
- Secrets - Secrets management
- Platform API Development - DRF endpoint, schema, scope, and error-envelope conventions
- Cloud Adapters - Cloud abstraction layer
- Principles - Engineering philosophy
- ADR Enforcement - Architecture guardrails and policy checks
Planning & Notes¶
Internal planning documents and development notes.