Empaquetar una solución

El comando pack crea un paquete de soluciones implementable (archivo .zip ) que puede cargarse en Soluciones en Orchestrator.

Sintaxis del comando

uipcli solution pack <solution-path> [options]

Parámetros:

Parámetro	Descripción	Obligatorio
<solution-path> (pos. 0)	Ruta a la carpeta de la solución o al archivo .uipx	Sí
--output	Directorio donde se creará el paquete	Sí
--version	Número de versión en formato x.y.z	Sí
-A, --libraryOrchestratorAccountForApp (*)	El nombre de la cuenta de Orchestrator CloudRPA (nombre de la organización). Debes emparejarlo con el ID de la aplicación,el Secreto de la aplicación y el Ámbito de la aplicación para la aplicación externa. Esto es necesario si cualquier proyecto de solución depende de bibliotecas de la fuente de Orchestrator o de otro proceso implementado en Orchestrator.	No
-I ,--libraryOrchestratorApplicationId (*) (Obligatorio si utilizas la autenticación de aplicación externa)	El ID de la aplicación externa. Debes emparejarlo con la Cuenta de la aplicación, el Secreto de la aplicación y el Ámbito de la aplicación. Esto es necesario si cualquier proyecto de solución depende de bibliotecas de la fuente de Orchestrator o de otro proceso implementado en Orchestrator.	No
-S, --libraryOrchestratorApplicationSecret (*) (Obligatorio si utilizas la autenticación de aplicación externa)	El secreto de la aplicación externa. Debes emparejarlo con la cuenta de la aplicación, el ID de la aplicación y el ámbito de la aplicación. Esto es necesario si cualquier proyecto de solución depende de bibliotecas de la fuente de Orchestrator o de otro proceso implementado en Orchestrator.	No
--libraryOrchestratorApplicationScope (*) (Opcional para la autenticación de aplicaciones externas)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la cuenta de la aplicación, el ID de la aplicación y el secreto de la aplicación para la aplicación externa. Esto es necesario si cualquier proyecto de solución depende de bibliotecas de la fuente de Orchestrator o de otro proceso implementado en Orchestrator.	No
--libraryOrchestratorUrl (*)	La URL de la instancia de Orchestrator. Esto es necesario si cualquier proyecto de solución depende de bibliotecas de la fuente de Orchestrator o de otro proceso implementado en Orchestrator.	No
--libraryOrchestratorTenant (*)	El tenant de la instancia de Orchestrator. Esto es necesario si cualquier proyecto de solución depende de bibliotecas de la fuente de Orchestrator o de otro proceso implementado en Orchestrator.	No
--libraryIdentityUrl(Obligatorio para implementaciones de PaaS o MSI )	La URL de su servidor de identidad.	No
--libraryOrchestratorFolder (*)	El nombre de la carpeta de Orchestrator de destino. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .	No
--disableBuiltInNugetFeeds	Deshabilite las fuentes nuget integradas.	No
--repositoryUrl	La URL del repositorio donde se versiona el proyecto.	No
--repositoryCommit	La confirmación del repositorio desde la que se creó el proyecto.	No
--repositoryBranch	La rama del repositorio desde la que se creó el proyecto.	No
--repositoryType	Tipo de repositorio del sistema VCS.	No
--projectUrl	URL de la idea de Automation Hub.	No
--releaseNotes	Añadir notas de la versión.	No
--author	El autor del paquete.	No
--traceLevel	Mostrar el seguimiento de los eventos.	No

Nota:

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

Solutions.Packages Solutions.Deployments OR.Execution

Ejemplo

uipcli solution pack C:\Solutions\MySolution \  --output C:\Output \  --version 1.2.3 \  --traceLevel Verbose

Esto crea un archivo de paquete como:

C:\Output\MySolution.1.2.3.zip

Ejemplo de parámetro completo

