Operaciones de Automation Ops de UiPath: procesos

Automation Ops - Pipelines proporciona una manera fácil de configurar un sistema de integración continua/entrega continua para gestionar el código de tus proyectos de automatización en repositorios externos, como Github o Azure DevOps.

Los procesos contienen un conjunto de pasos que dependen de los procesos de automatización utilizados para alterar el código en tu entorno. Estos procesos, también llamados procesos del proceso, utilizan el paquete Automation Ops - actividades de los procesos. Para que un usuario pueda ver estos procesos del proceso, debe tener acceso a la carpeta de Orchestrator que los contiene.

Cuando se desencadena un proceso, se inicia un trabajo que ejecuta el proceso de proceso asociado utilizando un robot desatendido.

Requisitos previos

• Versiones de robot:
  • 2021.10 y 2022.4: .NET Desktop Runtime 6.0.* debe instalarse manualmente en la máquina del robot.
  • 2022.8 y más reciente: .NET Desktop Runtime se instala automáticamente con el robot.
• Particularidades del proceso:
  • El proceso de canalización debe configurarse para ejecutarse como proceso en segundo plano. Esto se hace desde el menú de configuración del proyecto en Studio. Más información sobre los procesos en segundo plano.
  • Al publicar el proceso de proceso desde Studio a Orchestrator, asegúrate de seleccionar también Incluir fuentes en la sección Opciones de publicación . Más información sobre la publicación de proyectos de automatización.

Configuración

Automation Ops : los procesos funcionan mediante la ejecución de procesos de proceso mediante un Unattended Robot, lo que significa que se necesita una configuración específica en Orchestrator antes de usarlos. Esta configuración se llama entorno de tiempo de Runtime de procesos.

La configuración básica de Orchestrator tiene una carpeta dedicada que contiene los procesos de canalización y una cuenta de robot, además de una máquina o plantilla de máquina para ejecutar los trabajos de canalización.

Importante:

The robot account created during the quick setup is essential. All the pipelines (Orchestrator jobs) are ran on its behalf. Deleting the robot account causes an invalid pipeline runtime configuration and the need to rerun the quick setup.

Eliminar la carpeta de procesos dedicada en Orchestrator interrumpe todos los procesos asociados a ella.

Configuración inicial

Al configurar Ops de automatización - Procesos por primera vez, se muestra una ventana de configuración rápida que te permite elegir el Tenant y el tipo de máquina con la que quieres ejecutar los procesos futuros. Puedes elegir entre usar una máquina existente de tu entorno o crear automáticamente una nueva máquina sin servidor llamada "Robot de procesos".

Nota:

Si eliges crear una nueva máquina sin servidor, asegúrate de que haya suficientes unidades de robot disponibles en tu tenant.

Como parte de la experiencia de configuración rápida, se crean automáticamente una nueva carpeta llamada "Procesos" y los siguientes roles:

• Rol del tenant de procesos
• Rol de carpeta de procesos

El robot de procesos obtiene los siguientes roles asignados automáticamente:

• Tenant: rol de tenant de procesos, Permitir ser Automation User, Permitir ser Automation Publisher
• Carpeta de procesos: rol de carpeta de procesos, usuario de automatización, editor de automatización

Nota:

Asegúrate de que la cuenta de robot creada para los procesos también esté asignada a la carpeta de destino de Orchestrator. Es necesario ya que los procesos operan bajo esa cuenta. Para obtener más información, consulta Configurar el acceso para las cuentas.

The Run Tests activity runs the tests in the provided Orchestrator folder. The Pipelines robot account publishes the package in the respective folder, but the tests can be run by any robot account in that folder that qualifies for the test run, not only by the Pipelines robot account.

Además, los siguientes procesos de procesos predefinidos están disponibles de forma predeterminada:

Build.and.publish	Clonar -> Analizar -> Crear -> Publicar
Copy.package.between.environments	Descargar paquete -> Publicar paquete
Update.process.from.code	Clonar -> Analizar -> Crear -> Publicar paquete -> Proceso de actualización
Update.with.tests	Clonar -> Analizar -> Ejecutar pruebas -> Crear -> Publicar paquete -> Proceso de actualización
Build.and.promote.with.approval	Clonar -> Analizar -> Ejecutar pruebas -> Crear -> Publicar paquete -> Proceso de actualización -> Aprobar -> Descargar paquete -> Cargar paquete -> Proceso de actualización

Estos procesos de procesos predeterminados vienen con su propio conjunto de argumentos, por ejemplo, Crear.y.promover.con.aprobación tiene los siguientes argumentos:

