Zum Hauptinhalt springen

Einrichten Ihrer lokalen Entwicklungsumgebung

In diesem Abschnitt lernen Sie, wie Sie als Entwickler eines Versicherers Ihre lokale Entwicklungsumgebung einrichten. So können Sie mit der Entwicklung Ihrer App beginnen und Ihre Änderungen veröffentlichen.

Note: Sie müssen über Anmeldedaten für Ihren Guidewire Home-Tenant verfügen, bevor Sie Ihre lokale Entwicklungsumgebung einrichten können. Weitere Informationen finden Sie unter Zugriff auf Jutro Web Apps .

Voraussetzungen​

Sie müssen Folgendes installieren, um Ihre Entwicklungsumgebung einzurichten.

  • Node: >=22.6.0 < 23
  • npm: >=10.8.2
  • Git
  • Eine IDE

Folgen Sie den Installationsanweisungen für Ihr Betriebssystem.

Grundlegende Informationen zu NPM-Repositorys​

NPM-Pakete, die für Jutro-Apps benötigt werden, sind in separaten Instanzen des Guidewire Binary Repository gespeichert, die eine Authentifizierung erfordern.

Es sind drei regionale Instanzen verfügbar:

Alle vorkonfigurierten JDP-NPM-Pakete sind in diesen Instanzen im jutro-npm-dev-local-Repository verfügbar.

Beachten Sie, dass unterschiedliche NPM-Bereiche zum Verteilen verschiedener Pakete verwendet werden. Sie werden in Paketnamen-Präfixen angezeigt. Die Hauptbereiche sind:

  • @jutro
  • @digitalsdk

Kundenspezifische Pakete​

Bei der Erstellung von Jutro-Apps können Sie neben den von JDP bereitgestellten Paketen auch solche verwenden, die als kundenspezifische Pakete erstellt wurden und in einem anderen Repository veröffentlicht werden (jutro-{tenantId}-all-npm-remote).

Das virtuelle Repository​

Um die Konfiguration und den Zugriff zu erleichtern, stellt Guidewire ein virtuelles Repository bereit, das als Proxy für diese beiden Repositorys fungiert, sodass alle NPM-Pakete (sowohl JDP als auch kundenspezifisch) darüber verfügbar sind.

Das virtuelle Repository ist jutro-{tenantId}-all-npm-virtual.

Note: Die vollständige URL des virtuellen Repositorys lautet https://{region}.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual

Verwenden Sie dieses Repository, wenn Sie Ihre lokale Umgebung konfigurieren.

Richten Sie das erforderliche Repository in Ihrer NPM-Konfiguration ein​

Wie zuvor erläutert, werden die für Jutro-Apps erforderlichen NPM-Pakete in drei regionalen Guidewire-Binary Repository-Instanzen gespeichert:

Standardmäßig verweist Ihre Jutro-App, die auf JDP ausgeführt wird, bereits auf die Instanz, die der Guidewire Home-Umgebung entspricht, in der sie erstellt wurde.

Während der Konfigurationsschritte für die lokale Entwicklung werden Sie aufgefordert, ein Zugriffstoken für die ausgewählte Instanz abzurufen.

In diesen Schritten wird die AMER-Instanz als Beispiel verwendet.

  1. Melden Sie sich bei https://amer.binrepo.guidewire.net/ mit Ihren SAML SSO-Anmeldedaten an.

  2. Öffnen Sie Ihr Terminal in Ihrem Home-Verzeichnis, führen Sie die nächsten Schritte aus, indem Sie den Wert für {tenantId}ersetzen:

  3. Führen Sie die folgenden Befehle aus, um den Zugriff auf JDP-Artefakte im Bereich @jutro zu konfigurieren:

npm config set @jutro:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@jutro --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
  1. Führen Sie zum Konfigurieren des Zugriffs auf den Bereich @digitalsdk die folgenden Befehle aus:
