Implementación de soluciones con procesos

UiPath® Solutions Management permite la implementación de automatizaciones junto con todos sus recursos necesarios. Para integrar esto en el ciclo de vida del desarrollo de la automatización, UiPath® Automation Ops™ - Pipelines, ha añadido soporte para la implementación de soluciones. Ahora puedes probar y volver a implementar una solución automáticamente con cada cambio de código de tus automatizaciones.

Nota:

Para aprovechar al máximo este proceso, debes estar familiarizado con el concepto de solución en el contexto de UiPath®. Para obtener más información, consulta Información general sobre la gestión de soluciones.

Utilizar el proceso prediseñado

Puedes utilizar el proceso prediseñado de Marketplace. Debes descargar el paquete Marketplace, crear un proceso a partir de él y asignar los roles específicos de la solución, como se detalla en los siguientes pasos:

1. Descarga el paquete del proceso de implementación de soluciones de UiPath® Marketplace.

   
   
   
   
   

2. Crea un proceso de proceso en la carpeta de tiempo de ejecución de procesos en Orchestrator. Para comprobar tu carpeta de tiempo de ejecución de proceso en Orchestrator, ve a Procesos > Configuración de tiempo de ejecución, como se muestra también en el siguiente ejemplo:

   
   
   
   
   

3. Asigna a la cuenta de robot de Procesos el rol de tenant Administrador de soluciones. Debes asignar este rol en todos los tenants que el proceso gestionará soluciones.

Pasos del proceso de implementación de la solución

La siguiente lista proporciona un resumen de los pasos implicados en el proceso del proceso de implementación de soluciones:

1. Clonar el repositorio.

2. Recorriendo línea por línea el archivo de configuración del proceso de la solución, y para cada proyecto allí (cada línea), lo analiza, ejecuta pruebas, crea una nueva versión del paquete, la publica y actualiza el proceso de destino (especificado en el proyecto de la solución) .

3. Sincronizar el proyecto de la solución, para que tenga en cuenta las nuevas versiones de las automatizaciones.

4. Publicar el paquete de soluciones en el primer entorno.

5. Descargando el archivo de configuración del paquete de soluciones.

6. Implementar la solución.

7. Activar la solución.

8. Suspendiendo para aprobación.

9. Descargar el paquete de soluciones del primer entorno y cargarlo en el segundo entorno.

10. Implementar la solución en el segundo entorno.

11. Activar la solución.

Argumentos del proceso

La siguiente tabla describe los argumentos de proceso disponibles.

Nombre	Descripción
Analizar polí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.
URL de Orchestrator	La URL del Orchestrator donde se publican los paquetes de automatización.
Nombre del proyecto de solución	El nombre del proyecto de solución. Se utiliza para identificar el proyecto de solución.
Nombre del paquete de soluciones	El nombre del paquete de soluciones que se creará.
Versión del paquete de soluciones	La versión del paquete de soluciones que se creará.
AnexarNúmeroDeCreaciónAVersiónDeSolución	Permite añadir un sufijo con el número de compilación a la versión del paquete de la solución. Esto es útil para evitar conflictos de versión para ejecuciones de procesos posteriores. Para obtener más información sobre los argumentos predeterminados, como Número de compilación, consulta Argumentos de proceso de proceso predeterminados.
Descripción del paquete de soluciones	La descripción del paquete de soluciones.
Carpeta de la raíz de soluciones	La carpeta raíz en la que se implementan todos los componentes de la solución.
SolutionPipelineConfigurationFile (Opcional)	La ruta relativa del archivo de configuración del proceso de la solución a la raíz del repositorio (como solution-pipeline-configuration.csv). Si no se proporciona, los proyectos no se reconstruirán y el paquete de la solución se volverá a crear únicamente en función de la información del proyecto de la solución.
PrimerTenant	El nombre del tenant donde se define el proyecto de la solución y donde se implementará la solución por primera vez.
PrimeraCarpetaDeImplementación	La carpeta del primer tenant donde se implementará la solución. Será la carpeta principal de la carpeta raíz de la solución. Si está vacío, la solución se implementará en la raíz del tenant.
NombreDeLaPrimeraImplementaciónDeLaSolución	El nombre de esta instalación, para referencia futura. Un paquete de soluciones puede tener varias implementaciones.
ImplementarEnSegundoEntorno	Habilita el resto del proceso relacionado con la implementación de la solución en el segundo entorno.
SecondTenant (opcional)	El tenant donde se implementa la solución por segunda vez. Si no está presente, se utiliza FirstTenant .
Segunda carpeta de implementación (opcional)	La carpeta del segundo tenant donde se implementará la solución. Será la carpeta principal de la carpeta raíz de la solución. Si está vacío, la solución se implementará en la raíz del tenant.
SolutionSecondDeploymentName (Opcional)	El nombre de la segunda instalación, para referencia futura. Si no está presente, se utiliza el Nombre de la primera implementación.
CarpetaDePrueba	La carpeta de Orchestrator donde se ejecutan las pruebas. Funciona junto con el argumento OrchestratorUrl .
Omitir pruebas	Deshabilita/habilita la realización de las pruebas. De forma predeterminada, el proceso ejecuta las pruebas.
DirecciónDeCorreoElectrónicoDeAprobador	La dirección de correo electrónico del usuario que aprueba la implementación en el segundo entorno, normalmente después de validar la primera implementación. Se utiliza para asignar la tarea de aprobación en Action Center.
DirecciónDeCorreoElectrónicoDelUsuarioSoporte (Opcional)	La dirección de correo electrónico del usuario que puede intervenir y corregir los errores de implementación de la solución si es necesario. Si no está presente, el proceso se interrumpirá en caso de errores de implementación de la solución. Nota: El proceso prediseñado es genérico. No podía contener lógica para cubrir la configuración de implementación obligatoria de cada solución específica. Por eso, cuando falla la implementación, el proceso se suspende y solicita una corrección manual. Para evitarlo, puedes utilizar el archivo de configuración del paquete de soluciones en tu proceso personalizado.
SkipSync (opcional)	Se puede utilizar para recrear un paquete de soluciones sin ninguna actualización.
OmitirValidación (Opcional)	Omite la validación durante el paso de creación del proyecto.

