Weboberflaeche (#531): X-Instanz an der einen fetch-Stelle, Instanzauswahl in der Kopfzeile, Verwaltungsansicht mit Anlegen/Starten/Anhalten/Fenster, Herkunft der Ereignisse, Sicherungs- und Einstellungsansicht. 402/409/502 werden eigen behandelt. Sicherungen im Manager (#530): Auflisten, Anlegen, Wiederherstellen, Loeschen. Das Zurueckspielen haelt die Instanz vorher an und startet sie danach wieder. Geordnetes Ende (Konzept 9.8). Zwei Befunde waren der Anlass: Der Manager konnte eine Instanz MIT FENSTER nie geordnet beenden. Control.ShutdownRequested war nur in HeadlessRun verdrahtet, nicht in der Avalonia-Anwendung - und ein Fenster ist die Vorgabe. Die Bitte wurde mit 202 beantwortet, niemand hoerte zu, und der Manager schoss den Prozess nach Ablauf seiner Frist jedes Mal ab. InstanceSupervisor.StopAsync hielt Socket-Schweigen fuer einen Todesnachweis und meldete "beendet", ohne den Prozess anzufassen. Bei einer verstummten Instanz ist der Socket von vornherein still - der Neustart haette einen zweiten Prozess auf dieselbe state.db gesetzt. Genau der Schaden, gegen den #528 gebaut ist. - ShutdownCoordinator: erst die Tuer schliessen, dann auf offene Arbeiten warten, Frist zwei Minuten. Vorher brach TaskScanner.DisposeAsync mitten in ProcessAsync ab, sodass die Aufgabe bis zum Lease-Ablauf auf "running" stehenblieb. - GET /api/instanz/puls hinter dem Socket-Gate: Phase und offene Arbeiten. Weiter gefragt statt gemeldet - ein Puls, den die Instanz von sich aus schickt, fehlt genau dann, wenn sie haengt. - Eskalationsleiter: drei Durchgaenge ohne Antwort, einmal um ein Ende bitten, nach 30s beenden und den Vollzug abwarten, gemeldet als Absturz. - EnsureDeadAsync vor jedem Start. Weiteres aus dem Review: - .gitignore verankert: "Instances/" passte auch auf src/ClawdDotNet.Core/Instances/. InstanceEndpoint.cs und InstanceLayout.cs waren dadurch nie eingecheckt. - Das WebUI-Token stand im Protokoll des Managers. Konsole ja, Datei nein. - Ein Klick auf "Instanz anlegen" loeste requestSubmit() zweimal aus. - [Obsolete] auf WebServerPort wieder entfernt: sechs Warnungen, die niemand abstellen konnte, solange E-M5 nicht fertig ist. - Die Wiederherstellung bricht nicht mehr ab, wenn der Browser weggeht. - Entwicklungspfade zum Instanzmanager aus Segmenten statt mit Rueckstrichen, und der Port kommt aus manager.json statt fest aus der Zeile. Offen und gemeldet: --managed hebelt die Lizenzpruefung aus (#535). 806 Tests gruen, 0 Warnungen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
@@ -0,0 +1,160 @@
|
||||
using ClawdDotNet.Core.Instances;
|
||||
using Microsoft.Extensions.Logging.Abstractions;
|
||||
using Shouldly;
|
||||
|
||||
namespace ClawdDotNet.Core.Tests.Instances;
|
||||
|
||||
/// <summary>
|
||||
/// Das geordnete Ende einer Instanz (#528).
|
||||
///
|
||||
/// <para><b>Worum es geht.</b> Bis hierher war jedes Beenden ein Abschneiden. Eine
|
||||
/// Aufgabe, die mitten in der Ausführung abgebrochen wird, ist bereits beansprucht und
|
||||
/// noch nicht abgeschlossen — sie steht danach auf <c>running</c> und bleibt dort bis zum
|
||||
/// Ablauf ihres Lease. Ein Agentenlauf verliert seine Antwort ganz.</para>
|
||||
/// </summary>
|
||||
public sealed class ShutdownCoordinatorTests
|
||||
{
|
||||
private static ShutdownCoordinator Koordinator(TimeSpan? frist = null)
|
||||
=> new(NullLogger.Instance, frist ?? TimeSpan.FromSeconds(5));
|
||||
|
||||
/// <summary>
|
||||
/// Die Reihenfolge ist der ganze Trick: erst schließen, dann warten.
|
||||
///
|
||||
/// <para>Andersherum wartet man ewig — die Quelle nähme im nächsten Takt die nächste
|
||||
/// Arbeit an, und die Zahl der offenen ginge nie auf null.</para>
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task Erst_wird_die_Tuer_geschlossen_dann_gewartet()
|
||||
{
|
||||
var geschlossen = false;
|
||||
var offenBeimSchliessen = -1;
|
||||
var offen = 3;
|
||||
|
||||
var koordinator = Koordinator();
|
||||
|
||||
koordinator.Register(new WorkSource(
|
||||
"Aufgaben",
|
||||
() => offen,
|
||||
() =>
|
||||
{
|
||||
geschlossen = true;
|
||||
offenBeimSchliessen = offen;
|
||||
}));
|
||||
|
||||
// Die Arbeiten laufen im Hintergrund aus.
|
||||
_ = Task.Run(async () =>
|
||||
{
|
||||
while (offen > 0)
|
||||
{
|
||||
await Task.Delay(30);
|
||||
offen--;
|
||||
}
|
||||
});
|
||||
|
||||
await koordinator.BeginAsync();
|
||||
|
||||
geschlossen.ShouldBeTrue();
|
||||
offenBeimSchliessen.ShouldBe(3, "Geschlossen wird, bevor gewartet wird.");
|
||||
koordinator.Phase.ShouldBe(ShutdownPhase.Done);
|
||||
koordinator.Snapshot().TotalOpen.ShouldBe(0);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Ohne offene Arbeit endet es sofort — kein Warten aus Prinzip.
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task Ohne_offene_Arbeit_endet_es_sofort()
|
||||
{
|
||||
var koordinator = Koordinator(TimeSpan.FromMinutes(10));
|
||||
koordinator.Register(new WorkSource("Aufgaben", () => 0, () => { }));
|
||||
|
||||
var begonnen = DateTimeOffset.UtcNow;
|
||||
await koordinator.BeginAsync();
|
||||
|
||||
(DateTimeOffset.UtcNow - begonnen).ShouldBeLessThan(TimeSpan.FromSeconds(2));
|
||||
koordinator.Phase.ShouldBe(ShutdownPhase.Done);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Die Frist ist eine Zusage, keine Hoffnung.
|
||||
///
|
||||
/// <para>Sonst hinge die Instanz an einem Agentenlauf, der auf ein Modell wartet, das
|
||||
/// nicht antwortet — und niemand käme je zum Ende.</para>
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task Nach_der_Frist_endet_es_auch_mit_offener_Arbeit()
|
||||
{
|
||||
var koordinator = Koordinator(TimeSpan.FromMilliseconds(300));
|
||||
koordinator.Register(new WorkSource("Agentenläufe", () => 2, () => { }));
|
||||
|
||||
await koordinator.BeginAsync();
|
||||
|
||||
koordinator.Phase.ShouldBe(ShutdownPhase.Done);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Während des Auslaufens sagt der Puls, was noch offen ist — daran erkennt der
|
||||
/// Instanzmanager, dass hier aufgeräumt und nicht gehangen wird.
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task Waehrend_des_Auslaufens_meldet_der_Stand_was_offen_ist()
|
||||
{
|
||||
var offen = 2;
|
||||
var koordinator = Koordinator(TimeSpan.FromSeconds(5));
|
||||
koordinator.Register(new WorkSource("Agentenläufe", () => offen, () => { }));
|
||||
|
||||
koordinator.Snapshot().Phase.ShouldBe(ShutdownPhase.Running);
|
||||
|
||||
var lauf = koordinator.BeginAsync();
|
||||
|
||||
// Solange etwas offen ist, steht der Stand auf Draining und nennt die Zahl.
|
||||
var stand = koordinator.Snapshot();
|
||||
stand.Phase.ShouldBe(ShutdownPhase.Draining);
|
||||
stand.TotalOpen.ShouldBe(2);
|
||||
stand.Open.Single().Name.ShouldBe("Agentenläufe");
|
||||
|
||||
offen = 0;
|
||||
await lauf;
|
||||
|
||||
koordinator.Snapshot().Phase.ShouldBe(ShutdownPhase.Done);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Zwei Aufrufer, ein Vorgang.
|
||||
///
|
||||
/// <para>Beide Wege gibt es wirklich: Der Manager bittet über den Socket, und
|
||||
/// gleichzeitig kann jemand am Fenster auf das Kreuz klicken. Zweimal auszulaufen
|
||||
/// hieße, die Tür zweimal zu schließen und zweimal zu warten.</para>
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task Ein_zweiter_Aufruf_wartet_auf_denselben_Vorgang()
|
||||
{
|
||||
var schliessungen = 0;
|
||||
var koordinator = Koordinator(TimeSpan.FromSeconds(5));
|
||||
koordinator.Register(new WorkSource("Aufgaben", () => 0, () => schliessungen++));
|
||||
|
||||
await Task.WhenAll(koordinator.BeginAsync(), koordinator.BeginAsync());
|
||||
|
||||
schliessungen.ShouldBe(1);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Eine Quelle, die beim Zählen stolpert, darf das Ende nicht aufhalten.
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task Eine_stolpernde_Quelle_haelt_das_Ende_nicht_auf()
|
||||
{
|
||||
var koordinator = Koordinator(TimeSpan.FromSeconds(30));
|
||||
|
||||
koordinator.Register(new WorkSource(
|
||||
"Kaputt",
|
||||
() => throw new InvalidOperationException("zählt nicht"),
|
||||
() => throw new InvalidOperationException("schließt nicht")));
|
||||
|
||||
var begonnen = DateTimeOffset.UtcNow;
|
||||
await koordinator.BeginAsync();
|
||||
|
||||
(DateTimeOffset.UtcNow - begonnen).ShouldBeLessThan(TimeSpan.FromSeconds(2));
|
||||
koordinator.Phase.ShouldBe(ShutdownPhase.Done);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user