SeaLights-Integration einrichten

Wenn Sie Tosca mit Tricentis SeaLights integrieren, können Sie Testkosten und -aufwand reduzieren, indem Sie nur relevante Tests für geänderten Code ausführen. Dieses Kapitel erläutert, wie Sie die Integration einrichten:

• Wichtige SeaLights-Konzepte, die Ihnen helfen, Ihre Integrationsaufgaben besser zu verstehen.

• Worauf Sie sich in SeaLights vorbereiten sollten.

• Worauf Sie sich bei Tosca vorbereiten sollten.

• Wie Sie Ihr Tosca-Repository mit Ihrem SeaLights-Mandanten verbinden.

Wichtige Konzepte

Wenn SeaLights für Sie Neuland ist, finden Sie hier einige wichtige Konzepte, die Sie bei Ihren Integrationsaufgaben unterstützen:

Konzept	Beschreibung
SeaLights-Agent	Hintergrundprozess, der Code- und Testabdeckungsdaten während Testdurchläufen sammelt. Er sendet diese Daten an SeaLights. SeaLights stellt Agenten für verschiedene Technologien wie Java und .NET sowie CI-Tools wie Jenkins bereit.
SeaLights	KI-gestützte Software Quality Intelligence-Plattform. SeaLights sammelt Code- und Testabdeckungsdaten von seinen Agenten und analysiert sie. SeaLights weist basierend auf den Ergebnissen Tosca an, welche Tests für einen bestimmten Testdurchlauf übersprungen werden sollen.
SeaLights-Agent-Token	Ein eindeutiger Bezeichner, der einen SeaLights-Agenten bei der SeaLights-Plattform authentifiziert. Es stellt sicher, dass die Agentendaten sicher mit dem richtigen Konto und Projekt verknüpft sind.
Session-ID erstellen	Ein eindeutiger Bezeichner, der die Version Ihrer zu testenden Applikation definiert. Jeder Build verfügt über eine eigene Build-Session-ID, die alle zugehörigen Test- und Abdeckungsdaten gruppiert.
Build-Session-ID-Datei	Eine Datei, die die ID der Build-Session speichert. In der Regel erstellen Sie diese Datei, wenn Sie Ihren SeaLights-Agenten einrichten. Die Build-Session-ID-Datei hilft, die gesammelten Daten mit dem richtigen Build zu verknüpfen, wenn der SeaLights-Agent Informationen an die SeaLights-Plattform sendet.

SeaLights vorbereiten

SeaLights bietet viele Optionen, um das Setup und das Verhalten der Plattform anzupassen. Nähere Informationen finden Sie im SeaLights-Handbuch (wird in einem neuen Reiter geöffnet).

Dieser Abschnitt beschreibt die grundlegenden Schritte zur Vorbereitung von SeaLights für eine Integration mit Tosca:

1. Wenn Sie es noch nicht getan haben, besorgen Sie sich SeaLights (wird in einem neuen Reiter geöffnet).