npm config set @digitalsdk:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@digitalsdk --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
  1. Um den Zugriff auf den Geltungsbereich für kundenspezifische gemeinsam genutzte Pakete zu konfigurieren, führen Sie die folgenden Befehle aus und ersetzen Sie dabei nicht nur {tenantID}, sondern auch {startSystemId}:
npm config set @{tenantId}-{starSystemId}:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@{tenantId}-{starSystemId} --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual

Verwenden von gemeinsam genutzten Paketen​

Details zum Konsumieren von gemeinsam genutzten Paketen finden Sie unter Konsumieren von gemeinsam genutzten Paketen.

Besorgen Sie sich den Quellcode Ihrer App​

Um das App-Repository zu klonen und den Code zu erhalten, müssen Sie ein HTTP-Zugriffstoken erstellen und es als Kennwort verwenden, wenn Sie dazu aufgefordert werden.

  1. Melden Sie sich bei Guidewire Cloud an und navigieren Sie dann zu Ihrer App in Jutro Web Apps.

  2. Klicken Sie auf den Link Quellcode, um zum Bitbucket-Repository zu navigieren.

  3. Klicken Sie in Bitbucket auf Ihren Avatar und dann auf Konto verwalten.

  4. Wählen Sie im Menü auf der linken Seite den Eintrag HTTP-Zugangstoken aus und klicken Sie auf Token erstellen.

  5. Geben Sie einen Namen für das Token ein und setzen Sie die Berechtigungen auf Admin.

  6. Klicken Sie auf Erstellen.

  7. Kopieren und speichern Sie das Token von der nächsten Seite, da Sie es als Kennwort verwenden werden.

  8. Klicken Sie auf Weiter.

  9. Verwenden Sie den CLI-Befehl git clone in einer Terminalinstanz, klonen Sie das Repository und geben Sie das Token an, das Sie zuvor erstellt haben, wenn Sie zur Eingabe eines Kennworts aufgefordert werden.

  10. Sobald das Repository erfolgreich geklont wurde, wechseln Sie in das neue App-Verzeichnis, das Sie erstellt haben, und führen Sie die folgenden Befehle in Ihrer IDE aus:

    npm ci
    npm start

    Ihre App wird jetzt in Ihrem Browser ausgeführt.

Fehlersuche​

Wenn Sie die Schritte aus dem Abschnitt Erforderliches Repository in Ihrer NPM-Konfiguration einrichten ausführen, fügt NPM die Authentifizierung und Konfigurationen in eine .npmrc-Datei in Ihrem Basisverzeichnis ein. Diese Datei enthält die notwendigen Informationen für die Authentifizierung und den Zugriff auf die erforderlichen Repositorys.

Wenn beim Versuch, Pakete zu installieren, Probleme mit der Zugriffssteuerung auftreten, überprüfen Sie Folgendes:

  1. Ihr Benutzer hat Zugriff auf die Guidewire BinRepo-Benutzeroberfläche und kann direkt in einem Browser auf die Repository-URLs zugreifen
  2. Ihre .npmrc-Datei enthält gültige Anmeldeinformationen für die Repositorys und die Region, auf die Sie zugreifen möchten
  3. Sie führen den Installationsbefehl im richtigen Verzeichnis aus, in das NPM geladen werden kann. Suchen Sie die richtige .npmrc-Datei in der Verzeichnisstruktur: https://docs.npmjs.com/cli/v8/configuring-npm/npmrc#files
  4. Ihre package-lock.json-Datei enthält keine Paketverweise von anderen Repositorys in anderen Regionen, bei denen Sie sich nicht authentifiziert haben (z. B. https://apac.binrepo.guidewire.net anstelle von https://amer.binrepo.guidewire.net)
  5. Sie haben versucht, node_modules und package-lock.json zu löschen und mit einer korrekten .npmrc-Dateikonfiguration neu zu installieren, nachdem Sie die oben genannten Schritte ausgeführt haben

Wenn keiner der oben genannten Schritte das Problem löst, müssen Sie ein Ticket öffnen, um weitere Unterstützung zu erhalten.