Gestionar problemas de implementación

En caso de una implementación fallida, se crea una tarea de acción para soporte y el proceso se suspende, para que pueda solucionarse. Una vez corregida la implementación, la tarea de acción debe completarse para reanudar la ejecución del proceso.

Al arreglar una implementación, espere a que la implementación alcance el estado Correcto antes de completar la tarea.

Para solucionar manualmente un problema de implementación, ve a Gestión de soluciones > Implementaciones, identifica la implementación y selecciona Reanudar asistente de implementación, como se muestra también en el siguiente ejemplo:

Crear un proceso personalizado a partir de la plantilla

El proceso del proceso de implementación de soluciones está prediseñado para cubrir la mayoría de los casos de uso. Sin embargo, puedes personalizarlo para satisfacer tus necesidades. Para ello, debes recuperar la plantilla de Studio y ajustarla. Para obtener más información sobre las plantillas en Studio, consulta esta sección.

Nota:

Asegúrate de que en Studio > Plantillas, la opción Incluir versión preliminar esté habilitada.

Para crear un proceso personalizado, sigue estos pasos:

1. Crea tu proyecto de solución en Gestión de soluciones.

   
   
   
   
   

2. Mantén tus proyectos de automatización bajo control de origen en los repositorios de GitHub o Azure. Todo el código de los proyectos de tu solución debe almacenarse en el mismo repositorio git.

   
   
   
   
   

3. Añade un nuevo archivo de configuración (para más detalles, consulta Archivo de configuración del proceso de solución) a tu repositorio que mantenga la asignación entre la automatización utilizada en el proyecto de solución en el paso 1 y las rutas de los proyectos respectivos en el repositorio. El siguiente ejemplo muestra un archivo de configuración del proceso de solución:

   
   
   
   
   

4. Asigna a la cuenta de robot de Procesos el rol de tenant Administrador de soluciones. Debes asignar este rol en todos los tenants que el proceso gestionará soluciones. La cuenta de robot de Procesos es la cuenta de robot utilizada para ejecutar los procesos y se asigna a tu carpeta de Procesos en Orchestrator.

   
   
   
   
   

   Para obtener más información sobre los roles de cuenta de robot de procesos, consulta Configuración inicial.

   Puedes encontrar tu carpeta Procesos en Orchestrator comprobando la configuración de Runtime en Procesos.

   
   
   
   
   

5. Crea un proceso en Automation Ops. Para desencadenar el proceso cada vez que se produzca un cambio en todo el repositorio (cualquiera de los cambios de proyectos de la solución), selecciona solo el repositorio, no también el proyecto en el primer paso de la definición del proceso.

   
   
   
   
   

6. Establece los argumentos del proceso e inicia tu proceso.

   
   
   
   
   

Archivo de configuración del proceso de solución

El archivo de configuración del proceso de la solución asigna las automatizaciones utilizadas en la solución a sus proyectos de código fuente. El proceso necesita una asignación de este tipo para saber qué proyectos construir y dónde colocarlos para actualizar la solución. Este formato es solo una propuesta utilizada por el proceso prediseñado. Puedes utilizar tu propio formato al crear tu proceso de proceso personalizado.

La configuración del proceso de la solución es un archivo .csv con el siguiente formato:

PathToProjectJson,PackageName,OrchestratorFolder,ProcessName,RunTests

Importante:

La primera línea es el encabezado del archivo .csv y es obligatoria.

Cada una de las líneas configura las acciones que se realizan en un proyecto:

Nombre	Descripción
RutaAlProyectoJson	La ruta relativa a project.json desde la raíz del repositorio.
PackageName	El nombre del paquete creado a partir del proyecto.
Carpeta de Orchestrator	La ubicación donde se actualizará el proceso en Orchestrator.
NombreDelProceso	El nombre del proceso que se va a actualizar.
Ejecutar pruebas	Si ejecutar pruebas o no como parte del proceso.

El siguiente es un ejemplo de un archivo de configuración:

PathToProjectJson,PackageName,OrchestratorFolder,ProcessName,RunTests
Blank Process 16/project.json,Blank.Process.16,Finance,Blank.Process.16,True
ComputeSLA/project.json,ComputeSLA,Finance,ComputeSLA,False

Archivo de configuración del paquete de soluciones

El archivo de configuración del paquete de soluciones es el archivo utilizado para controlar la configuración de implementación automatizada de la solución.

Importante:

El archivo de configuración del proceso de la solución es diferente del archivo de configuración del paquete de la solución. La configuración del proceso de la solución mantiene la asignación entre la solución y el proyecto. La configuración del paquete de soluciones almacena la configuración de los componentes de la solución para la implementación.

Un caso de uso típico es establecer las contraseñas en los Activos de credenciales utilizados en la Solución.

Las contraseñas de los activos de credenciales que forman parte de tu solución no se almacenan en el paquete de la solución y debes especificarlo durante la implementación.

Para establecer la contraseña como parte del proceso, debes descargar el archivo de configuración del paquete de soluciones y actualizarlo en consecuencia.