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, ConfigSeedProvider, ConfigSeedProviderOptions } from 'actor-ts';

const configSeedProviderOptions = ConfigSeedProviderOptions.create()
  .withSeeds(['10.0.0.5:2552', '10.0.0.6:2552', '10.0.0.7:2552'])
  .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.

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', '10.0.0.6: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,10.0.0.6:2552'

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.

Wann du ihn einsetzt

Drei gute Fits:

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

Wann NICHT

Dynamische Umgebungen

// K8s-Pods haben ephemere IPs:
const seedProviderOptions = ConfigSeedProviderOptions.create()
  .withSeeds(['10.244.1.5:2552'])
  .withSystemName('my-app');
new ConfigSeedProvider(seedProviderOptions);   // ✗ bricht bei Pod-Neuanlage

Pod-IPs ändern sich bei jeder Neuanlage. Nimm stattdessen KubernetesApiSeedProvider.

Auto-Scaling

Feste Seed-Listen wachsen nicht mit, wenn Nodes hochskaliert werden. Sobald der Cluster existiert, übernimmt Gossip neue Joiner — aber für den Erstkontakt werden nur die konfigurierten Seeds probiert. Aggregiere mit einem DNS- oder K8s-Provider für Dynamik.

Hostnames vs. IPs

const seedProviderOptions = ConfigSeedProviderOptions.create()
  .withSeeds(['my-pod.svc.cluster.local:2552'])
  .withSystemName('my-app');
new ConfigSeedProvider(seedProviderOptions);

Hostnames werden zum Lookup-Zeitpunkt aufgelöst. Wenn dein DNS dem Pod-Start hinterherhinkt, schlägt das Lookup fehl und Cluster.join retried. Funktioniert meist — IPs sind aber deterministischer, wenn verfügbar.

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.