Microservices

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

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

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

12

(% style="text-align:center" %)

13

[[image:Übersicht_Microservice_Workspace.png||alt="Arbeitsbereich zur Microservice-Verwaltung"]]

14

15

16

Arbeitsbereich zur Microservice-Verwaltung

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

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.

(% style="text-align:center" %)

58

[[image:MS-Instanzen_Erstellen.png||alt="Microservice-Instanz erstellen"]]

59

60

61

Microservice-Instanz erstellen

|=**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

77

(% style="text-align:center" %)

78

[[image:MS-Instanzen_Microservice_Workspace.png||alt="Microservice-Instanzen steuern"]]

79

80

81

Microservice-Instanzen steuern

== 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.

Wiki-Quellcode von Microservices

Navigation

author	version	line-number	content
		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.