UiPath Pack

La tarea UiPathPack te permite empaquetar un proyecto de UiPath existente en un paquete de NuGet.

Configuración

Usa la tabla siguiente para configurar las entradas de UiPath Pack.

Argumento	Descripción
Nombre de visualización (requerido)	Introduce un nombre para tu tarea.
Elegir el método de control de versiones (requerido)	Puedes seleccionar una versión generada automáticamente, utilizar la versión del proyecto o definir una nueva versión. Para obtener más información, consulta Versiones de paquete.
Versión (requerido)	Solo disponible en las carpetas modernas junto a una estrategia de asignación dinámica. Especificar la versión del paquete proporciona la posibilidad de rastrear los paquetes creados y sus versiones de origen de forma más eficiente. Por ejemplo, el patrón de ensamblado de Microsoft se puede utilizar para crear la versión del paquete NuGet: [Major].[Minor].[BuildNumber].[RevisionNumber] Las opciones disponibles son: Versión automática : esta opción actualiza automáticamente la versión al siguiente número secuencial. Puedes utilizar el siguiente ejemplo de configuración de tareas: Tarea - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' VersiónManual : con esta opción, puedes especificar tu propio número de versión. Puedes utilizar el siguiente ejemplo de configuración de tareas: Tarea - task: UiPathPack@3 inputs: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - task: UiPathPack@3 inputs: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' VersiónActual : esta opción mantiene la versión igual a la especificada en el archivo project.json . Puedes utilizar el siguiente ejemplo de configuración de tareas: Tarea - task: UiPathPack@3 inputs: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - task: UiPathPack@3 inputs: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests'
Ruta de proyecto(s) (requerido)	Selecciona la ubicación del proyecto que se va a empaquetar. Puede ser una ruta de acceso directa a un archivo project.json o un directorio con uno o varios proyectos. En este último caso, cada proyecto de nivel uno se empaqueta individualmente.
Elegir tipo de salida (solo se requiere para las versiones manuales)	Establece un tipo de proyecto para el proyecto que se va a empaquetar. Si estableces None , el tipo de proyecto se extraerá del archivo JSON del proyecto. Se admiten los siguientes tipos de proyecto: 'Proceso', 'Biblioteca', 'Pruebas', 'Objetos', 'Ninguno'.
Conexión de Orchestrator (requerido)	Configura la conexión de servicio para acceder a los servicios de UiPath Orchestrator. Puedes configurar una conexión solo para este paso o utilizar una conexión global existente. Para obtener más información, consulta Configuración de la conexión de servicio de UiPath Orchestrator.
Ruta de salida (obligatoria)	Establece una ruta de carpeta en la que se colocará el paquete.
Dividir la salida en bibliotecas de diseño y de runtime	Selecciona esta opción para dividir la salida en bibliotecas de diseño y tiempo de ejecución. De forma predeterminada, esta opción no está activada.
Deshabilitar fuentes NuGet integradas	Selecciona esta opción para deshabilitar las fuentes NuGet integradas. De forma predeterminada, está establecido en falso.
Información de la versión del código fuente y URL de la idea de Automation Hub	Selecciona esta opción para habilitar los metadatos del paquete, incluida la información de la versión del código fuente y la URL de la idea de Automation Hub. Cuando está habilitado, puedes especificar los detalles del repositorio y la URL del proyecto.
La ruta completa a project.json dentro del repositorio remoto	Especifica la ruta completa a project.json dentro del repositorio remoto. Disponible cuando los metadatos del paquete están habilitados.
El ID de confirmación	Especifica el ID de confirmación de tu sistema de control de versiones. Disponible cuando los metadatos del paquete están habilitados. Ejemplo: $(Build.SourceVersion)
La rama del repositorio	Especifica el nombre de la rama del repositorio. Disponible cuando los metadatos del paquete están habilitados. Ejemplo: $(Build.SourceBranchName)
El tipo de repositorio	Especifica el tipo de repositorio (p. ej., git). Disponible cuando los metadatos del paquete están habilitados.
URL de la idea de Automation Hub	Especifique la URL de la idea de Automation Hub para vincular el paquete a una idea de automatización específica. Disponible cuando los metadatos del paquete están habilitados.
Notas relacionadas	Especifica las notas de la versión para el paquete. Disponible cuando los metadatos del paquete están habilitados.
Ejecutar análisis de flujo de trabajo	Selecciona esta opción para ejecutar reglas de análisis de flujo de trabajo en tu proyecto de automatización (por ejemplo, trabajos de error en caso de errores). Por defecto, esta opción no está seleccionada. Para obtener más información, consulta Reglas de analizador de flujo de trabajo de prueba.
Ruta del archivo de control	Especifique la ruta a las políticas de control que contienen reglas del Analizador de flujo de trabajo. Las políticas pueden descargarse desde Automation Ops o extraerse del archivo zip comprimido exportado desde Studio. Disponible cuando el análisis de flujo de trabajo está habilitado.
Ruta de certificado	Especifique la ruta al archivo del certificado en formato .pfx utilizado para firmar el paquete. Cuando se proporcione, el paquete se firmará digitalmente con el certificado. Ejemplo: $(Build.SourcesDirectory)\certificates\signing-cert.pfx
Contraseña de certificado	Especifica la contraseña para el certificado. Se recomienda almacenar este valor como una variable secreta en Azure DevOps. Ejemplo: $(CertificatePassword)
URL del servidor de marca de tiempo	Especifique la URL del servidor de marca de tiempo que se utilizará al firmar el paquete. La marca de tiempo garantiza que la firma siga siendo válida incluso después de que caduque el certificado. Ejemplo: https://timestamp.digicert.com
Nivel de seguimiento	Selecciona el nivel de registro en la lista desplegable.

Proceso de YAML

Puedes previsualizar un documento de YAML totalmente analizado para Empaquetar de UiPath.

Ejemplo: creación de paquete básico

- task: UiPathPack@2
  inputs:
    versionType: AutoVersion
    projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    outputType: 'Process'
    orchestratorConnection: 'service-connection-name'
    traceLevel: 'Information'

Ejemplo: paquete con firma

- task: UiPathPack@2
  displayName: 'Pack and Sign UiPath Project'
  inputs:
    versionType: 'ManualVersion'
    version: '1.0.$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\MyAutomationProject'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    certificatePath: '$(Build.SourcesDirectory)\certificates\signing-cert.pfx'
    certificatePassword: '$(SigningCertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Information'

Ejemplo: paquete con análisis de flujo de trabajo y firma

- task: UiPathPack@2
  displayName: 'Pack, Analyze, and Sign Project'
  inputs:
    versionType: 'ManualVersion'
    version: '$(Major).$(Minor).$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\EnterpriseAutomation'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    runWorkflowAnalysis: true
    certificatePath: '$(Pipeline.Workspace)\secure-files\company-cert.pfx'
    certificatePassword: '$(CertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Verbose'

Nota:

Al utilizar la firma de paquetes, almacena la contraseña de tu certificado como una variable secreta en Azure DevOps. Ve a Procesos > Biblioteca > Grupos de variables o defínelo en tus variables de proceso con el icono de candado habilitado para mantenerlo seguro.