• SkipTesting : te permite elegir si los casos de prueba se ejecutan o no durante el proceso.
• CarpetaDePrueba : la carpeta de Orchestrator donde se ejecutan las pruebas.
• AnalizarPolítica : la política de control que contiene las reglas del analizador de flujo de trabajo utilizadas en el proceso de canalización. Si se deja vacío, se omite el análisis del proyecto.
• SkipValidation : permite omitir la validación antes de crear el paquete. Este valor está deshabilitado por defecto.
• Aprobador : la dirección de correo electrónico del aprobador de la tarea creada en Action Center.
• FirstOrchestratorUrl : la URL del Orchestrator donde se publica el paquete creado.
• PrimeraCarpetaOrchestrator : la carpeta de Orchestrator donde se publica el paquete creado.
• SecondOrchestratorUrl : la URL de Orchestrator donde se publica el paquete creado después de su aprobación.
• SecondOrchestratorFolder : la carpeta de Orchestrator en la que se publica el paquete creado después de su aprobación.
• TengaSamePackageFeed : este campo está establecido como "Falso" de forma predeterminada. Establézcalo como "Verdadero" si el primer y segundo entorno utilizan el mismo paquete / fuente de biblioteca.
• NombreDelProceso : el nombre del proceso que se va a actualizar. Solo se utiliza si el proyecto es en proceso.

Importante:

When using the Build activity, validate the compatibility requirements between the automation projects you are building and the machine running the process.

Por ejemplo, un proyecto creado con la compatibilidadWindows-Legacy or Windows no se puede crear en un robot Cloud Serverless. En su lugar, debes utilizar una máquina basada en Windows .

Al ejecutar un proceso que genera y publica un proceso utilizando conexiones de Integration Service, asegúrate de que todas las carpetas de proyecto necesarias están confirmadas en tu proveedor de control de origen. Por ejemplo, es necesario al inicializar git desde Studio, confirmar todas las carpetas de proyecto asociadas, como .settings, .project, .tmh.

Crear el primer proceso

Una vez completada la configuración de Orchestrator, debes configurar la integración inicial entre Automation Ops -Pipelines, el repositorio de GitHub que contiene tu código y el entorno de tiempo de ejecución de los procesos de Orchestrator. Al hacer esta integración, también crea el primer proceso.

Sigue los siguientes pasos:

1. En Automation Cloud, ve a Automation Ops > Procesos desde la barra de navegación de la izquierda.
2. Selecciona Nuevo proceso. Si tienes el repositorio externo conectado al control de origen , también se conecta automáticamente aquí.
   Nota: solo una organización de UiPath Automation Cloud puede conectarse a una organización de GitHub al mismo tiempo.
3. En la pestaña Ubicación , selecciona la organización del repositorio externo, el repositorio, la rama y un proyecto de automatización (opcional). Haz clic en Siguiente.
   
   
   
   
4. En la pestaña Definición de proceso:
   • Selecciona el proceso de canalización. Si tu proceso de proceso contiene argumentos, puedes añadir sus valores.
   
   
   
   
   
5. En la pestaña Guardar y ejecutar , configura lo siguiente:
   • Nombre del proyecto : introduce un nombre para el proyecto del proceso. De forma predeterminada, el nombre se compone del nombre del repositorio y el nombre del proyecto de automatización del proceso.
   • Descripción : de forma opcional, añade una descripción.
   • Ejecutar este proceso : selecciona cómo quieres que se ejecute el proceso.
     • Para cada confirmación : la automatización del proceso se activa cada vez que hay un cambio en el código del repositorio para el proyecto seleccionado.
     • Ejecutaré manualmente : la automatización del proceso se desencadena manualmente.
6. Haz clic en Guardar para guardar el proceso o en Guardar y ejecutar para guardar y ejecutar el proceso.

Importante:

Si no se elige ningún proceso específico del repositorio en el paso 1 (no se selecciona ningún proyecto de automatización) y el proceso está configurado para que se active con una confirmación, el proceso se activa con cualquier confirmación en el repositorio.

El argumento ProjectPath se rellena con el valor seleccionado en el campo Automation project (optional) del Paso de ubicación de la configuración del proceso.

Si el campo se deja en blanco, el argumento de proceso ProjectPath permanece vacío. Este escenario se puede usar para repositorios que tienen solo un proyecto de automatización.

Ejecutar un proceso manualmente

1. En Automation Cloud, ve a Automation Ops desde la barra de navegación de la izquierda.
2. Selecciona Procesos. Se muestran los procesos disponibles.
3. Selecciona un proceso y luego selecciona Iniciar nuevo trabajo. Esto activa la ejecución del proceso y puede ver el progreso de cada paso en tiempo real.

