How d1abloo/instancias-briefly works
Briefly is a control plane for ephemeral Linux instances: users launch work from the panel, the scheduler selects a node, and the instance manager provisions an isolated container; expiry removes its resources and terminal credentials. The repository also exposes cloud environments, stacks, databases, deployments, account/security, and administration capabilities. The principal workflow is documented in the README; several worker interactions and subsystem links are inferred only at the documented level because their wiring was not excerpted.
Main entry points: src/main.ts Node scheduler · instances.service.ts Instance lifecycle API · src/main.ts Instance manager · cloud-adapter.ts Cloud environments
Components 26
User panel
- Web panel
apps/web/src/pages/instances/index.tsx
API control plane
- Application API
apps/api/src/app.module.ts - Instance lifecycle API
apps/api/src/instances/instances.service.ts - Cloud environments
apps/api/src/instances/cloud-adapter.ts - Deployments
apps/api/src/modules/deployments/deployments.service.ts - Stacks
apps/api/src/modules/stacks/stacks.service.ts - Managed databases
apps/api/src/modules/databases/databases.service.ts - Capacity policy
apps/api/src/modules/capacity.ts - Account and platform
apps/api/src/platform/platform.service.ts - Administration
apps/api/src/admin/admin.service.ts
Job workers
- Node scheduler
services/scheduler/src/main.ts - Deployment worker
services/deployment-worker/src/index.ts - Stack orchestrator
services/stack-orchestrator/src/index.ts - Resource reconciler
services/reconciler/src/main.ts - Resource reconciliation
services/resource-reconciler/src/index.ts - Metrics collection
services/metrics-worker/src/main.ts - Job queue
Node runtime
- Instance manager
services/instance-manager/src/main.ts - Container provisioning
services/instance-manager/src/host.ts - Local cloud services
services/instance-manager/src/floci.ts
Operations and access
- Terminal gateway
services/terminal-gateway/src/main.ts - Resource access
services/instance-manager/src/access.ts - App catalog policy
packages/config/src/apps.ts - Persistent state
Other components
- User
- Linux node
Connections 25
- User → Web panel: uses
README.md - Web panel → Application API: requests
- Application API → Instance lifecycle API: routes lifecycle
- Instance lifecycle API → Node scheduler: enqueues work
- Node scheduler → Job queue: adds jobs
services/scheduler/src/main.ts - Node scheduler → Persistent state: selects and updates
services/scheduler/src/main.ts - Node scheduler → Instance manager: dispatches jobs
- Instance manager → Container provisioning: provisions
services/instance-manager/src/main.ts - Container provisioning → Linux node: runs isolated containers
README.md - Instance manager → Persistent state: records job state
services/instance-manager/src/main.ts - Cloud environments → Instance lifecycle API: loads cloud runtime
apps/api/src/instances/cloud.controller.ts - Cloud environments → Local cloud services: proxies cloud requests
- Deployments → Deployment worker: dispatches deployments
- Stacks → Stack orchestrator: orchestrates stacks
- Managed databases → Capacity policy: checks capacity
apps/api/src/modules/databases/databases.service.ts - Stacks → Capacity policy: checks capacity
apps/api/src/modules/stacks/stacks.service.ts - Instance lifecycle API → App catalog policy: validates app manifests
- Resource reconciler → Persistent state: sweeps resource state
services/reconciler/src/main.ts - Resource reconciliation → Persistent state: reconciles resources
- Metrics collection → Persistent state: stores metrics and logs
services/metrics-worker/src/main.ts - Terminal gateway → Persistent state: validates terminal claim
services/terminal-gateway/src/main.ts - Terminal gateway → Linux node: attaches terminal
services/terminal-gateway/src/main.ts - Resource access → Persistent state: manages access state
- Account and platform → Persistent state: manages account resources
- Administration → Persistent state: reads operations state