2. Richten Sie die SeaLights-Agenten wie im SeaLights-Agenten-Handbuch (wird in einem neuen Reiter geöffnet) beschrieben ein.

   Wo Sie Ihre zu testende Applikation hosten, bestimmt, wie viele SeaLights-Agenten und welche zusätzlichen Konfigurationen Sie möglicherweise benötigen. Bitte wählen Sie Ihren Anwendungsfall:

   Ich hoste meine zu testende Applikation zentral.

   Wenn alle Tosca-Rechner, die Tests ausführen, dies mit einer gemeinsamen, zentralen Instanz der Applikation tun, benötigen Sie einen SeaLights-Agenten. Dieser Agent verarbeitet die Daten für die zu testende Applikation zentral.

   Ich habe meine zu testende Applikation auf den Rechnern installiert, auf denen meine Tests laufen.

   Wenn jeder Tosca-Rechner, auf dem Tests ausgeführt werden, über eine eigene lokale Instanz der Applikation verfügt, benötigen Sie einen SeaLights-Agenten pro Instanz. Dieser Agent verarbeitet die Daten für diese Instanz Ihrer zu testenden Applikation.

   Wenn alle Instanzen die gleiche Build-Session-ID haben und Sie Tests auf mehreren Rechnern gleichzeitig ausführen möchten, müssen Sie Systemumgebungsvariablen definieren. Diese Variablen teilen SeaLights mit, über welche Daten jeder Agent verfügt, zu welcher Applikationsinstanz er gehört und an welchen Testrechner er berichten soll.

   Um dies anzugeben, legen Sie eine Variable namens SL_LAB_ID mit einem benutzerdefinierten Wert für jeden SeaLights-Agenten und den entsprechenden Testrechner fest.

   Nehmen wir an, Sie haben drei Rechner, die Ihre Tosca-Tests ausführen:

   • Rechner 1 hat eine eigene lokale Instanz der Applikation.

   • Rechner 2 hat eine eigene lokale Instanz der Applikation.

   • Rechner 3 hat eine eigene lokale Instanz der Applikation.

   In diesem Fall benötigen Sie drei SeaLights-Agenten:  

   • SeaLights-Agent A für die Instanz auf Rechner 1.

   • SeaLights-Agent B für die Instanz auf Rechner 2.

   • SeaLights-Agent C für die Instanz auf Rechner 3.

   Wenn alle Instanzen Ihrer Applikation die gleiche Build-Session-ID haben und Sie Tests gleichzeitig ausführen möchten, müssen Sie die Variable SL_LAB_ID festlegen:

   • SL_LAB_ID mit <Wert x> für SeaLights-Agent A und Testrechner 1.

   • SL_LAB_ID mit <Wert x> für SeaLights-Agent B und Testrechner 2.

   • SL_LAB_ID mit <Wert x> für SeaLights-Agent C und Testrechner 3.

3. Notieren Sie sich den Pfad zur Build-Session-ID-Datei. Ihr Team benötigt ihn zum Aktivieren der SeaLights-Optimierung für bestimmte Tests.

4. Erstellen Sie ein SeaLights-Agent-Token wie im SeaLights-Token-Handbuch (wird in einem neuen Reiter geöffnet) beschrieben. Sie benötigen es, um Tosca und SeaLights zu verbinden.

Tosca vorbereiten

Die Integration von Tosca und SeaLights folgt einem Cloud-First-Ansatz. Zur Optimierung von Tests mit SeaLights müssen Sie diese über die Tosca Cloud-Testausführungsintegration ausführen. Wenn Sie die Einrichtung der Integration noch nicht durchgeführt haben, tun Sie dies jetzt.

Natürlich können Sie Debugging-Tests, die Sie über eine Ausführungsliste auf einem lokalen Rechner ausführen, jederzeit optimieren. In diesem Fall müssen Sie nichts vorbereiten.

Tosca und SeaLights verbinden

Zu guter Letzt verbinden Sie Ihr Tosca-Repository mit SeaLights.

Bevor Sie beginnen

Um eine Verbindung zu Ihrem SeaLights-Mandanten herzustellen, muss Folgendes vorhanden sein:  

• Ein Administratorkonto für Tosca.

• Das SeaLights-Agent-Token, das Sie bei der Vorbereitung von SeaLights erstellt haben.

Verbindung herstellen

Um die Verbindung zwischen Tosca und SeaLights herzustellen, führen Sie diese Schritte aus:

1. Öffnen Sie in einen Arbeitsbereich in Tosca, der zu dem Repository gehört, das Sie verbinden möchten.

2. Klicken Sie mit der rechten Maustaste auf das Projektwurzelelement und wählen Sie im Kontextmenü die Option Connect to SeaLights aus.

3. Geben Sie Ihr SeaLights-Agent-Token ein und wählen Sie Connect aus.

Sie können mehrere Repositorys mit demselben SeaLights-Mandanten verbinden. Wiederholen Sie diesen Vorgang, um weitere Repositorys zu verbinden.

Wie geht es weiter?

Die Integration ist abgeschlossen. Prima! Jetzt kann Ihr Team Testdurchläufe mit SeaLights optimieren.