Zum Inhalt springen
Deutsch

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.

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.

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 Observation

Wä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.

Drei gute Fits:

  1. Docker Compose — bekannte Service-Namen + Ports; actor-ts-1:2552 in der Umgebung jedes Service, der designierte erste Knoten.
  2. VMs mit festen IPs — drei Produktions-VMs, jede mit stabiler Adresse.
  3. Tests — bekannte Peer-Adressen inline im Test-Setup.