core

Eru core is a stateless gRPC resource scheduler. It keeps cluster metadata in etcd or redis, allocates resources through pluggable resource plugins, and deploys workloads onto containerd containers, bare processes or cocoon virtual machines. Every instance is interchangeable: state lives in the store, coordination happens through distributed locks, and clients find live instances through the built-in service discovery.

cli / agent / your service
        │  gRPC (CoreRPC, rpc/gen/core.proto)
        ▼
   ┌─────────────────────────────────────────────┐
   │ eru-core                                    │
   │   rpc ──► cluster/calcium ──► strategy      │  deploy plan
   │             │      │                        │
   │             │      ├──► resource/cobalt ──► cpumem (built in)
   │             │      │                    └─► binary plugins
   │             │      └──► wal (in the store)  │  crash recovery
   │             ▼                               │
   │           store ──► etcd | redis            │  metadata, locks, status
   │             │                               │
   │           engine/factory (cached, per node) │
   └─────────────┼───────────────────────────────┘
                 ▼
   containerd:// | cocoon:// | process:// | mock://

Guides

• Installation — release archives, container image, building from source, the systemd unit
• Configuration — every key core reads, with types and defaults
• Architecture — the packages, what each owns, and how a deploy request flows
• gRPC API — every rpc grouped by domain, with the key request fields
• Engines — containerd, cocoon, process and fake; endpoint schemes and the engine cache
• Resource plugins — the plugin contract, cpumem and binary plugins
• Deploy strategies — AUTO, FILL, EACH, GLOBAL, DRAINED and when to use each
• Storage — etcd key layout, the redis backend, locks, embedded etcd
• Go client — the client library, connection pool and service-discovery resolvers
• Operations — WAL recovery, the node status watcher, metrics, auth, sentry, profiling

Repository

Source and issue tracker: github.com/projecteru2/core. Part of the Eru cluster stack, alongside agent, cli, resource-extend, quickstart and footstone.

This site is open source. Improve this page.