Routing von zugehörigen API-Aufrufen in Cluster-Umgebungen
Zur Verbesserung der Leistung und Zuverlässigkeit können Sie mehrere ClaimCenter-Server in einer Konfiguration installieren, die als Cluster bezeichnet wird. In einem ClaimCenter-Cluster werden Clientverbindungen auf mehrere ClaimCenter-Server verteilt, sodass die Last auf den einzelnen Servern verringert wird. Wenn bei einem Server Fehler auftreten, wird der zugehörige Datenverkehr nahtlos auf den anderen Servern verarbeitet. Weitere Informationen können Sie dem Administrationshandbuch entnehmen.
Wenn ClaimCenter in einem Cluster ausgeführt wird, können zugehörige System-API-Aufrufe an verschiedene Knoten weitergeleitet werden. Dies kann zu Problemen führen, z. B. Ausnahmen aufgrund gleichzeitiger Datenänderung. In der Regel müssen mehrere zugehörige System-API-Aufrufe an denselben Knoten weitergeleitet werden.
Es gibt zwei Möglichkeiten sicherzustellen, dass eine Reihe von zugehörigen System-API-Aufrufen an dieselbe Instanz weitergeleitet werden: Sitzungs-IDs (das Standardverhalten) und Cookies.
Verwenden von Sitzungs-IDs
Im Kontext von System-API-Aufrufen in einer Cluster-Umgebung ist eine Sitzungs-ID eine beliebige Zeichenfolge, die von der aufrufenden Anwendung generiert wird, um zugehörige API-Aufrufe zu identifizieren. Die ID wird im Header jeder Anforderung übergeben. Jede Anforderung, die eine bestimmte Sitzungs-ID verwendet, wird an denselben Knoten im Cluster weitergeleitet. Der Headerschlüssel für eine Sitzungs-ID lautet x-gwre-session.
Beispiel: Angenommen, eine aufrufende Anwendung ruft den Cluster ClaimCenter wie folgt auf:
- Ein POST zum Erstellen einer Aktivität.
- Ein PATCH zum Aktualisieren der Aktivität.
- Ein POST zum Erstellen einer Notiz zu der Aktivität.
Alle drei Aufrufe enthalten den folgenden Header:
Da alle drei Aufrufe dieselbe Sitzungs-ID angeben, werden alle drei Aufrufe an denselben Knoten weitergeleitet.
Sitzungs-IDs sind das Standardverhalten der Guidewire Cloud-Plattform. Wenn Sie diese Option verwenden möchten, müssen Sie keine spezielle Anforderung an Guidewire Cloud Operations stellen.
Verwenden von Cookies
Im Kontext von System-API-Aufrufen in einer Cluster-Umgebung ist ein Cookie eine von der Guidewire Cloud Platform generierte beliebige Zeichenfolge, die zur Identifizierung nachfolgender verwandter API-Aufrufe verwendet werden kann.
Wenn ein Anforderungsheader keinen x-gwre-session-Headerschlüssel enthält, generiert die Guidewire Cloud Platform ein Cookie und gibt es im Antwortheader mit einem Set-Cookie-Headerschlüssel zurück. Nachfolgende Aufrufe können dieses Cookie mithilfe des Cookie-Headerschlüssels in den Anforderungsheader aufnehmen. Jede Anforderung, die ein bestimmtes Cookie verwendet, wird an denselben Knoten im Cluster weitergeleitet, der das Cookie generiert hat.
Beispiel: Angenommen, eine aufrufende Anwendung ruft den Cluster ClaimCenter wie folgt auf:
- POST zum Erstellen einer Aktivität
- Der Anforderungsheader enthält keinen
x-gwre-session-Headerschlüssel. - Der Antwortheader enthält Folgendes:
Set-Cookie: gwre=ccd37ca0-f8d3-4a8e-b278-83274d82b355; Path=/
- Der Anforderungsheader enthält keinen
- Ein PATCH zum Aktualisieren der Aktivität.
- Der Anforderungsheader enthält Folgendes:
Cookie: gwre=ccd37ca0-f8d3-4a8e-b278-83274d82b355
- Der Anforderungsheader enthält Folgendes:
- POST zum Erstellen einer Notiz zur Aktivität
- Der Anforderungsheader enthält Folgendes:
Cookie: gwre=ccd37ca0-f8d3-4a8e-b278-83274d82b355
- Der Anforderungsheader enthält Folgendes:
Da der zweite und dritte Aufruf das vom ersten Aufruf zurückgegebene Cookie angeben, werden der zweite und dritte Aufruf an denselben Knoten weitergeleitet, der den ersten Aufruf verarbeitet hat.
Cookies sind nicht das Standardverhalten der Guidewire Cloud-Plattform. Wenn Sie diese Option verwenden möchten, müssen Sie sie bei Guidewire Cloud Operations anfordern.
Vergleich zwischen Sitzungs-IDs und Cookies
In den meisten Fällen kann es einfacher sein, Sitzungs-IDs zu verwenden.
- Sitzungs-IDs werden von der aufrufenden Anwendung generiert.
- Sitzungs-IDs erfordern nicht, dass die aufrufende Anwendung Informationen in einem Antwortheader identifiziert und den Speicher dann für die spätere Verwendung verwaltet.
- Sitzungs-IDs sind das Standardverhalten für die Guidewire Cloud-Plattform.
Wenn Sie Cookies verwenden möchten, müssen Sie dies bei Guidewire Cloud Operations anfordern.