How arcellateam/arcella works
Arcella is a modular WebAssembly application runtime, with an ALME Unix-socket daemon and a CLI for administration. The documented workflow is: an administrator issues lifecycle requests; ALME routes them to runtime operations, which install components and process deployment specifications to manage replicas. Configuration and manifest handling support that lifecycle, while the engine layer provides Wasmtime integration. The README describes hybrid isolation, scaling, and Component Model support, but the supplied excerpts do not show their runtime call paths, so those relationships are not asserted here.
Main entry points: runtime/mod.rs Runtime API · server.rs ALME socket server · deploy.rs Deployment processing · manifest/mod.rs Component manifests
Components 23
Administration
- CLI
arcella-cli/src/main.rs - Daemon startup
arcella/src/main.rs - ALME socket server
arcella/src/alme/server.rs - ALME commands
arcella/src/alme/commands.rs
Runtime lifecycle
- Runtime API
arcella-core/src/runtime/mod.rs - Component installation
arcella-core/src/runtime/install.rs - Deployment processing
arcella-core/src/runtime/deploy.rs - Lifecycle mutators
arcella-core/src/runtime/mutators.rs - Runtime state
arcella-core/src/runtime/state.rs - Module storage
arcella-core/src/storage/mod.rs
Configuration and definitions
- Configuration loading
arcella-core/src/config/config_loader.rs - Configuration files
arcella-core/src/config/toml_files.rs - TOML parsing
arcella-core/src/utils/toml.rs - Component manifests
arcella-core/src/manifest/mod.rs - Deployment specifications
arcella-types/src/manifest.rs - Component interfaces
arcella-types/src/interface_list.rs - Module identity
arcella-types/src/module_id.rs - Interface specifications
arcella-types/src/spec.rs - Configuration types
arcella-types/src/config.rs
Execution engine
- Wasmtime engine
arcella-core/src/engine/mod.rs - WASM manifest extraction
arcella-core/src/wasmtime/manifest.rs - Wasmtime conversions
arcella-core/src/wasmtime/from_wasmtime.rs
Other components
- Administrator
Connections 27
- Administrator → CLI: issues commands
- Administrator → ALME socket server: sends requests
- CLI → ALME socket server: uses socket
- Daemon startup → ALME socket server: starts server
arcella/src/main.rs - ALME socket server → ALME commands: dispatches requests
arcella/src/alme/server.rs - ALME socket server → Runtime API: passes runtime
arcella/src/alme/server.rs - ALME commands → Runtime API: manages lifecycle
- Runtime API → Component installation: delegates install
arcella-core/src/runtime/mod.rs - Runtime API → Deployment processing: delegates deploy
arcella-core/src/runtime/mod.rs - Runtime API → Lifecycle mutators: delegates mutations
arcella-core/src/runtime/mod.rs - Runtime API → Runtime state: uses state
arcella-core/src/runtime/mod.rs - Component installation → Runtime state: updates state
arcella-core/src/runtime/install.rs - Component installation → Module storage: uses storage
arcella-core/src/runtime/install.rs - Deployment processing → Component manifests: loads manifests
arcella-core/src/runtime/deploy.rs - Deployment processing → Module storage: uses storage
arcella-core/src/runtime/deploy.rs - Deployment processing → Runtime state: updates state
arcella-core/src/runtime/deploy.rs - Lifecycle mutators → Runtime state: updates state
arcella-core/src/runtime/mutators.rs - Lifecycle mutators → Component manifests: uses manifests
arcella-core/src/runtime/mutators.rs - Configuration loading → Configuration files: loads files
arcella-core/src/config/config_loader.rs - Configuration loading → TOML parsing: parses values
arcella-core/src/config/config_loader.rs - Component manifests → WASM manifest extraction: extracts WASM metadata
arcella-core/src/manifest/mod.rs - Component manifests → Deployment specifications: combines deployment data
- Deployment specifications → Module identity: identifies component
arcella-types/src/manifest.rs - Deployment specifications → Component interfaces: declares interfaces
arcella-types/src/manifest.rs - Component interfaces → Interface specifications: stores item specs
arcella-types/src/interface_list.rs - Runtime API → Wasmtime engine: executes components
- Wasmtime engine → Wasmtime conversions: uses conversions