Descargar paquetes de soluciones y configuraciones

Puedes descargar paquetes de soluciones y archivos de configuración de implementación desde Soluciones en Orchestrator. Esto es útil para la recuperación de desastres, la promoción del entorno y la gestión de la configuración.

Descargar un paquete

El comando download-package recupera un paquete de soluciones de Soluciones.

Sintaxis del comando

uipcli solution download-package <package-name> [options]

Parámetros:

Parámetro	Descripción	Obligatorio
<package-name>	Nombre del paquete a descargar	Sí
-d o --destinationPath	Ruta de destino local donde se guardará el paquete	Sí
-v o --version	Número de versión (si se omite, se descarga la última versión)	No
-f o --fileName	Nombre del archivo local (si se omite, el nombre del archivo será el nombre del paquete + versión)	No
-U	URL de Orchestrator	Sí
-T	Nombre del tenant	Sí
-A	Nombre de la organización	Sí
-I	ID de aplicación externa	Sí
-S	Secreto de aplicación externa	Sí
--applicationScope	Ámbitos opcionales (aplicados por defecto)	No
--traceLevel	Nivel de registro	No

Autenticación

Consulta Autenticación y ámbitos para conocer los ámbitos necesarios y Configuración de la aplicación externa.

Ejemplo

uipcli solution download-package MySolution \
  -d C:\Downloads \
  -v 1.2.3 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Esto descarga el paquete en:

C:\Downloads\MySolution.1.2.3.zip

Ejemplo con nombre de archivo personalizado:

uipcli solution download-package MySolution \
  -d C:\Downloads \
  -f CustomPackageName.zip \
  -v 1.2.3 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Casos de uso para descargar paquetes

Recuperación ante desastres:

• Archivar paquetes para copia de seguridad
• Restaurar paquetes si Orchestrator no está disponible

Promoción del entorno:

• Descargar desde el entorno de prueba
• Cargar en el entorno de producción

Auditoría:

• Recuperar versiones específicas para revisiones de cumplimiento
• Comparar el contenido del paquete en todas las versiones

Pruebas locales:

• Descargar un paquete implementado para su validación
• Prueba de desempaquetado e implementación local

Descargar configuraciones de implementación

El comando download-config recupera plantillas de configuración específicas del entorno para una implementación de soluciones.

Sintaxis del comando

uipcli solution download-config <package-name> [options]

Parámetros:

Parámetro	Descripción	Obligatorio
<package-name>	Nombre del paquete	Sí
-d o --destinationPath	Ruta de destino local donde se guardarán los archivos de configuración	Sí
-v o --version	Número de versión (si se omite, se descarga la configuración de la última versión)	No
-f o --fileName	Nombre del archivo local (si se omite, el nombre del archivo será el nombre del paquete + versión)	No
--format	Formato de configuración: yaml o json (predeterminado: yaml)	No
-U	URL de Orchestrator	Sí
-T	Nombre del tenant	Sí
-A	Nombre de la organización	Sí
-I	ID de aplicación externa	Sí
-S	Secreto de aplicación externa	Sí
--applicationScope	Ámbitos opcionales (aplicados por defecto)	No
--traceLevel	Nivel de registro	No

Nota:

Al utilizar la autenticación de aplicaciones externas sin especificar el parámetro --applicationScope , la CLI aplica automáticamente estos ámbitos predeterminados de AutomationSolution:

Solutions.Packages Solutions.Deployments OR.Execution

Autenticación

Consulta Autenticación y ámbitos para conocer los ámbitos necesarios y Configuración de la aplicación externa.

Ejemplo

Descarga la configuración en formato YAML (predeterminado):

uipcli solution download-config MySolution \
  -d C:\Configs \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Descarga la configuración en formato JSON con un nombre de archivo personalizado:

uipcli solution download-config MySolution \
  -d C:\Configs \
  -f CustomConfigFile \
  -v 1.0.0 \
  --format json \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

¿Qué son las configuraciones de implementación?

Las configuraciones de implementación definen la configuración específica del entorno para una solución:

• Cadenas de conexión
• Puntos de conexión de API
• Referencias de credenciales
• Variables de entorno
• Asignaciones de carpeta

Estas configuraciones son:

• Se crea al implementar una solución
• Almacenado en Soluciones
• Reutilizable en varias implementaciones
• Versión controlada por separado del paquete

Casos de uso para descargar configuraciones

Procesos multientorno:

# Download Dev config
uipcli solution download-config MySolution \
  -d C:\Configs\Dev \
  -f dev-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

# Download Prod config
uipcli solution download-config MySolution \
  -d C:\Configs\Prod \
  -f prod-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

Configuración como código:

• Archivos de configuración de control de versiones
• Seguimiento de los cambios en la configuración del entorno
• Revisar las diferencias de configuración en las solicitudes de extracción

Generación de plantillas:

• Descargar una configuración funcional como punto de partida
• Modificar para nuevos entornos
• Reutilizar patrones de implementación

Auditoría y cumplimiento:

• Configuraciones de archivo para cada implementación
• Comparar la configuración en todos los entornos
• Verifique que la configuración de producción coincida con las plantillas aprobadas

Ejemplo de integración de procesos

Configuraciones de descarga y control de versiones

- name: Download Solution Configs
  run: |
    # Download config from Test environment
    uipcli solution download-config MySolution \
      -d ./configs/test \
      -f test-config \
      --format yaml \
      -U ${{ secrets.ORCHESTRATOR_URL }} \
      -T ${{ secrets.ORCHESTRATOR_TENANT }} \
      -A ${{ secrets.ORG_NAME }} \
      -I ${{ secrets.EXTERNAL_APP_ID }} \
      -S ${{ secrets.EXTERNAL_APP_SECRET }} \
      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"

- name: Commit configs to repo
  run: |
    git add ./configs
    git commit -m "Update deployment configs from Test"
    git push

Solución de problemas

Error: "No autorizado" o "403 Prohibido"

• Verifique que la aplicación externa tenga Solutions.Packages.Read ámbito
• Compruebe que el nombre de la organización (-A) es correcto
• Confirme que el ID de aplicación externa y el secreto son válidos

Error: "Paquete no encontrado"

• Verifique que el nombre y la versión del paquete sean correctos (distingue entre mayúsculas y minúsculas)
• Asegúrese de que está apuntando al tenant y la organización correctos
• Compruebe que el paquete se ha cargado correctamente

Error: "Configuración no encontrada"

• Verifique que el nombre del paquete sea correcto
• Compruebe que la versión existe (u omita -v para usar la más reciente)
• Asegúrese de que el paquete tenga configuraciones de implementación disponibles

Error: "Directorio de salida no accesible"

• Verifique que la ruta de destino (-d) sea válida y se pueda escribir
• Comprobar los permisos de directorio en el agente
• Asegúrese de que haya suficiente espacio en disco disponible

Próximos pasos

Después de descargar paquetes o configuraciones, puedes:

1. Implementar soluciones en entornos de destino.
2. Archivos de configuración de control de versiones para auditoría y cumplimiento.
3. Utiliza configuraciones como plantillas para nuevas implementaciones.