cicd-integrations
2024.10
false
Benutzerhandbuch zu CI/CD-Integrationen
- Überblick
- UiPath-CLI
- Über UiPath-CLI
- Herunterladen der UiPath-CLI
- Kompatibilitätsmatrix
- Ausführen der UiPath-CLI
- Verwalten von NuGet-Feeds
- Über UiPath CLI-Aufgaben
- Packen von Projekten in ein Paket
- Analysieren eines Projekts
- Bereitstellen eines Pakets im Orchestrator
- Ausführen eines Auftrags im Orchestrator
- Testen eines Pakets oder Ausführen eines Testsatzes
- Testen eines Pakets oder Ausführen eines Testsatzes im Test Manager
- Testen mehrerer Pakete
- Eingabeparameter JSON-Format
- Bereitstellen von Assets im Orchestrator
- Löschen von Assets aus dem Orchestrator
- Ausführen von Aufgaben mithilfe der JSON-Konfiguration
- Wiederherstellen von Automatisierungsabhängigkeiten
- Fehlerbehebung bei der UiPath-CLI
- Azure DevOps-Erweiterung
- Jenkins-Plugin
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde.
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.
Voraussetzungen und Schritte zum Packen eines UiPath-Projekts in ein NuGet-Paket mithilfe der CLI.
Voraussetzungen
- Erstellen Sie Projekte.
- Führen Sie die CLI-Datei
exe(für Windows) oderdll(für Linux) aus. - Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.
Hinweis:
Sie können das Paket auch lokal erstellen, ohne dass Orchestrator-Scopes erforderlich sind.
Führen Sie die folgenden Schritte aus, um ein Projekt in ein Paket zu packen:
- Führen Sie die
package-Aufgabe mituipcli packageaus. Sie können eine Liste der verfügbaren Unteraufgaben sehen. - Geben Sie die erforderlichen Parameter an und führen Sie die
pack-Unteraufgabe aus. In der folgenden Tabelle sind die erforderlichen Parameter beschrieben.
Hinweis:
Die Projektvalidierung wird nicht von den Pack- oder Analyze-Aufgaben der UiPath-CLI durchgeführt.
Legende: (*) – Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek im Orchestrator haben.
| Parameter | Beschreibung |
|---|---|
-o, oder --output (erforderlich) | Pfad des Zielordners. |
-v, or --version | Legen Sie die Paketversion fest. |
--autoVersion | Eine Paketversion automatisch generieren. |
--outputType | Die Ausgabe in einem bestimmten Typ erzwingen. |
--splitOutput | Aktiviert die Aufteilung der Ausgabe in Runtime- und Designbibliotheken. |
--activitiesRootCategory | Das Präfix der Stammkategorie, das auf jede Aktivität angewendet wird, die von der veröffentlichten Bibliothek verfügbar gemacht wird. Hat nur Auswirkungen, wenn ein Bibliotheksprojekt gepackt wird; Wird für Prozess-, Test- und Objektprojekte ignoriert. Wenn keine Angabe erfolgt, wird standardmäßig der Bibliotheksprojektname verwendet. |
--repositoryUrl | Die Repository-URL, unter der das Projekt versioniert wird. |
--repositoryCommit | Der Repository-Commit, aus dem das Projekt erstellt wurde. |
--repositoryBranch | Die Repository-Verzweigung, aus der das Projekt erstellt wurde. |
--repositoryType | VCS-System-Repository-Typ. |
--projectUrl | URL der Automation Hub-Idee. |
--releaseNotes | Versionshinweise hinzufügen. |
-u, --libraryOrchestratorUsername (*) (Erforderlich , wenn Sie die Standardauthentifizierung über einen Benutzernamen und ein Kennwort verwenden) | Der Benutzername, der für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Kennwort koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-p, --libraryOrchestratorPassword (*) (Erforderlich , wenn Sie die Standardauthentifizierung über einen Benutzernamen und ein Kennwort verwenden) | Das Kennwort, das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Benutzernamen koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-t, --libraryOrchestratorAuthToken (*) (Erforderlich , wenn Sie tokenbasierte Authentifizierung verwenden ) | Das OAuth2-Aktualisierungstoken, das für die Authentifizierung bei Orchestrator verwendet wird. Sie müssen es mit dem Kontonamen und der Client-ID koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-a, --libraryOrchestratorAccountName (*) (Erforderlich , wenn Sie tokenbasierte Authentifizierung verwenden ) | Der Name des Orchestrator CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-ID koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist |
-A, --libraryOrchestratorAccountForApp (*) | Der Name des Orchestrator CloudRPA-Kontos (Organisationsname). Sie müssen ihn mit der Anwendungs-ID,dem Anwendungsgeheimnis und dem Anwendungs-Scope für eine externe Anwendung koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist. |
-I ,--libraryOrchestratorApplicationId (*) (Erforderlich, wenn Sie die Authentifizierung einer externen Anwendung verwenden ) | Die ID der externen Anwendung. Sie müssen es mit dem Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist. |
-S, --libraryOrchestratorApplicationSecret (*) (Erforderlich, wenn Sie die Authentifizierung einer externen Anwendung verwenden ) | Das Geheimnis externen Anwendung. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungs-Scope koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist. |
--libraryOrchestratorApplicationScope (*) (Erforderlich , wenn Sie die Authentifizierung einer externen Anwendung verwenden ) | Die Liste der Anwendungs-Scopes, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungsgeheimnis für eine externe Anwendungen koppeln. Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist. |
--libraryOrchestratorFolder (*) | Der Name des Ziel-Orchestrator-Ordners. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn. |
--libraryOrchestratorUrl (*) | Die URL der Orchestrator-Instanz. |
--libraryOrchestratorTenant (*) | Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten. |
--libraryIdentityUrl(Erforderlich für PaaS- oder MSI- Bereitstellungen) | Die URL Ihres Identitätsservers. |
--traceLevel | Zeigt die Ablaufverfolgung der Ereignisse an. |
-l, or --language | Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird. |
--disableBuiltInNugetFeeds | Deaktivieren Sie integrierte NuGet-Feeds. |
Project(s) Path (pos. 0) (Erforderlich) | Der Pfad zu einer project.json -Datei oder zu einem Ordner, der project.json -Dateien enthält. |
Nutzung
uipcli package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--splitOutput] [--activitiesRootCategory <root_category>] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]
uipcli package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--splitOutput] [--activitiesRootCategory <root_category>] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]
Beispiele
uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output"uipcli package pack "C:\userprofile\MyLibrary\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --outputType Library --activitiesRootCategory "MyCompany.Finance.Invoicing"uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName" --libraryIdentityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://automation-suite.base.url.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://cloud.uipath.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"