Wiki source code of Microservices

Last modified by Jannis Klein on 2024/08/13 07:44

Hide last authors
Jannis Klein 1.1 1 {{aagon.floatingbox/}}
2
3 Im Arbeitsbereich //Microservices// können Sie alle verfügbaren Microservice-Pakete und -Vorlagen verwalten sowie die Supervisoren mit den installierten Microservice-Instanzen steuern.
4
5 {{aagon.infobox}}
6 Sollten Ihnen noch keine Microservice-Pakete und -Instanzen angezeigt werden, müssen Sie erst einmal [[Produkte installieren>>doc:AESB.19.Workspaces.Produkte.WebHome||anchor="#HProdukteinstallieren"]].
7 {{/aagon.infobox}}
8
9 Der Arbeitsbereich unterteilt sich in die Liste der Microservice-Pakete und -Vorlagen, die Liste der Supervisoren und Microservice-Instanzen sowie den Bereich mit Detailinformationen zu Ihrer jeweiligen Auswahl.An dieser Stelle soll kurz der Unterschied zwischen Microservice-Vorlagen und Microservice-Instanzen erläutert werden: Bei einer Microservice-Vorlage handelt es sich in AESB um die spezifische Konfiguration von einer bestimmten Version eines Microservice-Packages. Diese Vorlage kann jederzeit beliebig angepasst werden, denn sie ist keine Systemkomponente, die kommuniziert. Aus einer Microservice-Vorlage kann dann die sogenannte Microservice-Instanz erzeugt werden. Bei der Microservice-Instanz handelt es sich dann um einen aktiven Prozess, der durch einen Microservice-Supervisor überwacht und gesteuert wird.
10
11 {{figure}}
12 (% style="text-align:center" %)
13 [[image:Übersicht_Microservice_Workspace.png||alt="Arbeitsbereich zur Microservice-Verwaltung"]]
14
15 {{figureCaption}}
16 Arbeitsbereich zur Microservice-Verwaltung
17 {{/figureCaption}}
18 {{/figure}}
19
20 Bedienen lässt sich der Microservice-Arbeitsbereich über die Buttons in der Ribbonleiste oder das Kontextmenü. Folgende Funktionen stehen Ihnen zur Auswahl:
21
22 |**Button**|**Funktionen**
23 |Importieren|Öffnet das Dialogfenster zur Auswahl einer Microservice-Paketdatei aus dem Datei-Verzeichnis.
24 |Handbuch|Öffnet die Webseite [[https:~~/~~/doc.aagon.com/bin/view/AESB>>https://doc.aagon.com/bin/view/AESB]] im Standard-Browser.
25
26 = Microservice-Pakete und -Vorlagen verwalten =
27
28 In der Liste der Microservice-Pakete und -Vorlagen sehen Sie alle verfügbaren Microservice-Pakete, Microservice-Vorlagen und Microservice-Instanzen, die Sie verwalten können. Die Verwaltung ist über die Ribbonleiste oder das Kontextmenü möglich. Folgende Funktionen stehen Ihnen zur Auswahl:
29
30 |**Funktion**|**Bedeutung**
31 |Löschen (Microservice-Paket)|Löscht das ausgewählte Microservice-Paket und bei Bedarf ebenfalls die Paket-Benutzer (Auswahl in Dialogfenster).
32 |Hinzufügen (Microservice-Instanz)|Öffnet das Dialogfenster zum Erstellen einer neuen Microservice-Instanz.
33 |Bearbeiten (Microservice-Vorlage)|Startet den Bearbeitungsmodus zur Anpassung der verschiedenen Einstellungen für die Microservice-Vorlage.
34 |Löschen (Microservice-Vorlage)|Löscht die ausgewählte Microservice-Vorlage.
35 |Duplizieren (Microservice-Vorlage)|Erstellt eine Kopie der ausgewählten Microservice-Vorlage.
36 |Exportieren (Microservice-Vorlage)|Öffnet das Datei-Verzeichnis zur Auswahl des Ordners, in den die Microservice-Vorlage als XML-Datei exportiert werden soll.
37 |Importieren (Microservice-Vorlage)|Öffnet das Datei-Verzeichnis zur Auswahl der XML-Datei, die importiert werden soll.
38 |Migrieren (Microservice-Vorlage)|Migriert die ausgewählte Microservice-Vorlage in eine höhere Version (sofern mehrere Versionen installiert sind).
39 |Speichern (Microservice-Vorlage Änderung)|Speichert die Änderungen an der Microservice-Vorlage und beendet den Bearbeitungsmodus.
40 |Verwerfen (Microservice-Vorlage Änderung)|Verwirft die Änderungen an der Microservice-Vorlage und beendet den Bearbeitungsmodus
41
42 = Eine Microservice-Instanz aus einer Microservice-Vorlage erstellen =
43
44 Für die Erstellung einer Microservice-Instanz gibt es mehrere Möglichkeiten:
45
46 * __**EMPFOHLEN:**__ Ziehen Sie die Microservice-Vorlage, die als Konfigurationsvorlage für die Microservice-Instanz verwendet werden soll, per Drag-and-Drop zu dem Supervisor, von dem die Microservice-Instanz gesteuert werden soll.
47 * Wählen Sie aus dem Microservice-Pakete-Repository die Microservice-Vorlage aus, die als Konfigurationsvorlage für die Microservice-Instanz verwendet werden soll und klicken Sie in der Ribbonleiste im Abschnitt //Microservice-Instanz// auf den Button //Hinzufügen.//
48 * Wählen Sie aus der Liste der Supervisoren den Supervisor aus, der die Microservice-Instanz steuern soll und klicken Sie in der Ribbonleiste im Abschnitt //Microservice-Instanz// auf den Button //Hinzufügen.//
49
50 Nun öffnet sich das Dialogfenster zum Erstellen einer neuen Microservice-Instanz. Geben Sie im nächsten Schritt in den Feldern die benötigten Angaben für die Microservice-Instanz an.
51
52 {{aagon.infobox}}
53 Abhängig davon, welche der genannten Möglichkeiten Sie gewählt haben, sind die Angaben zum Host und der Vorlage zur Erstellung der Microservice-Instanz bereits vorhanden.
54 {{/aagon.infobox}}
55
56 {{figure}}
57 (% style="text-align:center" %)
58 [[image:MS-Instanzen_Erstellen.png||alt="Microservice-Instanz erstellen"]]
59
60 {{figureCaption}}
61 Microservice-Instanz erstellen
62 {{/figureCaption}}
63 {{/figure}}
64
65 |=**Feld**|=**Benötigte Angabe**
66 |Host|Microservice-Supervisor, der die Microservice-Instanz steuern soll.
67 |Vorlage|Konfigurationsvorlage, deren Einstellungen für die Microservice-Instanz verwendet werden sollen.
68 |Name der Instanz|Frei wählbarer Name, mit dem die Microservice-Instanz in der Liste angezeigt wird.
69 |Starttyp|Die Einstellung bestimmt, ob die Microservice-Instanz bei einem Supervisor- oder System-Neustart A//utomatisch// auch neustartet oder //Manuell //gestartet werden muss.
70 |Nach dem Speichern starten|Die Checkbox bestimmt, ob die Microservice-Instanz nach dem Speichern und Erstellen direkt gestartet werden soll oder nicht (nur möglich, wenn Supervisor auch gestartet ist).
71
72 = Supervisoren und Microservice-Instanzen steuern =
73
74 In der Liste der Supervisoren und Microservice-Instanzen werden Ihnen alle vorhandenen Supervisoren und Microservice-Instanzen angezeigt, die Sie steuern können.
75
76 {{figure}}
77 (% style="text-align:center" %)
78 [[image:MS-Instanzen_Microservice_Workspace.png||alt="Microservice-Instanzen steuern"]]
79
80 {{figureCaption}}
81 Microservice-Instanzen steuern
82 {{/figureCaption}}
83 {{/figure}}
84
85 == Supervisor steuern ==
86
87 Die Steuerung ist über die Ribbonleiste oder das Kontextmenü möglich. Folgende Funktionen stehen Ihnen zur Auswahl:
88
89 |**Funktion**|**Bedeutung**
90 |Starten (Alle Microservice-Instanzen)|Startet alle nicht aktiven Microservice-Instanzen, die dem Supervisor untergeordnet sind.
91 |Stoppen (Alle Microservice-Instanzen)|Stoppt alle aktiven Microservice-Instanzen, die dem Supervisor untergeordnet sind.
92 |Neustarten (Alle Microservice-Instanzen)|Beendet alle Microservice-Instanzen, die dem Supervisor untergeordnet sind und startet sie anschließend neu.
93 |Beenden (Alle Microservice-Instanzen)|Beendet alle Microservice-Instanzen, die dem Supervisor untergeordnet sind.
94 |Hinzufügen (Microservice-Instanz)|Öffnet das Dialogfenster zum Erstellen einer neuen Microservice-Instanz.
95 |Löschen (Supervisor)|Löscht den ausgewählten Supervisor (nur möglich, wenn dem Supervisor keine Microservice-Instanzen untergeordnet sind).
96 |Neustarten (Supervisor)|Stoppt den ausgewählten Supervisor und startet ihn mit den ihm untergeordneten Service-Instanzen neu.
97 |Aktiviere Logging (Supervisor)|Aktiviert das Logging für den Supervisor, um Ereignisse im SmartInspect-Protokoll anzeigen zu lassen.
98
99 == Microservice-Instanz steuern ==
100
101 Bei Auswahl einer Microservice-Instanz stehen Ihnen folgende Funktionen zur Verfügung:
102
103 |**Funktion**|**Bedeutung**
104 |Starten|Startet die ausgewählte Microservice-Instanz, falls sie derzeit nicht aktiv ist. Ihr neuer Dienststatus ist anschließend „Gestartet“.
105 |Stoppen|Stoppt die ausgewählte Microservice-Instanz, ihr neuer Dienststatus ist anschließend „Stoppt“.
106 |Neustarten|Stoppt die ausgewählte Microservice-Instanz und startet sie anschließend neu.
107 |Beenden|Beendet die ausgewählte Microservice-Instanz, ihr neuer Dienststatus ist anschließend „Gestoppt“.
108 |Bearbeiten|Startet den Bearbeitungsmodus zur Anpassung der verschiedenen Einstellungen für die Microservice-Instanz.
109 |Löschen|Löscht die ausgewählte Microservice-Instanz.
110 |Verschieben|Verschiebt die markierte Microservice-Instanz zu einem anderen Microservice-Supervisor (muss bereits vorhanden sein).
111 |Migrieren|Migriert die ausgewählte Microservice-Instanz in eine höhere Version (sofern mehrere Versionen installiert sind).
112 |Aktiviere Logging|Aktiviert das Logging für die ausgewählte Microservice-Instanz, um Ereignisse im SmartInspect-Protokoll anzeigen zu lassen.
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community