Config Seed Provider
ConfigSeedProvider liefert eine statische Liste von
Seed-Adressen — aus einem Constructor-Argument oder Env-Vars.
Keine Discovery-Logik; was du konfigurierst, das bekommst du.
import { Cluster, ClusterOptions } from 'actor-ts/cluster';import { ConfigSeedProvider, ConfigSeedProviderOptions } from 'actor-ts/discovery';
const configSeedProviderOptions = ConfigSeedProviderOptions.create() .withSeeds(['10.0.0.5:2552']) // der designierte erste Knoten, auf jedem Knoten .withSystemName('my-app');const provider = new ConfigSeedProvider( configSeedProviderOptions,);
const seeds = await provider.lookup();const clusterOptions = ClusterOptions.create() .withHost(host) .withPort(port) .withSeeds(seeds);await Cluster.join(system, clusterOptions);Der einfachste Provider für den einfachsten Fall.
Eine Liste, jeder Knoten
Abschnitt betitelt „Eine Liste, jeder Knoten“Gib jedem Knoten dieselbe Liste und nenne darin den designierten ersten
Knoten unter der Adresse, die er ankündigt. Auf diesem Knoten löst sich die
Liste zu ihm selbst auf, und das verwirft der Join — Cluster.bootstrap
filtert die aufgelösten Adressen, Cluster.join seine Seeds —, also bleibt er
ohne jemanden zum Anwählen zurück und bildet den Cluster; jeder andere Knoten
wählt ihn an. Eine Liste, überall richtig.
Eine Liste, die jeden Knoten nennt, ist die Form, die nicht funktioniert:
Nach dem Selbst-Ausschließen bleibt niemand mit einer leeren Liste übrig,
niemand darf den Cluster bilden, und jeder Knoten wartet in joining auf eine
Beförderung, die nie kommt — siehe
die symmetrische Seed-Liste startet nicht kalt.
Nur die Stable Observation des Bootstraps, eine Wahl unter den gelisteten
Knoten, löst dieses Patt. Dasselbe gilt für die Liste unter
actor-ts.discovery.config.seeds, die dieser Provider in Config-Form ist.
Konfiguration
Abschnitt betitelt „Konfiguration“type ConfigSeedProviderOptionsType = { seeds: string[]; // "system@host:port" oder "host:port" systemName: string; // Standard-Systemname, wenn ein Seed ihn weglässt};Zwei Wege, das anzugeben:
// Explizit:const configSeedProviderOptions = ConfigSeedProviderOptions.create() .withSeeds(['10.0.0.5:2552']) .withSystemName('my-app');new ConfigSeedProvider( configSeedProviderOptions,);
// Aus Env (CSV):seedsFromEnv('ACTOR_TS_SEEDS', 'my-app');// wobei ACTOR_TS_SEEDS='10.0.0.5:2552' — weitere Einträge nur mit Stable ObservationWähle, was zu deinem Deployment-Muster passt. Env-Vars sind typisch für Container-Deployments, in denen die Liste aus einer ConfigMap / einem Orchestrator kommt.
Wann du ihn einsetzt
Abschnitt betitelt „Wann du ihn einsetzt“Drei gute Fits:
- Docker Compose — bekannte Service-Namen + Ports;
actor-ts-1:2552in der Umgebung jedes Service, der designierte erste Knoten. - VMs mit festen IPs — drei Produktions-VMs, jede mit stabiler Adresse.
- Tests — bekannte Peer-Adressen inline im Test-Setup.
Wann NICHT
Abschnitt betitelt „Wann NICHT“Wohin als Nächstes
Abschnitt betitelt „Wohin als Nächstes“- Discovery im Überblick — das Gesamtbild.
- DNS Seed Provider — für DNS-basiertes Discovery.
- Kubernetes-API Seed Provider — für K8s-Deployments.
- Aggregate Seed Provider — mehrere Provider kombinieren.
- Joining und Seeds — wie Seeds vom Cluster-Bootstrap konsumiert werden.
