UiPath DevOps-Skripte

Versionshinweise

Erscheinungsdatum 24.04.2024

• Testen mit der aktuellsten UiPath-CLI (Version 23.10.8753.32995)
• Der Benutzer kann eine bestimmte CLI-Version angeben, die automatisch von der UiPath-CLI heruntergeladen werden soll
• Unterstützung für neue Parameter in UiPathRunTest hinzufügen
• Fehlerbehebungen

Erscheinungsdatum 13.02.2023

• Die Skripte wurden aktualisiert, um die offizielle UiPath-CLI zu verwenden
• Fügen Sie für selbstgehostete Agenten einen Parameter hinzu, um den Pfad der UiPath-CLI anzugeben, sofern diese auf dem Computer verfügbar ist, anstatt das Skript automatisch herunterzuladen

UiPath DevOps-Skripte?

Verpacken, bereitstellen, Automatisierungen ausführen, Tests durchführen, Assets verwalten und Automatisierungsprojekte analysieren.
Youtube-Video Das Video wurde bei der ersten Veröffentlichung der Bibliothek erstellt und enthält daher keine nachträglich hinzugefügten Funktionen.

Überblick

Immer mehr Kunden fordern Integrationen der uipath-Plattform in andere Plattformen wie GitLab und Circle CI, und UiPath ist nicht in der Lage, für alle native Plugins zu erstellen.

Diese inoffizielle Bibliothek von DevOps PowerShell-Skripten unterstützt Kunden dabei, die Interaktion mit der offiziellen UiPath-CLI zu erleichtern, um CI/CD in ihre Arbeitsabläufe zu integrieren und ihnen das Paketieren, Bereitstellen und Ausführen von Automatisierungen und Tests zu ermöglichen.

Voraussetzung:

• Die bereitgestellte VM oder der bereitgestellte Agent sollte eine Windows-Maschine sein
• Fügen Sie Ihrer CI/CD-Pipeline einen Schritt hinzu, um die gewünschten Skripte herunterzuladen. (Laden Sie nur die Skripte herunter, die Sie benötigen. Wenn Sie beispielsweise ein RPA-Projekt packen möchten, laden Sie dann das UiPathPack-Skript herunter.) Verwenden Sie die folgenden Skripte als einen Schritt in Ihrer Pipeline und geben Sie einen beliebigen Namen ein (z. B. „Umgebung wird vorbereitet“).

Es wird empfohlen, eine Kopie der Skripte aus dem Skriptordner in Ihr eigenes Repository herunterzuladen

 # Create scripts folder under C drive. (you can change the directory path )
New-Item - Path " C:\ " - ItemType " directory " - Name " scripts " ;
Invoke-WebRequest " https://github.com/UiPath-Services/UiPath-DevOps-Scripts/raw/main/scripts/UiPathPack.ps1 " - OutFile " C:\scripts\UiPathPack.ps1 " ;
Invoke-WebRequest " https://github.com/UiPath-Services/UiPath-DevOps-Scripts/raw/main/scripts/UiPathDeploy.ps1 " - OutFile " C:\scripts\UiPathDeploy.ps1 " ;
Invoke-WebRequest " https://github.com/UiPath-Services/UiPath-DevOps-Scripts/raw/main/scripts/UiPathJobRun.ps1 " - OutFile " C:\scripts\UiPathJobRun.ps1 " ;
Invoke-WebRequest " https://github.com/UiPath-Services/UiPath-DevOps-Scripts/raw/main/scripts/UiPathRunTest.ps1 " - OutFile " C:\scripts\UiPathRunTest.ps1 " ;
Invoke-WebRequest " https://github.com/UiPath-Services/UiPath-DevOps-Scripts/raw/main/scripts/UiPathManageAssets.ps1 " - OutFile " C:\scripts\UiPathManageAssets.ps1 " ;
Invoke-WebRequest " https://github.com/UiPath-Services/UiPath-DevOps-Scripts/raw/main/scripts/UiPathAnalyzeProject.ps1 " - OutFile " C:\scripts\UiPathAnalyzeProject.ps1 " ;
Invoke-WebRequest " https://github.com/UiPath-Services/UiPath-DevOps-Scripts/raw/main/scripts/UiPathCLIGeneric.ps1 " - OutFile " C:\scripts\UiPathCLIGeneric.ps1 " ;

Sie können kein Verzeichnis außerhalb Ihres CI/CD-privilisierten Rechners erstellen?

Einige CI/CD-Tools wie Gitlab erlauben möglicherweise nicht die Erstellung von Ordnern außerhalb des Build-/Arbeitsverzeichnisses. Dazu müssen Sie den Ordner und die Skripte im Arbeitsverzeichnis ablegen. Im obigen Skript müssen Sie „C:\“ durch die CI/CD-Toolvariable ersetzen, die auf das Arbeitsverzeichnis verweist.
Zum Beispiel,
GitLab $env:CI_PROJECT_DIR
GitHub-Aktionen: ${{github.workspace}}
..usw

Powershell-Skripte

Es können fünf verfügbare Skripte verwendet werden

Skript	Beschreibung
UiPathPack	Packen Sie ein oder mehrere Projekte in ein Paket. Klicken Sie auf den Namen für eine detaillierte Dokumentation
UiPathDeploy	Stellen Sie Pakete auf einer Orchestrator-Instanz bereit und veröffentlichen Sie sie optional in einer Reihe von Umgebungen. Klicken Sie auf den Namen für eine detaillierte Dokumentation
UiPathJobRun	Lösen Sie einen Auftrag auf Orchestrator aus. Klicken Sie auf den Namen für eine detaillierte Dokumentation
UiPathRunTest	Testet ein bestimmtes Paket oder führt einen Testsatz aus. Klicken Sie auf den Namen für eine detaillierte Dokumentation
UiPathManageAssets	Verwalten Sie Uipath-Orchestrator-Assets.
UiPathAnalyzeProject	Überprüfen Sie Projekte auf Verstöße gegen den Workflow-Analysator
UiPathCLIGeneric	Dieses Skript ist für diejenigen gedacht, die wissen, wie man mit uipcli.exe arbeitet und die CLI direkt aufrufen möchten. Dieses Skript übergibt die bereitgestellten Parameter unverändert direkt an uipcli.exe.

---

PipleLines-Beispiele im Video

CircleCI-Beispiel
GitLab-Beispiel

Protokollierung

Jedes Skript protokolliert alle Ausgaben in seiner eigenen *.log Datei und manchmal auch in der Konsole.

Abhängigkeit

The scripts will automatically download the UiPath.CLI during the runtime.

• Offizielle UiPath-CLI
• Voraussetzungen für die UiPath-CLI: .NET 6.0.7, das .NET 6.0.7 Desktop Runtime enthalten muss, das mit dem 6.0.302 SDK geliefert wird.