Auslösen von Silk Central von einem CI-Server aus

Dieser Abschnitt beschreibt, wie Sie Silk Central besser in Ihre Continuous-Integration-Prozesse (CI-Prozesse) integrieren können, indem Sie von Ihrem CI-Server aus Ausführungen auf Silk Central mit einem Gradle-Skript auslösen.

Außerdem wird in diesem Abschnitt beschrieben, wie Sie Ergebnisse aus Silk Central abrufen und in Ihrem Build-Prozess verwenden können.

Um von einem CI-Server aus Ausführungen auf Silk Central auszulösen und die Ausführungsergebnisse aus Silk Central aufzubereiten, müssen Sie ein Gradle-Skript mit den entsprechenden Befehlen zu Ihrer Versionsverwaltung hinzufügen. Sie können die Datei silkcentral.gradle auf der Benutzeroberfläche von Silk Central herunterladen. Navigieren Sie zu Hilfe > Tools und klicken Sie auf Gradle-Skript für die CI-Server-Integration.

Sie können die folgenden Eigenschaften im Gradle-Skript konfigurieren:
Eigenschaft Beschreibung
sc_executionNodeIds Die kommagetrennte Liste der zu startenden Testsuiten. Diese Liste sollte keine Ordner enthalten. Beispiel: 22431,22432,22433.
sc_host Der Silk Central-Host. Beispiel: http://[sc_server_name]:19120.
sc_token Das Webdienst-Token für die Benutzerauthentifizierung. Sie können das Webdienst-Token auf der Einstellungsseite der Silk Central-Benutzeroberfläche generieren. Um auf diese Seite zuzugreifen, zeigen Sie mit dem Mauszeiger auf den Benutzernamen im Menü Silk Central und wählen Sie Benutzereinstellungen. Beispiel: 80827e02-cfda-4d2d-b0aa-2d5205eb6eq9.
sc_sourceControlBranch Optional: Geben Sie diese Eigenschaft an, um einen bestimmten Branch auszuchecken. Wenn kein Branch angegeben ist, wird die Einstellung der Testsuite verwendet.
sc_ buildName Optional: Der Build für den Lauf. Wenn kein Build angegeben ist, wird die Einstellung der Testsuite verwendet. Sie können diese Eigenschaft nur für Ausführungsplanknoten, nicht für Ordner, festlegen.
sc_StartOption Optional: Die Tests, die ausgeführt werden sollen. Wird dies nicht angegeben, werden alle zugeordneten Tests ausgeführt. Die zulässigen Werte sind:
  • KOPIEREN
  • FEHLGESCHLAGEN
  • NOT_EXECUTED
  • NOT_EXECUTED_SINCE_BUILD
  • FAILED_NOTEXECUTED_SINCE_BUILD
  • HAVING_FIXED_ISSUES
Der Standardwert lautet "ALL".
sc_sinceBuild Optional: Der Name des Builds, seit dem keine Tests mehr durchgeführt wurden. Geben Sie diese Eigenschaft an, wenn die Eigenschaft sc_StartOption auf "FAILED_NOTEXECUTED_SINCE_BUILD" oder "NOT_EXECUTED_SINCE_BUILD" gesetzt ist.
sc_collectResults Optional: Bei dem Wert "true" wartet das Skript, bis die Ausführung von Silk Central beendet ist, und schreibt die Ergebnisdateien im JUnit-Format. Bei dem Wert "false" löst das Skript die Ausführung aus und beendet den Vorgang, ohne auf die Ergebnisse zu warten. Die Dateien werden im Unterordner sc_results gespeichert. Der Standardwert lautet "true". Boolean.
sc_collectResultFiles Optional: Wenn diese Eigenschaft "true" und sc_collectResults "true" ist, lädt das Skript die von den Tests erzeugten Ergebnisdateien herunter. Die Dateien werden im Unterordner sc_results gespeichert. Der Standardwert lautet "false". Boolean.
sc_startDelay Optional: Die Startverzögerung in Sekunden. Kann angegeben werden, wenn Sie mehr als eine Testsuite ausführen möchten. Die Testsuiten werden sequentiell mit der angegebenen Startverzögerung gestartet. Dies kann hilfreich sein, wenn Sie die Arbeitslast für die Testumgebung beim Start minimieren müssen, z. B. beim Starten einer virtuellen Maschine oder bei der Installation der zu testenden Anwendung. Der Standardwert lautet 0.

Sie können die Eigenschaften entweder direkt im Skript angeben oder beim Auslösen des Skripts übergeben.

Alle zusätzlich angegebenen Projekteigenschaften werden beim Auslösen des Skripts als Parameter an Silk Central übergeben und für die Ausführung verwendet. Dadurch können Sie die Ausführungen in Silk Central mit Werten vom Build-Server parametrisieren.

Wenn mit dem Build beispielsweise ein Testserver in Docker gestartet wird, können Sie den URL an diesen Server übergeben, indem Sie die Eigenschaft in der Befehlszeile angeben:
-PmyServerUrl=http://docker:1234

Befehlszeilenbeispiel

Mit dem folgenden Befehl wird das Skript aus der Befehlszeile gestartet, indem die Knoten 22431, 22432 und 22433 der Ausführungshierarchie auf "localhost" gestartet werden. Dabei wird das Webdienst-Token "80827e02-cfda-4d2d-b0aa-2d5205eb6ea9" zur Authentifizierung verwendet:
gradle -b silkcentral.gradle
:silkCentralLaunch -Psc_executionNodeIds='22431,22432,22433'
-Psc_host='http://localhost:19120'
-Psc_token='80827e02-cfda-4d2d-b0aa-2d5205eb6ea9'

Spezifische Informationen zum Auslösen von Ausführungen auf Silk Central aus Jenkins finden Sie unter Auslösen von Ausführungen aus Jenkins. Spezifische Informationen zum Auslösen von Ausführungen auf Silk Central aus TeamCity finden Sie unter Auslösen von Ausführungen aus TeamCity.