- Notas relacionadas
- Introducción
- Control
- Control de origen
- Procesos CI / CD
- Gestión de fuentes
- Registro
Acerca de la CLI de UiPath
UiPath® ofrece una interfaz de línea de comandos (CLI) que te permite ejecutar ciertas tareas predefinidas para la gestión y prueba de paquetes RPA. El propósito de UiPath CLI es integrar fácilmente esas capacidades con herramientas de terceros como GitLab, Jenkins y muchas otras, sin un complemento.
La CLI de UiPath se puede utilizar con Orchestrator implementado a través de Automation Cloud™, Automation Suite o de forma independiente.
Los casos de uso comunes para la CLI de UiPath incluyen:
- Empaquetar proyectos de Studio en paquetes NuGet.
- Implementar paquetes NuGet en Orchestrator.
- Ejecutar trabajos en Orchestrator.
- Ejecutar conjuntos de prueba en Orchestrator.
La CLI de UiPath consta de dos tipos:
-
UiPath.CLI.Windows
- Solo se ejecuta en dispositivos Windows.
- Crea proyectos de Windows: heredados,Windowsy multiplataforma .
-
UiPath.CLI
- Solo se ejecuta en dispositivos Linux.
- Crea solo proyectos multiplataforma .
-
UiPath CLI no admite la conexión SSO.
-
UiPath CLI no se puede utilizar para crear proyectos que utilicen desencadenadores locales.
-
La CLI de UiPath carece de la funcionalidad para firmar un paquete, una característica que está disponible cuando se publica el paquete desde Studio. En este caso, la única opción es firmar el paquete después de que se haya creado utilizando la CLI de UiPath. Para obtener más información, consulta el comando firmar. Esta opción de firma también funciona para Azure DevOps y Jenkins.
Aquí puedes verificar la compatibilidad entre la versión de CLI, la versión de .NET requerida y la versión de UiPath Robot de destino.
Versión CLI |
Versión .NET requerida |
Versión de Robot de destino para las automatizaciones creadas |
---|---|---|
24.10 |
.NET 8 |
24.10+ |
23.10 |
.NET 6 |
23.10+ |
23.4 |
.NET 6 |
23.4+ |
Puedes descargar cualquier versión de la CLI de UiPath desde la fuente pública oficial de UiPath.
uipcli.exe
(para UiPath.CLI.Windows) o uipcli.dll
(para UiPath.CLI), ubicado en la carpeta tools
.
La versión de UiPath Studio que utilice para crear sus proyectos debe coincidir con la versión de UiPath.CLI.Windows.
Leyenda: - compatible; : no compatible.
Orchestrator |
Tipo de proyecto |
UiPath.CLI.Windows 23.10 |
UiPath.CLI.Windows 23.6 |
UiPath.CLI.Windows 22.10 |
---|---|---|---|---|
2023.10.x PaaS | Windows: Legacy |
|
|
|
2023.10.x PaaS | Ventanas |
|
|
|
2023.10.x PaaS | Multiplataforma |
|
|
|
2021.10.x En las instalaciones |
Windows: Legacy |
|
|
|
2021.10.x En las instalaciones |
Ventanas |
|
|
|
2021.10.x En las instalaciones |
Multiplataforma |
|
|
|
2021.10.x PaaS |
Windows: Legacy |
|
|
|
2021.10.x PaaS |
Ventanas |
|
|
|
2021.10.x PaaS |
Multiplataforma |
|
|
|
2022.4.x |
Windows: Legacy |
|
|
|
2022.4.x |
Ventanas |
|
|
|
2022.4.x |
Multiplataforma |
|
|
|
2022.10.x |
Windows: Legacy |
|
|
|
2022.10.x |
Ventanas |
|
|
|
2022.10.x |
Multiplataforma |
|
|
|
2023.4.x | Windows: Legacy |
|
|
|
2023.4.x | Ventanas |
|
|
|
2023.4.x | Multiplataforma |
|
|
|
Nube |
Windows: Legacy |
|
|
|
Nube |
Ventanas |
|
|
|
Nube |
Multiplataforma |
|
|
|
La versión de UiPath Studio que utilice para crear sus proyectos debe coincidir con la versión de UiPath.CLI. Por ejemplo, si crea proyectos con UiPath Studio 2021.10, debe utilizar la versión 21.10 de UiPath.CLI.
Leyenda: - compatible; : no compatible.
Orchestrator | Tipo de proyecto | UiPath.CLI 23.10 | UiPath.CLI 23.6 | UiPath.CLI 22.10 | UiPath.CLI 22.4 | UiPath.CLI 21.10 |
---|---|---|---|---|---|---|
2023.10.x PaaS | Windows: Legacy |
|
|
|
|
|
2023.10.x PaaS | Ventanas |
|
|
|
|
|
2023.10.x PaaS | Multiplataforma |
|
|
|
|
|
2021.10.x En las instalaciones |
Windows: Legacy |
|
|
|
|
|
2021.10.x En las instalaciones |
Ventanas |
|
|
|
|
|
2021.10.x En las instalaciones |
Multiplataforma |
|
|
|
|
|
2021.10.x PaaS |
Windows: Legacy |
|
|
|
|
|
2021.10.x PaaS |
Ventanas |
|
|
|
|
|
2021.10.x PaaS |
Multiplataforma |
|
|
|
|
|
2022.4.x |
Windows: Legacy |
|
|
|
|
|
2022.4.x |
Ventanas |
|
|
|
|
|
2022.4.x |
Multiplataforma |
|
|
|
|
|
2022.10.x |
Windows: Legacy |
|
|
|
|
|
2022.10.x |
Ventanas |
|
|
|
|
|
2022.10.x |
Multiplataforma |
|
|
|
|
|
2023.4.x | Windows: Legacy |
|
|
|
|
|
2023.4.x | Ventanas |
|
|
|
|
|
2023.4.x | Multiplataforma |
|
|
|
|
|
Nube |
Windows: Legacy |
|
|
|
|
|
Nube |
Ventanas |
|
|
|
|
|
Nube |
Multiplataforma |
|
|
|
|
|
En esta sección se describe cómo puedes gestionar las fuentes NuGet integradas. Además, proporciona información sobre cómo puedes utilizar fuentes NuGet personalizadas según los requisitos específicos de tu proyecto.
uipcli
busca dependencias en las siguientes fuentes integradas:
-
C:\Program Files\Microsoft SDKs\NuGetPackages
(si esta ruta está en el agente actual) -
C:\Program Files (x86)\Microsoft SDKs\NuGetPackages
(si esta ruta está en el agente actual)
uipcli
no utilice las fuentes integradas estableciendo el parámetro --disableBuiltInNugetFeeds
. Este parámetro puede utilizarse para las siguientes tareas: analyze
, pack
y test run
. Cuando ejecutes uipcli
con un archivo de configuración, establece "disableBuiltInNugetFeeds": true
.
Puedes utilizar fuentes personalizadas al empaquetar una automatización.
Uso de nuget.config personalizado en la CLI de UiPath
Para utilizar la fuente personalizada, sigue los siguientes pasos:
-
Crea un archivo
nuget.config
personalizado con el siguiente formato:<?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> -
Coloca el archivo
nuget.config
personalizado en la carpeta donde se almacenauipcli
:
Uso de nuget.config personalizado en Azure DevOps
nuget.config
a $(Agent.ToolsDirectory)/uipcli
, después del paso InstallPlatform
, como se muestra en el siguiente ejemplo:
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'
Uso de nuget.config personalizado en Jenkins
nuget.config
a ${WORKSPACE}/CLI
, después del paso InstallPlatform
, como se muestra en el siguiente ejemplo:
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()
)
}
}
}
}