Desde aquí, también puedes editar el proceso seleccionando Configuración del proceso. Esto mostrará el resumen del proceso, desde donde puedes:

• Editar proceso : selecciónalo para realizar actualizaciones en el proceso. Solo puedes actualizar el nombre del proceso, la descripción, el tipo de desencadenador y los argumentos del proceso personalizados. La ubicación y la definición del proceso no se pueden cambiar.

• Eliminar proceso : selecciona para eliminar el proceso (se eliminará toda la información relacionada con el proceso).

Procesos de canalización predefinidos

Los siguientes procesos de procesos predefinidos están disponibles de forma predeterminada:

Build.and.publish	Clonar -> Analizar -> Crear -> Publicar
Copy.package.between.environments	Descargar paquete -> Publicar paquete
Update.process.from.code	Clonar -> Analizar -> Crear -> Publicar paquete -> Proceso de actualización
Update.with.tests	Clonar -> Analizar -> Ejecutar pruebas -> Crear -> Publicar paquete -> Proceso de actualización
Build.and.promote.with.approval	Clonar -> Analizar -> Ejecutar pruebas -> Crear -> Publicar paquete -> Proceso de actualización -> Aprobar -> Descargar paquete -> Cargar paquete -> Proceso de actualización

Estos procesos de procesos predeterminados vienen con el siguiente conjunto de argumentos:

• Construir.y.promover.con.aprobación :
  • NombreDelProceso : el nombre del proceso que se va a actualizar. Solo se utiliza si el proyecto es en proceso.
  • Aprobador : la dirección de correo electrónico del aprobador de la tarea creada en Action Center.
  • SkipTesting : te permite elegir si los casos de prueba se ejecutan o no durante el proceso.
  • AnalizarPolítica : la política de control que contiene las reglas del analizador de flujo de trabajo utilizadas en el proceso de canalización. Si se deja vacío, se omite el análisis del proyecto.
  • SkipValidation : permite omitir la validación antes de crear el paquete. Este valor está deshabilitado por defecto.
  • PrimeraCarpetaOrchestrator : la carpeta de Orchestrator donde se publica el paquete creado.
  • FirstOrchestratorUrl : la URL del Orchestrator donde se publica el paquete creado.
  • SecondOrchestratorFolder : la carpeta de Orchestrator en la que se publica el paquete creado después de su aprobación.
  • SecondOrchestratorUrl : la URL de Orchestrator donde se publica el paquete creado después de su aprobación.
  • CarpetaDePrueba : la carpeta de Orchestrator donde se ejecutan las pruebas.
  • TengaSamePackageFeed : este campo está establecido como "Falso" de forma predeterminada. Establézcalo como "Verdadero" si el primer y segundo entorno utilizan el mismo paquete / fuente de biblioteca.
• Build.and.publish
  • AnalizarPolítica : la política de control que contiene las reglas del analizador de flujo de trabajo utilizadas en el proceso de canalización. Si se deja vacío, se omite el análisis del proyecto.
  • SkipValidation : permite omitir la validación antes de crear el paquete. Este valor está deshabilitado por defecto.
  • URL deOrchestrator : la URL de Orchestrator donde se publica el paquete creado.
  • CarpetaDeOrchestrator : la carpeta de Orchestrator donde se publica el paquete creado.
• Copy.package.between.environments
  • NombreDelPaquete: el nombre del paquete que se copiará.
  • IsLibrary : define si el paquete es una biblioteca o no.
  • VersiónDelPaquete : la versión del paquete que se va a copiar.
  • CarpetaDeOrchestrator : la carpeta de Orchestrator desde donde se copia el paquete.
  • URLDeOrchestrator : la URL de Orchestrator desde donde se copia el paquete.
  • URLDeOrchestratorDeDestino : la URL de Orchestrator donde se copia el paquete.
  • CarpetaDeOrchestrator : la carpeta de Orchestrator donde se copia el paquete.
• Update.process.from.code
  • NombreDelProceso: el nombre del proceso que se va a actualizar. Solo se utiliza si el proyecto es en proceso.
  • AnalizarPolítica : la política de control que contiene las reglas del analizador de flujo de trabajo utilizadas en el proceso de canalización. Si se deja vacío, se omite el análisis del proyecto.
  • SkipValidation : permite omitir la validación antes de crear el paquete. Este valor está deshabilitado por defecto.
  • URL deOrchestrator : la URL de Orchestrator donde se encuentra el paquete que se va a actualizar.
  • CarpetaDeOrchestrator : la carpeta de Orchestrator donde se encuentra el paquete que se va a actualizar.
