feat(installer): Laufzeitpruefung, Host-Ueberwachung, Zugang fuer Adminkonten
Drei Dinge, die beim ersten Lauf des Installers auf einer Linux-Maschine auffielen. 1. Die Release-Ablage wies Administratorkonten ab. ReleaseGuard nahm nur die Rolle 'installer' in die .htpasswd auf, waehrend Installskripte und Agent ausdruecklich sagten, ein Administratorkonto tue es auch: Anmeldung und Katalog gelangen, erst der Download endete mit 401 - und die Meldung sprach von abgelaufenen Lizenzen, die es bei einer Erstinstallation gar nicht geben kann. Adminkonten zaehlen jetzt zu den Installationskonten. FORMAT_VERSION auf 3, damit reconcile() die Dateien sofort neu schreibt statt erst beim naechsten turnusmaessigen Lauf; ein neu angelegtes Konto landet ausserdem unabhaengig von seiner Rolle sofort darin. Bei einem 401 mit Benutzerzugangsdaten nennt der Client jetzt Konto und zugangsberechtigte Rollen, und der Agent bricht ab, statt ueber die API weiterzusuchen und dieselbe Meldung ein paar Schritte spaeter ein zweites Mal zu zeigen. 2. Der Installer prueft die .NET-Laufzeit. Bisher endete eine gelungene Installation auf einer Maschine ohne .NET mit einer Anwendung, die sich nicht starten laesst - und die Fehlersuche begann beim Deploymentcenter, weil das der letzte bewusste Schritt war. Gelesen wird die runtimeconfig.json der Anwendung und mit "dotnet --list-runtimes" verglichen; fehlt etwas, nennt der Installer den Installationsbefehl fuer diese Plattform. Eigenstaendig veroeffentlichte Pakete werden nicht bemaengelt, rollForward wird beachtet. 3. Die Ueberwachung der Maschine entsteht im Installer. Zwei Fragen - Name im Dashboard und ob eingeplant werden soll - statt fuenf Schritten in der Oberflaeche an einem anderen Rechner. Monitor, Token mit genau watchdog:ping, Skript, Dateirechte, ein Heartbeat zur Probe und der Cron-Eintrag bzw. die geplante Aufgabe entstehen daraus. Fuer Maschinen ohne Installation: --action monitor. Die Agent-Skripte werden jetzt in src/Modules/Watchdog/AgentScript.php erzeugt - von Oberflaeche und Installer gemeinsam - und melden Last, Speicher, Plattenbelegung und Laufzeit mit, statt nur "status: ok". Beim Ausfuehren fielen zwei Fehler auf, die dort behoben sind: df -P verrutscht bei Geraetenamen mit Leerzeichen (gezaehlt wird jetzt von hinten), und ohne LC_ALL=C erzeugt awk auf einem deutschen System "12,5" und damit kaputtes JSON. Neu: POST /api/setup/v1/agent. SDK 2.6.0 mit SetupClient.RequestWatchdogAgentAsync(). Die OpenAPI-Beschreibung des neuen Endpunkts bleibt zunaechst aussen vor: public/api/openapi.php traegt gerade auch fremde, noch nicht committete Aenderungen aus einer parallel laufenden Arbeit. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
co-authored by
Claude Opus 5
Claude Opus 5
parent
fc9b698141
commit
687ee0cefc
@@ -6,6 +6,7 @@
|
||||
* POST /api/setup/v1/login Benutzername + Passwort -> kurzlebiges Token
|
||||
* GET /api/setup/v1/catalog Was ist hier installierbar?
|
||||
* POST /api/setup/v1/token Dauertoken fuer die eingerichtete Anwendung
|
||||
* POST /api/setup/v1/agent Watchdog-Agent fuer die Maschine selbst
|
||||
*
|
||||
* Warum ein eigener Anmeldeweg statt eines Dauertokens: Ein Token muesste
|
||||
* vorher jemand erzeugen und auf das Zielsystem bringen - genau die Huerde,
|
||||
@@ -36,6 +37,8 @@ use Deploymentcenter\Core\TokenManager;
|
||||
use Deploymentcenter\Modules\License\RateLimiter;
|
||||
use Deploymentcenter\Modules\Setup\SetupCatalog;
|
||||
use Deploymentcenter\Modules\UpdateService\UpdateManager;
|
||||
use Deploymentcenter\Modules\Watchdog\AgentScript;
|
||||
use Deploymentcenter\Modules\Watchdog\MonitorRepo;
|
||||
|
||||
Http::beginJson(['GET', 'POST', 'OPTIONS'], true);
|
||||
|
||||
@@ -222,9 +225,128 @@ switch (resolveSetupAction()) {
|
||||
'message' => 'Token ausgestellt. Es wird nur einmal ausgeliefert.',
|
||||
], 201);
|
||||
|
||||
case 'agent':
|
||||
// Der Watchdog-Agent fuer die Maschine, auf der gerade installiert
|
||||
// wird.
|
||||
//
|
||||
// Bisher gab es diesen Weg nur ueber die Oberflaeche: Monitor von Hand
|
||||
// anlegen, Token erzeugen, Skript herunterladen, auf den Host kopieren,
|
||||
// Cron-Eintrag schreiben. Fuenf Schritte an einem anderen Rechner, fuer
|
||||
// etwas, das genau dann ansteht, wenn man ohnehin auf dem Zielsystem
|
||||
// sitzt - entsprechend oft unterblieb es, und die frisch installierte
|
||||
// Anwendung lief auf einem unbeobachteten Host.
|
||||
//
|
||||
// Ausgestellt wird dasselbe wie bei 'token': ein Token mit genau
|
||||
// watchdog:ping. Es liegt anschliessend im Klartext im Skript auf dem
|
||||
// Zielsystem - mehr Rechte duerfen daran nicht haengen.
|
||||
if (Http::method() !== 'POST') {
|
||||
Http::fail(405, 'method_not_allowed', 'Dieser Endpunkt erwartet POST.');
|
||||
}
|
||||
|
||||
$context = ApiAuth::requireScope($db, 'setup:install', null, false);
|
||||
|
||||
$project = Http::str('project') ?? Http::str('product_slug');
|
||||
if ($project === null || $project === '') {
|
||||
Http::fail(400, 'missing_project', 'Der Parameter "project" wird benoetigt.');
|
||||
}
|
||||
|
||||
ApiAuth::enforceProject($context, $project);
|
||||
|
||||
$exists = $db->prepare('SELECT slug FROM dc_projects WHERE slug = :slug LIMIT 1');
|
||||
$exists->execute([':slug' => $project]);
|
||||
if ($exists->fetch() === false) {
|
||||
Http::fail(404, 'unknown_project', sprintf('Ein Projekt "%s" ist nicht angelegt.', $project));
|
||||
}
|
||||
|
||||
// Der Name ist das, was spaeter im Dashboard steht. Gesaeubert wird in
|
||||
// AgentScript - hier wird nur geprueft, ob ueberhaupt etwas uebrig
|
||||
// bleibt, damit nicht stillschweigend ein Monitor "host" entsteht.
|
||||
$rawSource = trim((string)(Http::str('source') ?? ''));
|
||||
if ($rawSource === '') {
|
||||
Http::fail(400, 'missing_source', 'Der Parameter "source" (Name des Monitors) wird benoetigt.');
|
||||
}
|
||||
|
||||
$source = AgentScript::sanitizeSource($rawSource);
|
||||
|
||||
$monitorRepo = new MonitorRepo($db);
|
||||
$existing = $monitorRepo->getMonitor($source);
|
||||
|
||||
// Ein Name, den es schon gibt, ist nicht zwangslaeufig ein Fehler -
|
||||
// eine Neuinstallation derselben Maschine trifft ihren eigenen Monitor
|
||||
// wieder. Nur entscheiden muss das der Aufrufer, nicht dieser
|
||||
// Endpunkt: sonst uebernimmt eine zweite Maschine unbemerkt die
|
||||
// Historie der ersten.
|
||||
$overwrite = filter_var(Http::input('overwrite', false), FILTER_VALIDATE_BOOLEAN);
|
||||
|
||||
if ($existing !== null && !$overwrite) {
|
||||
Http::fail(409, 'monitor_exists', sprintf(
|
||||
'Ein Monitor "%s" ist bereits angelegt (Zustand: %s). Mit overwrite=true uebernehmen.',
|
||||
$source,
|
||||
(string)($existing['state'] ?? 'unbekannt')
|
||||
), null, [
|
||||
'source' => $source,
|
||||
'state' => $existing['state'] ?? null,
|
||||
'last_seen' => $existing['last_seen_utc'] ?? null,
|
||||
]);
|
||||
}
|
||||
|
||||
$os = AgentScript::normalizeOs(Http::str('os'));
|
||||
$interval = Http::int('interval', 60);
|
||||
|
||||
$manager = new TokenManager($db);
|
||||
$agentToken = $manager->createMasterToken(
|
||||
sprintf('Watchdog %s', $source),
|
||||
$project,
|
||||
null,
|
||||
'host',
|
||||
$source,
|
||||
['watchdog:ping'],
|
||||
Http::str('environment') ?? 'all'
|
||||
);
|
||||
|
||||
$monitorRepo->createMonitor($source, [
|
||||
'type' => 'host',
|
||||
'os' => $os,
|
||||
'expected_interval_sec' => $interval,
|
||||
'group_key' => Http::str('group'),
|
||||
'parent_source' => Http::str('parent'),
|
||||
]);
|
||||
|
||||
$agent = AgentScript::build(
|
||||
$os,
|
||||
$source,
|
||||
$agentToken['raw_token'],
|
||||
Http::baseUrl() . '/api/watchdog/v1/ping',
|
||||
$interval
|
||||
);
|
||||
|
||||
Logger::info('Watchdog-Agent ueber den Setup-Weg ausgestellt', [
|
||||
'project' => $project,
|
||||
'source' => $source,
|
||||
'os' => $os,
|
||||
'existing' => $existing !== null,
|
||||
'actor' => $context['actor'],
|
||||
'token_id' => $agentToken['token_id'],
|
||||
]);
|
||||
|
||||
Http::ok([
|
||||
'source' => $source,
|
||||
'os' => $agent['os'],
|
||||
'filename' => $agent['filename'],
|
||||
'script' => $agent['script'],
|
||||
'schedule' => $agent['schedule'],
|
||||
'interval' => $agent['interval'],
|
||||
'token_id' => $agentToken['token_id'],
|
||||
'existing' => $existing !== null,
|
||||
'message' => sprintf(
|
||||
'Monitor "%s" eingerichtet. Das Skript enthaelt das Token und wird nur einmal ausgeliefert.',
|
||||
$source
|
||||
),
|
||||
], 201);
|
||||
|
||||
default:
|
||||
Http::fail(404, 'unknown_action', 'Endpunkt nicht gefunden.', null, [
|
||||
'available' => ['login', 'catalog', 'token'],
|
||||
'available' => ['login', 'catalog', 'token', 'agent'],
|
||||
]);
|
||||
}
|
||||
|
||||
@@ -247,7 +369,7 @@ function resolveSetupAction(): string
|
||||
$last = strtolower((string)end($segments));
|
||||
|
||||
return match ($last) {
|
||||
'login', 'catalog', 'token' => $last,
|
||||
'login', 'catalog', 'token', 'agent' => $last,
|
||||
default => 'unknown',
|
||||
};
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user