Server Agent via STACKIT API installieren

Um unsere neuesten Features wie Run Command, Server Update Management Service und viele weitere zukünftige Funktionen nutzen zu können, muss der STACKIT Server Agent als Basis auf Ihrem Server installiert sein. Der STACKIT Server Agent dient als Schnittstelle zwischen unserer Infrastruktur und dem Betriebssystem. Er empfängt und verarbeitet remote gesendete Skripte und führt sie lokal auf Ihrem Server aus, sodass Sie Ihre Server-Einstellungen nach Bedarf anpassen können.

Die folgende Dokumentation beschreibt, wie Sie Ihren Server mithilfe der API vollständig konfiguriert mit der neuesten verfügbaren Version des STACKIT Server Agent bereitstellen. Wenn Sie es vorziehen, Ihr System und die Run Command-Funktion über das STACKIT Portal zu konfigurieren und zu verwalten, lesen Sie bitte diese Dokumentation: Server Agent via Portal installieren.

Voraussetzungen

Sie haben ein Service Account erstellt.
(Siehe: Service Accounts erstellen, verwalten und löschen)
Sie haben diesem Service Account die erforderlichen Projektberechtigungen zugewiesen. (Siehe: Rollen einem Benutzer oder Service Account zuweisen)
Sie haben ein Access Token für diesen Service Account erstellt. (Siehe: Kurzlebige Access Tokens abrufen)
Grundkenntnisse in der Nutzung von APIs: VM über API erstellen
Windows Server über APIs und CLIs erstellen: Windows Server über die STACKIT API erstellen

Installation des STACKIT Server Agent auf einem neuen Server über die API

Der STACKIT Server Agent wird über Hersteller-Daten (vendor data) installiert, wenn das Flag provisionSTACKITserver in der API-Anfrage enthalten ist. Stellen Sie sicher, dass dieses Flag gesetzt ist, wenn Sie einen Server über die API bereitstellen und der Agent installiert werden soll. Sie können dieses Flag entweder

als label in der IaaS API (Weitere Informationen finden Sie auch in der API-Dokumentation (stackit.cloud)) oder über Terraform setzen (Weitere Informationen finden Sie auch unter stackit_server | Resources | stackitcloud/stackit | Terraform | Terraform Registry).
als Metadata in der Openstack API, CLI oder Terraform setzen.

Diese Methode zur Bereitstellung des STACKIT Server Agent wird für alle neuesten x86-Versionen öffentlicher STACKIT Images unterstützt (ARM wird zukünftig unterstützt). Beachten Sie auch, dass wenn vendor_data2 (dynamische Hersteller-Daten) in Ihrem Betriebssystem nicht mehr unterstützt wird (z. B. Debian 11), Sie die Benutzer-Daten (user data) verwenden können, um den STACKIT Server Agent durch Einfügen des Installationsskripts zu installieren. Bitte beachten Sie hierfür die Installationsskripte des STACKIT Server Agent für Linux und Windows in der folgenden Dokumentation: Server Agent via Portal installieren.

Überprüfung der Installation des STACKIT Server Agent

Überprüfen Sie nach dem Start der Server-Bereitstellung den Status Ihres Servers. Sobald der Server verfügbar ist und Sie sich anmelden können, überprüfen Sie, ob der STACKIT Server Agent ordnungsgemäß installiert wurde, indem Sie den Status des STACKIT Server Agent-Dienstes STACKITServerAgent überprüfen. In Windows verwenden Sie den folgenden PowerShell-Befehl:

Get-Service STACKITServerAgent

Alternativ überprüfen Sie den Status im Tab Dienste des Task-Managers:

Liste der Windows-Dienste, in der der Dienst „STACKITServerAgent“ mit dem Status „Wird ausgeführt“ hervorgehoben ist.

In Linux verwenden Sie den folgenden Befehl:

systemctl status stackit-server-agent.service

Linux-Terminalausgabe, die den Status von „stackit-server-agent.service” über systemctl als „aktiv (läuft)” anzeigt.

Der STACKIT Server Agent ist nun vollständig konfiguriert und kann zur Ausführung von Befehlen verwendet werden.

Installation des STACKIT Server Agent auf einem bestehenden Server

Wenn Sie bereits einen laufenden Linux- oder Windows-Server haben, können Sie den STACKIT Server Agent nachträglich manuell mit der folgenden Dokumentation installieren: Server Agent via STACKIT Portal installieren.