• Update.with.tests
  • NombreDelProceso: el nombre del proceso que se va a actualizar. Solo se utiliza si el proyecto es en proceso.
  • AnalizarPolítica : la política de control que contiene las reglas del analizador de flujo de trabajo utilizadas en el proceso de canalización. Si se deja vacío, se omite el análisis del proyecto.
  • OmitirPrueba : permite omitir pruebas antes de crear el paquete. Este valor está deshabilitado por defecto.
  • URL deOrchestrator : la URL de Orchestrator donde se encuentra el paquete que se va a actualizar.
  • CarpetaDeOrchestrator : la carpeta de Orchestrator donde se encuentra el paquete que se va a actualizar.
  • CarpetaDePruebas deOrchestrator : la carpeta de Orchestrator donde se encuentran las pruebas utilizadas en el proceso.

Nota:

Existe un requisito de compatibilidad entre los proyectos de automatización que pretende crear y la máquina que ejecuta el proceso de canalización.

La asignación correcta es:

• Proyecto Windows (heredado) → Compilación del sistema operativo: solo Windows
• Proyecto de Windows → Compilación de sistema operativo: solo Windows
• Proyecto multiplataforma → Crear sistema operativo: Windows o Linux

Argumentos predeterminados del proceso de canalización

Automation Ops proporciona el siguiente conjunto de argumentos predeterminados para el proceso de canalización:

Nombre	Dirección	Tipo de argumento	Descripción
NúmeroDeCreación	En	Cadena	Un número único para cada trabajo de canalización que se ejecuta.
URL del repositorio	En	Cadena	URL del repositorio. Normalmente lo utiliza la actividad Clonar.
Confirmar SHA	En	Cadena	Identificador de confirmación.
Ruta del proyecto	En	Cadena	La ruta al archivo project.json. Útil para la actividad Crear.
NombreDeUsuarioDeComitter	En	Cadena	El nombre de usuario de la persona que desencadena la confirmación.
RepositoryType	En	Cadena	El tipo de repositorio (como git).
RepositoryBranch	En	Cadena	La rama del repositorio utilizada.

Ver registros de procesos

Se generan registros para cada ejecución del proceso. Puedes ver los registros en Automation Ops y, como cada ejecución de proceso crea un trabajo en Orchestrator, también puedes verlos en Orchestrator:

• En Automation Ops, coloca el puntero sobre el lado derecho de un proceso y, a continuación, en el menú contextual, selecciona Ver registros.

• En Orchestrator, accede a la carpeta de procesos dedicada> Automatizaciones > Trabajos. En la columna Origen , busca la etiqueta Procesos y luego selecciona Ver registros.

Eliminar webhooks manualmente

Si el proceso se configuró para ejecutarse para cada confirmación durante la creación, los webhooks se crearon automáticamente en GitHub/Azure DevOps.

Después de eliminar la configuración del tiempo de ejecución, debes eliminar manualmente los webhooks si el enlace de control de origen con el proceso ya se ha eliminado. Aunque no eliminarlos no afectaría a la funcionalidad del servicio CI/CD, recomendamos este paso.

Para cada proceso que tenga un desencadenador en la confirmación y cuya conexión de control de origen se haya eliminado, debes acceder al repositorio de GitHub/Azure DevOps y eliminar los webhooks después de eliminar el entorno de tiempo de ejecución.

Importante:

Si la conexión de control de origen ya se ha eliminado en tu organización y ese repositorio está actualmente conectado a otra organización de UiPath, puedes eliminar webhooks válidos de la segunda organización. Estos no deben eliminarse, de lo contrario los procesos no se activarán en la confirmación.

Por lo tanto, antes de eliminar webhooks, asegúrate de que el repositorio actual no tenga una conexión válida dentro de una configuración de tiempo de ejecución de CI/CD válida en una organización de UiPath.

Eliminar webhooks del repositorio de GitHub

Para eliminar los webhooks del repositorio de GitHub:

1. Ve al repositorio de Github y selecciona Configuración > Webhooks.
   
2. Elimina todas las URL de webhook que terminan en /roboticsops_/cicd_/api/webhooks/github/pipeline.
   

Eliminar webhooks del repositorio de Azure DevOps

Para eliminar los webhooks del repositorio de Azure DevOps:

1. Ve al repositorio de Azure DevOps y selecciona Configuración del proyecto > Enlaces de servicio.
2. En el webhook a eliminar, selecciona Editar.
   
3. Asegúrate de que la URL del webhook termina en /roboticsops_/cicd_/api/webhooks/azure/pipeline.
   
   
4. Elimina la URL del webhook.