uipcli solution pack C:\Solutions\MySolution \  --output C:\Output \  --version 1.2.3 \  --libraryOrchestratorAccountForApp MyOrgAccount \  --libraryOrchestratorApplicationId ******* \  --libraryOrchestratorApplicationSecret ******* \  --libraryOrchestratorApplicationScope "OR.Assets OR.Folders OR.Projects" \  --libraryOrchestratorUrl https://cloud.uipath.com/myOrgName/myTenantName \  --libraryOrchestratorTenant myTenantName \  --libraryIdentityUrl https://identity.uipath.com \  --libraryOrchestratorFolder "AccountingTeam\TeamJohn" \  --disableBuiltInNugetFeeds \  --repositoryUrl https://github.com/my-org/my-repo \  --repositoryCommit 7f3a9c2 \  --repositoryBranch main \  --repositoryType git \  --projectUrl https://automationhub.uipath.com/ideas/1234 \  --releaseNotes "Initial packaged solution version" \  --traceLevel Verbose  --author ExampleAuthor

Requisito de versión

A diferencia de los proyectos independientes, las soluciones no incrementan automáticamente su número de versión. Debes proporcionar explícitamente una versión utilizando el parámetro --version .

Patrones de versiones típicos en CI/CD

La mayoría de los equipos generan la versión de forma dinámica en función de los metadatos de la compilación:

Utilizando el ID de compilación:

--version "1.0.$BUILD_ID"

Utilizar SHA de confirmación de Git:

--version "2.1.${GIT_COMMIT_SHA:0:7}"

Uso del control de versiones semántico con fecha:

--version "$(date +%Y.%m.$BUILD_NUMBER)"

Formato de versión

La versión debe seguir el control de versiones semántico:

• Formato: MAJOR.MINOR.PATCH
• Ejemplo: 1.0.0, 2.3.45, 10.20.1234
• Debe contener exactamente tres componentes numéricos separados por puntos

Integración de procesos

Ejemplo de Azure DevOps

- script: |    uipcli solution pack $(Build.SourcesDirectory)\MySolution \      --output $(Build.ArtifactStagingDirectory) \      --version "1.0.$(Build.BuildId)" \      --traceLevel Information  displayName: 'Pack Solution'

Ejemplo de acciones de GitHub

- name: Pack Solution  run: |    uipcli solution pack ${{ github.workspace }}/MySolution \      --output ${{ runner.temp }}/packages \      --version "1.0.${{ github.run_number }}" \      --traceLevel Information

Qué se empaqueta

Los paquetes de comandos pack:

• Todos los proyectos incluidos en la solución
• Dependencias a nivel de proyecto
• Metadatos y configuración de la solución
• Vinculación de definiciones para configuraciones específicas del entorno

El archivo .zip resultante es independiente y está listo para cargarse en Orchestrator.

Empaquetado después de la restauración

Para obtener los mejores resultados, ejecuta restore antes de pack para garantizar que se resuelvan todas las dependencias:

# 1. Restore dependenciesuipcli solution restore C:\Solutions\MySolution \  --restoreFolder C:\Output\Dependencies \  --traceLevel Information# 2. Pack with explicit versionuipcli solution pack C:\Solutions\MySolution \  --output C:\Output \  --version 1.2.3 \  --traceLevel Verbose

Ubicación de salida del paquete

El archivo .zip empaquetado se coloca en el directorio especificado por --output. Si el directorio no existe, se creará automáticamente.

Rutas de salida típicas

Azure DevOps:

--output $(Build.ArtifactStagingDirectory)

Acciones de GitHub:

--output ${{ runner.temp }}/packages

Jenkins:

--output ${WORKSPACE}/output

Próximos pasos

Después de empacar, puedes:

1. Carga el paquete en Gestión de soluciones.
2. Almacénalo como un artefacto de compilación en tu plataforma CI/CD.
3. Versionarlo en un repositorio de artefactos (Artifactory, Azure Artifacts, etc.).