- Überblick
- UiPath-CLI
- Über UiPath-CLI
- Herunterladen der UiPath-CLI
- Kompatibilitätsmatrix
- Ausführen der UiPath-CLI
- Verwalten von NuGet-Feeds
- Test Manager-Support
- Packen von Projekten in ein Paket
- Signieren von Projektpaketen
- Analysieren eines Projekts
- Bereitstellen eines Pakets im Orchestrator
- Ausführen eines Auftrags im Orchestrator
- Testen eines Pakets oder Ausführen eines Testsatzes
- Testen mehrerer Pakete
- Bereitstellen von Assets im Orchestrator
- Löschen von Assets aus dem Orchestrator
- Ausführen von Aufgaben mithilfe der JSON-Konfiguration
- Wiederherstellen von Automatisierungsabhängigkeiten
- Überblick
- Wiederherstellen und Analysieren von Lösungen
- Eine Lösung wird gepackt
- Signieren von Lösungspaketen
- Hochladen und Löschen von Lösungspaketen
- Herunterladen von Lösungspaketen und Konfigurationen
- Bereitstellen und Aktivieren von Lösungen
- Deinstallieren von Bereitstellungen
- Authentifizierung und Scopes
- Fehlerbehebung bei der UiPath-CLI
- Azure DevOps-Erweiterung
- Jenkins-Plugin

