automation-ops
latest
false
Importante :
Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática.
Guía de usuario de Automation Ops
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 23 de oct. de 2024

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.

Nota:

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:

  1. UiPath.CLI.Windows

    • Solo se ejecuta en dispositivos Windows.
    • Crea proyectos de Windows: heredados,Windowsy multiplataforma .
  2. UiPath.CLI

    • Solo se ejecuta en dispositivos Linux.
    • Crea solo proyectos multiplataforma .
Nota:
  • 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.

Requisitos previos

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+

Para UiPath.CLI.Windows, también debes instalar .NET Desktop Runtime, que también viene con el SDK de .NET.

Descarga de la CLI de UiPath

Puedes descargar cualquier versión de la CLI de UiPath desde la fuente pública oficial de UiPath.

  1. Vaya a la fuente pública oficial de UiPath.
  2. En la barra de búsqueda de Filtrar por palabras clave , escribe uipath.cli.
  3. Seleccione una de las siguientes opciones:
    • UiPath.CLI: CLI de UiPath diseñada para dispositivos Linux
    • UiPath.CLI.Windows: CLI de UiPath diseñada para dispositivos Windows
  4. Ve a la pestaña Versiones y selecciona la versión de la CLI que deseas descargar.
  5. Selecciona Descargar.
  6. Abra la carpeta donde se descarga el archivo NUPKG, haga clic con el botón derecho y extraiga el archivo en una carpeta.
Resultados: se crea una carpeta con el mismo nombre que el archivo NUPK. Esta carpeta contiene el contenido de la CLI de UiPath. El punto de entrada para todas las operaciones es uipcli.exe (para UiPath.CLI.Windows) o uipcli.dll (para UiPath.CLI), ubicado en la carpeta tools .

Matriz de compatibilidad de UiPath.CLI.Windows

La versión de UiPath Studio que utilice para crear sus proyectos debe coincidir con la versión de UiPath.CLI.Windows.

Leyenda: available - compatible; No disponible : 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

available

available

available

2023.10.x PaaS

Ventanas

available

available

available

2023.10.x PaaS

Multiplataforma

available

available

available

2021.10.x En las instalaciones

Windows: Legacy

available

available

available

2021.10.x En las instalaciones

Ventanas

available

available

available

2021.10.x En las instalaciones

Multiplataforma

available

available

available

2021.10.x PaaS

Windows: Legacy

available

available

available

2021.10.x PaaS

Ventanas

available

available

available

2021.10.x PaaS

Multiplataforma

available

available

available

2022.4.x

Windows: Legacy

available

available

available

2022.4.x

Ventanas

available

available

available

2022.4.x

Multiplataforma

available

available

available

2022.10.x

Windows: Legacy

available

available

available

2022.10.x

Ventanas

available

available

available

2022.10.x

Multiplataforma

available

available

available

2023.4.xWindows: Legacy

available

available

available

2023.4.xVentanas

available

available

available

2023.4.xMultiplataforma

available

available

available

Nube

Windows: Legacy

available

available

available

Nube

Ventanas

available

available

available

Nube

Multiplataforma

available

available

available

Matriz de compatibilidad UiPath.CLI

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: available - compatible; No disponible : no compatible.

OrchestratorTipo de proyectoUiPath.CLI 23.10UiPath.CLI 23.6UiPath.CLI 22.10UiPath.CLI 22.4UiPath.CLI 21.10

2023.10.x PaaS

Windows: Legacy

No disponible

No disponible

No disponible

No disponible

No disponible

2023.10.x PaaS

Ventanas

No disponible

No disponible

No disponible

No disponible

No disponible

2023.10.x PaaS

Multiplataforma

available

available

available

available

available

2021.10.x En las instalaciones

Windows: Legacy

No disponible

No disponible

No disponible

available

available

2021.10.x En las instalaciones

Ventanas

No disponible

No disponible

No disponible

No disponible

No disponible

2021.10.x En las instalaciones

Multiplataforma

available

available

available

available

available

2021.10.x PaaS

Windows: Legacy

No disponible

No disponible

No disponible

available

available

2021.10.x PaaS

Ventanas

No disponible

No disponible

No disponible

No disponible

No disponible

2021.10.x PaaS

Multiplataforma

available

available

available

available

available

2022.4.x

Windows: Legacy

No disponible

No disponible

No disponible

available

available

2022.4.x

Ventanas

No disponible

No disponible

No disponible

No disponible

No disponible

2022.4.x

Multiplataforma

available

available

available

available

available

2022.10.x

Windows: Legacy

No disponible

No disponible

No disponible

available

available

2022.10.x

Ventanas

No disponible

No disponible

No disponible

No disponible

No disponible

2022.10.x

Multiplataforma

available

available

available

available

available

2023.4.xWindows: Legacy

No disponible

No disponible

No disponible

available

available

2023.4.xVentanas

No disponible

No disponible

No disponible

No disponible

No disponible

2023.4.xMultiplataforma

available

available

available

available

available

Nube

Windows: Legacy

No disponible

No disponible

No disponible

available

available

Nube

Ventanas

No disponible

No disponible

No disponible

No disponible

No disponible

Nube

Multiplataforma

available

available

available

available

available

Gestionar fuentes NuGet

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.

Deshabilitar las fuentes NuGet integradas

De forma predeterminada, uipcli busca dependencias en las siguientes fuentes integradas: Puedes especificar que 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.
docs image
docs image

Uso de fuentes NuGet personalizadas

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:

  1. 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>
  2. Coloca el archivo nuget.config personalizado en la carpeta donde se almacena uipcli :
    docs image

Uso de nuget.config personalizado en Azure DevOps

Debes actualizar la configuración y copiar 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

Debes actualizar la configuración y copiar 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()
                )
            }
        }
    }
}

¿Te ha resultado útil esta página?

Obtén la ayuda que necesitas
RPA para el aprendizaje - Cursos de automatización
Foro de la comunidad UiPath
Uipath Logo White
Confianza y seguridad
© 2005-2024 UiPath. Todos los derechos reservados.