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 Docker containers or yavirt 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 (bbolt)         │  crash recovery
   │             ▼                               │
   │           store ──► etcd | redis            │  metadata, locks, status
   │             │                               │
   │           engine/factory (cached, per node) │
   └─────────────┼───────────────────────────────┘
                 ▼
   tcp:// unix:// | virt-grpc:// | systemd:// | 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 — docker, virt, systemd and fake; endpoint schemes, the engine cache, TLS
• 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. The virt engine targets yavirt, which is archived.

This site is open source. Improve this page.