Benutzerhandbuch zu CI/CD-Integrationen
Hochladen und Löschen von Lösungspaketen
Nach dem Packen einer Lösung können Sie das Paket im Orchestrator zu Lösungen hochladen. Sie können Pakete auch löschen, wenn sie nicht mehr benötigt werden.
Paket wird hochgeladen
Der Befehl upload-package verschiebt eine Lösungsdatei .zip zu Lösungen.
Befehlssyntax
uipcli solution upload-package <package-path> [options]uipcli solution upload-package <package-path> [options]Parameter:
| Parameter | Beschreibung | Erforderlich |
|---|---|---|
<package-path> | Pfad zur .zip -Paketdatei | Ja |
-U | Orchestrator-URL | Ja |
-T | Name des Mandanten | Ja |
-A | Name der Organisation | Ja |
-I | Externe App-ID | Ja |
-S | Externer App-Schlüssel | Ja |
--applicationScope | Optionale Scopes (Standardwerte angewendet) | Nein |
--traceLevel | Protokollierungsstufe | Nein |
Authentication
Siehe Authentifizierung und Scopes für erforderliche Scopes und Einrichtung einer externen App.
Beispiel
uipcli solution upload-package C:\Output\MySolution.1.2.3.zip \ -U https://cloud.uipath.com/ \ -T DefaultTenant \ -A myorg \ -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ -S **** \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel Informationuipcli solution upload-package C:\Output\MySolution.1.2.3.zip \ -U https://cloud.uipath.com/ \ -T DefaultTenant \ -A myorg \ -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ -S **** \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel InformationVerwenden von CI/CD-Geheimnissen
Codieren Sie niemals Anmeldeinformationen in Skripten hart. Verwenden Sie die Geheimnisverwaltung Ihrer Plattform:
Azure DevOps:
- script: | uipcli solution upload-package $(Build.ArtifactStagingDirectory)\MySolution.$(Build.BuildId).zip \ -U $(orchestratorUrl) \ -T $(orchestratorTenant) \ -A $(organizationName) \ -I $(externalAppId) \ -S $(externalAppSecret) \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel Information displayName: 'Upload Solution Package'- script: | uipcli solution upload-package $(Build.ArtifactStagingDirectory)\MySolution.$(Build.BuildId).zip \ -U $(orchestratorUrl) \ -T $(orchestratorTenant) \ -A $(organizationName) \ -I $(externalAppId) \ -S $(externalAppSecret) \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel Information displayName: 'Upload Solution Package'GitHub-Aktionen:
- name: Upload Solution Package run: | uipcli solution upload-package ${{ runner.temp }}/packages/MySolution.${{ github.run_number }}.zip \ -U ${{ secrets.ORCHESTRATOR_URL }} \ -T ${{ secrets.ORCHESTRATOR_TENANT }} \ -A ${{ secrets.ORG_NAME }} \ -I ${{ secrets.EXTERNAL_APP_ID }} \ -S ${{ secrets.EXTERNAL_APP_SECRET }} \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel Information- name: Upload Solution Package run: | uipcli solution upload-package ${{ runner.temp }}/packages/MySolution.${{ github.run_number }}.zip \ -U ${{ secrets.ORCHESTRATOR_URL }} \ -T ${{ secrets.ORCHESTRATOR_TENANT }} \ -A ${{ secrets.ORG_NAME }} \ -I ${{ secrets.EXTERNAL_APP_ID }} \ -S ${{ secrets.EXTERNAL_APP_SECRET }} \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel InformationWas passiert nach dem Upload
Nach dem Hochladen:
- Wird in Lösungen im Orchestrator angezeigt.
- Kann in jedem Zielordner bereitgestellt werden.
- Ist versioniert und nachverfolgt.
- Kann von anderen Pipelines oder Benutzern heruntergeladen werden.
Deleting a package
Der Befehl delete-package entfernt ein Lösungspaket aus Lösungen.
Befehlssyntax
uipcli solution delete-package <package-name> [options]uipcli solution delete-package <package-name> [options]Parameter:
| Parameter | Beschreibung | Erforderlich |
|---|---|---|
<package-name> | Name des Pakets ( ohne .zip -Erweiterung) | Ja |
-v oder --version | Zu löschende Versionsnummer | Ja |
-U | Orchestrator-URL | Ja |
-T | Name des Mandanten | Ja |
-A | Name der Organisation | Ja |
-I | Externe App-ID | Ja |
-S | Externer App-Schlüssel | Ja |
--applicationScope | Optionale Scopes (Standardwerte angewendet) | Nein |
--traceLevel | Protokollierungsstufe | Nein |
Wenn Sie die Authentifizierung einer externen Anwendung verwenden, ohne den Parameter --applicationScope anzugeben, wendet die CLI automatisch diese standardmäßigen AutomationSolution-Scopes an:
Solutions.Packages Solutions.Deployments OR.Execution
Authentication
Siehe Authentifizierung und Scopes für erforderliche Scopes und Einrichtung einer externen App.
Beispiel
uipcli solution delete-package MySolution \ -v 1.2.3 \ -U https://cloud.uipath.com/ \ -T DefaultTenant \ -A myorg \ -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ -S **** \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel Informationuipcli solution delete-package MySolution \ -v 1.2.3 \ -U https://cloud.uipath.com/ \ -T DefaultTenant \ -A myorg \ -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ -S **** \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \ --traceLevel InformationWann Pakete gelöscht werden sollen
Gängige Szenarien zum Löschen von Paketen:
- Bereinigungspipelines – Entfernen Sie alte Versionen nach der erfolgreichen Bereitstellung.
- Fehlgeschlagene Builds – Löschen Sie ungültige Pakete, die nicht bereitgestellt werden sollen.
- Aufbewahrungsrichtlinien – Erzwingen von Paketlebenszyklusregeln (z. B. nur die letzten 10 Versionen beibehalten).
- Speicherverwaltung – Geben Sie Speicherplatz in Lösungen frei.
Pipeline-Beispiel – Bereinigung alter Versionen
# Delete old version after deploying new oneuipcli solution delete-package MySolution \ -v 1.2.2 \ -U https://cloud.uipath.com/ \ -T DefaultTenant \ -A myorg \ -I $(externalAppId) \ -S $(externalAppSecret) \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"# Delete old version after deploying new oneuipcli solution delete-package MySolution \ -v 1.2.2 \ -U https://cloud.uipath.com/ \ -T DefaultTenant \ -A myorg \ -I $(externalAppId) \ -S $(externalAppSecret) \ --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"Paketbenennung
Der Paketname, der bei Upload- und Löschvorgängen verwendet wird, wird vom Lösungsnamen und nicht vom Dateinamen abgeleitet.
Beispiel:
- Packbefehl erstellt:
MySolution.1.2.3.zip - Paketname zum Löschen:
MySolution - Version:
1.2.3
Nächste Schritte
Nach dem Hochladen eines Pakets können Sie: