Restaurar y analizar soluciones

Antes de empaquetar una solución, normalmente se restauran sus dependencias y se valida con las reglas de control. Estas operaciones se ejecutan localmente y no requieren autenticación de Orchestrator.

Restaurar dependencias

El comando restore descarga todos los paquetes de actividades necesarios y las dependencias del proyecto en una carpeta local.

Sintaxis del comando

uipcli solution restore <solution-path> [options]

Parámetros:

Parámetro	Descripción	Obligatorio
<solution-path>	Ruta a la carpeta de la solución o al archivo .uipx	Sí
--restoreFolder	Ruta local donde se restauran las dependencias	No
--traceLevel	Nivel de registro: Verbose, Information, Warning	No

Ejemplo

uipcli solution restore C:\Solutions\MySolution \  --restoreFolder C:\Work\Output \  --traceLevel Verbose

Uso de fuentes NuGet personalizadas

Si tu solución depende de actividades de fuentes personalizadas (incluidas las fuentes de Orchestrator), puedes proporcionar un archivo nuget.config en el directorio de soluciones o especificar fuentes utilizando los parámetros de la biblioteca de Orchestrator:

uipcli solution restore C:\Solutions\MySolution \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --libraryOrchestratorApplicationScope "OR.Folders OR.Settings.Read" \  --libraryOrchestratorTenant DefaultTenant \  --libraryOrchestratorUrl https://cloud.uipath.com/ \  --libraryOrchestratorFolder MyFolder \  --traceLevel Verbose

Consulta Gestionar fuentes de NuGet para obtener más información sobre la configuración de fuentes de actividad.

Consideraciones de rendimiento

La restauración de NuGet suele ser el paso más lento en el empaquetado de soluciones. Cada operación de restauración debe resolver tanto las dependencias directas como las transitivas.

Para mejorar el rendimiento de la restauración:

1. Almacena en caché la carpeta del paquete global de NuGet entre ejecuciones del proceso:
   • Windows: %UserProfile%\.nuget\packages
   • Linux/macOS: ~/.nuget/packages
2. Utiliza un nuget.config recortado con solo fuentes accesibles:
   • Elimina las fuentes lentas o inalcanzables de la configuración.
   • Ordene fuentes por fiabilidad y velocidad.
3. Utiliza agentes autoalojados si se requiere el almacenamiento en caché persistente.

Consulta la documentación Gestionar fuentes de NuGet para ver ejemplos de caché en Azure DevOps y otras plataformas CI/CD.

Analizar una solución

El comando analyze valida la solución frente a las reglas y políticas de control del Analizador de flujo de trabajo.

Sintaxis del comando

uipcli solution analyze <solution-path> [options]

Parámetros:

Parámetro	Descripción	Obligatorio
<solution-path>	Ruta a la carpeta de la solución o al archivo .uipx	Sí
--governanceFilePath	Ruta al archivo JSON de la política de control	No
--resultPath	Ruta donde se guardarán los resultados del análisis JSON	No
--analyzerTraceLevel	Nivel de registro del analizador: Warning, Information, Verbose	No
--traceLevel	Nivel de registro CLI	No

Ejemplo

uipcli solution analyze C:\Solutions\MySolution \  --governanceFilePath C:\Policies\uipath.policy.Production.json \  --resultPath C:\Output\analyze.json \  --analyzerTraceLevel Warning \  --traceLevel Information

Políticas de control

Las políticas de control definen reglas que deben cumplirse antes de que se pueda empaquetar e implementar una solución. Estos suelen incluir:

• Estándares de calidad del código
• Convenciones de nombres
• Comprobaciones de seguridad
• Umbrales de rendimiento

Los archivos de política son documentos JSON que configuran las reglas del Analizador de flujo de trabajo. Puedes:

• Crear políticas en Studio
• Exportarlos desde Orchestrator
• Controle la versión junto con el código de su solución

Utilizar resultados de análisis en CI/CD

El JSON de los resultados del análisis puede ser analizado por tu proceso para:

• Falla la compilación si se encuentran infracciones críticas
• Generar informes de cumplimiento
• Puerta de implementaciones a entornos de producción

Flujo de trabajo típico

Un patrón CI/CD común combina restaurar y analizar antes de empaquetar:

# 1. Restore dependenciesuipcli solution restore C:\Solutions\MySolution \  --restoreFolder C:\Output\Dependencies \  --traceLevel Information# 2. Analyze against governance rulesuipcli solution analyze C:\Solutions\MySolution \  --governanceFilePath C:\Policies\production.json \  --resultPath C:\Output\analysis.json \  --analyzerTraceLevel Warning# 3. Check analysis results# 4. Continue to packaging...

Esto garantiza que solo las soluciones validadas y compatibles procedan al empaquetado e implementación.