- Versionshinweise
- Einleitung
- Governance
- Quellenkontrolle
- CI/CD-Pipelines
- Verwalten von Feeds
- Protokollierung
Über UiPath-CLI
UiPath® bietet eine Befehlszeilenschnittstelle (CLI), mit der Sie bestimmte vordefinierte Aufgaben für die Verwaltung und das Testen von RPA-Paketen ausführen können. Der Zweck der UiPath-CLI ist es, diese Funktionen einfach und ohne Plugin mit Drittanbieter-Tools wie GitLab, Jenkins und vielen anderen zu integrieren.
UiPath CLI kann mit dem Orchestrator verwendet werden, der über die Automation Cloud™, die Automation Suite oder eigenständig bereitgestellt wird.
Häufige Anwendungsfälle für die UiPath-CLI sind:
- Packen von Studio-Projekten in NuGet-Pakete.
- Bereitstellen von NuGet-Paketen im Orchestrator.
- Ausführen von Aufträgen im Orchestrator.
- Ausführen von Testsätzen im Orchestrator.
UiPath CLI besteht aus zwei Typen:
-
UiPath.CLI.Windows
- Wird nur auf Windows-Geräten ausgeführt.
- Erstellt Windows – Legacy-,Windows-und plattformübergreifende Projekte.
-
UiPath.CLI
- Läuft nur auf Linux-Geräten.
- Erstellt nur plattformübergreifende Projekte.
-
UiPath-CLI unterstützt keine SSO-Verbindung.
-
Die UiPath-CLI kann nicht verwendet werden, um Projekte zu erstellen, die Lokale Trigger verwenden.
-
Der UiPath-CLI fehlt die Funktionalität zum Signieren eines Pakets – eine Funktion, die verfügbar ist, wenn Sie das Paket über Studio veröffentlichen. In diesem Fall besteht die einzige Option darin, das Paket zu signieren, nachdem es mit der UiPath-CLI erstellt wurde. Weitere Informationen finden Sie unter dem Signierungsbefehl. Diese Signaturoption funktioniert auch für Azure DevOps und Jenkins.
Hier können Sie die Kompatibilität zwischen der CLI-Version, der erforderlichen .NET-Version und der Ziel-Roboterversion überprüfen.
CLI-Version |
.NET-Version erforderlich |
Zielroboterversion für die erstellten Automatisierungen |
---|---|---|
24.10 |
.NET 8 |
24.10+ |
23.10 |
.NET 6 |
23.10+ |
23.4 |
.NET 6 |
23.4+ |
Sie können jede Version der UiPath-CLI aus dem offiziellen öffentlichen UiPath-Feed herunterladen.
uipcli.exe
(für UiPath.CLI.Windows) oder uipcli.dll
(für UiPath.CLI) im Ordner tools
.
Die Version von UiPath Studio, die Sie zum Erstellen Ihrer Projekte verwenden, muss mit der Version von UiPath.CLI.Windows übereinstimmen.
Legende: - kompatibel; - nicht kompatibel.
Orchestrator |
Projekttyp |
UiPath.CLI.Windows 23.10 |
UiPath.CLI.Windows 23.6 |
UiPath.CLI.Windows 22.10 |
---|---|---|---|---|
2023.10.x hat PaaS | Windows – Legacy |
|
|
|
2023.10.x hat PaaS | Windows |
|
|
|
2023.10.x hat PaaS | Plattformübergreifend |
|
|
|
2021.10.x Lokal (On-Premises) |
Windows – Legacy |
|
|
|
2021.10.x Lokal (On-Premises) |
Windows |
|
|
|
2021.10.x Lokal (On-Premises) |
Plattformübergreifend |
|
|
|
2021.10.x PaaS |
Windows – Legacy |
|
|
|
2021.10.x PaaS |
Windows |
|
|
|
2021.10.x PaaS |
Plattformübergreifend |
|
|
|
2022.4.x |
Windows – Legacy |
|
|
|
2022.4.x |
Windows |
|
|
|
2022.4.x |
Plattformübergreifend |
|
|
|
2022.10.x |
Windows – Legacy |
|
|
|
2022.10.x |
Windows |
|
|
|
2022.10.x |
Plattformübergreifend |
|
|
|
2023.4.x | Windows – Legacy |
|
|
|
2023.4.x | Windows |
|
|
|
2023.4.x | Plattformübergreifend |
|
|
|
Cloud |
Windows – Legacy |
|
|
|
Cloud |
Windows |
|
|
|
Cloud |
Plattformübergreifend |
|
|
|
Die Version von UiPath Studio, die Sie zum Erstellen Ihrer Projekte verwenden, muss mit der Version von UiPath.CLI übereinstimmen. Wenn Sie beispielsweise Projekte mit UiPath Studio 2021.10 erstellen, Sie müssen die Version 21.10 von UiPath.CLI verwenden.
Legende: - kompatibel; - nicht kompatibel.
Orchestrator | Projekttyp | UiPath.CLI 23.10 | UiPath.CLI 23.6 | UiPath.CLI 22.10 | UiPath.CLI 22.4 | UiPath.CLI 21.10 |
---|---|---|---|---|---|---|
2023.10.x hat PaaS | Windows – Legacy |
|
|
|
|
|
2023.10.x hat PaaS | Windows |
|
|
|
|
|
2023.10.x hat PaaS | Plattformübergreifend |
|
|
|
|
|
2021.10.x Lokal (On-Premises) |
Windows – Legacy |
|
|
|
|
|
2021.10.x Lokal (On-Premises) |
Windows |
|
|
|
|
|
2021.10.x Lokal (On-Premises) |
Plattformübergreifend |
|
|
|
|
|
2021.10.x PaaS |
Windows – Legacy |
|
|
|
|
|
2021.10.x PaaS |
Windows |
|
|
|
|
|
2021.10.x PaaS |
Plattformübergreifend |
|
|
|
|
|
2022.4.x |
Windows – Legacy |
|
|
|
|
|
2022.4.x |
Windows |
|
|
|
|
|
2022.4.x |
Plattformübergreifend |
|
|
|
|
|
2022.10.x |
Windows – Legacy |
|
|
|
|
|
2022.10.x |
Windows |
|
|
|
|
|
2022.10.x |
Plattformübergreifend |
|
|
|
|
|
2023.4.x | Windows – Legacy |
|
|
|
|
|
2023.4.x | Windows |
|
|
|
|
|
2023.4.x | Plattformübergreifend |
|
|
|
|
|
Cloud |
Windows – Legacy |
|
|
|
|
|
Cloud |
Windows |
|
|
|
|
|
Cloud |
Plattformübergreifend |
|
|
|
|
|
In diesem Abschnitt wird beschrieben, wie Sie die integrierten NuGet-Feeds verwalten können. Darüber hinaus erhalten Sie Informationen darüber, wie Sie benutzerdefinierte NuGet-Feeds gemäß Ihren spezifischen Projektanforderungen verwenden können.
uipcli
nach Abhängigkeiten in den folgenden integrierten Feeds:
-
C:\Program Files\Microsoft SDKs\NuGetPackages
(wenn sich dieser Pfad auf dem aktuellen Agenten befindet) -
C:\Program Files (x86)\Microsoft SDKs\NuGetPackages
(wenn sich dieser Pfad auf dem aktuellen Agenten befindet)
uipcli
die integrierten Feeds nicht verwendet, indem Sie den Parameter --disableBuiltInNugetFeeds
festlegen. Dieser Parameter kann für die folgenden Aufgaben verwendet werden: analyze
, pack
und test run
. Wenn Sie uipcli
mit einer Konfigurationsdatei ausführen, legen Sie "disableBuiltInNugetFeeds": true
fest.
Sie können benutzerdefinierte Feeds beim Packen einer Automatisierung verwenden.
Verwenden von benutzerdefinierter nuget.config in der UiPath-CLI
Führen Sie die folgenden Schritte aus, um den benutzerdefinierten Feed zu verwenden:
-
Erstellen Sie eine benutzerdefinierte
nuget.config
-Datei mit dem folgenden Format:<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration>
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration> -
Platzieren Sie die benutzerdefinierte
nuget.config
-Datei in dem Ordner, in demuipcli
zwischengespeichert wird:
Verwenden von benutzerdefinierten nuget.config in Azure DevOps
nuget.config
$(Agent.ToolsDirectory)/uipcli
nach dem InstallPlatform
Schritt in kopieren, wie im folgenden Beispiel gezeigt:
trigger:
- main
pool:
vmImage: ubuntu-latest
stages:
- stage: Demo
jobs:
- job: Demo
steps:
- task: UiPathInstallPlatform@4
inputs:
cliVersion: 'X_23.6.8581.19168'
- task: CopyFiles@2
inputs:
SourceFolder: '$(Build.SourcesDirectory)'
Contents: 'nuget.config'
TargetFolder: '$(Agent.ToolsDirectory)/uipcli'
- task: UiPathPack@4
inputs:
versionType: 'AutoVersion'
projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
outputPath: '$(Build.ArtifactStagingDirectory)/Output'
traceLevel: 'Information'
trigger:
- main
pool:
vmImage: ubuntu-latest
stages:
- stage: Demo
jobs:
- job: Demo
steps:
- task: UiPathInstallPlatform@4
inputs:
cliVersion: 'X_23.6.8581.19168'
- task: CopyFiles@2
inputs:
SourceFolder: '$(Build.SourcesDirectory)'
Contents: 'nuget.config'
TargetFolder: '$(Agent.ToolsDirectory)/uipcli'
- task: UiPathPack@4
inputs:
versionType: 'AutoVersion'
projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
outputPath: '$(Build.ArtifactStagingDirectory)/Output'
traceLevel: 'Information'
Verwenden einer benutzerdefinierten nuget.config-Datei in Jenkins
nuget.config
${WORKSPACE}/CLI
nach dem InstallPlatform
Schritt in kopieren, wie im folgenden Beispiel gezeigt:
pipeline {
agent {
label 'plugins-jenkins-lts-agent-01'
}
stages {
stage('Clone') {
steps {
git (
branch: 'main',
url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
)
}
}
stage('Install Platform') {
steps {
UiPathInstallPlatform (
traceLevel: 'Information'
)
}
}
stage('Copy nuget.config') {
steps {
bat 'copy nuget.config CLI\\nuget.config'
}
}
stage('Pack') {
steps {
UiPathPack (
outputPath: '${WORKSPACE}/Output',
projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
traceLevel: 'Information',
version: AutoVersion()
)
}
}
}
}
pipeline {
agent {
label 'plugins-jenkins-lts-agent-01'
}
stages {
stage('Clone') {
steps {
git (
branch: 'main',
url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
)
}
}
stage('Install Platform') {
steps {
UiPathInstallPlatform (
traceLevel: 'Information'
)
}
}
stage('Copy nuget.config') {
steps {
bat 'copy nuget.config CLI\\nuget.config'
}
}
stage('Pack') {
steps {
UiPathPack (
outputPath: '${WORKSPACE}/Output',
projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
traceLevel: 'Information',
version: AutoVersion()
)
}
}
}
}