paquete de soluciones de uip

Sintaxis y opciones para el `paquete de soluciones uip`, que produce un `.zip` implementable desde un directorio de soluciones o un archivo de paquete `.uis`.

uip solution pack produce un paquete .zip implementable a partir de un directorio de soluciones (que contiene un manifiesto .uipx ) o desde un archivo de paquete .uis . El archivo resultante es lo que uip solution publish carga en la fuente del tenant, que uip solution deploy run puede implementar.

El paquete es una operación sin conexión: no se pone en contacto con Orchestrator excepto para resolver las dependencias de NuGet de las fuentes del tenant (o la fuente de la biblioteca de una carpeta de Orchestrator a través de --feed-folder), por lo que es seguro ejecutar dentro de los pasos de compilación que aún no tienen credenciales completas, como siempre que se cubra la resolución de dependencias.

Sinopsis

uip solution pack <solutionPath> [outputPath] \
  [--name <name>] [--version <version>] \
  [--dry-run] \
  [--skip-analyze] [--governance-file-path <path> | --automation-ops-profile <profile>] \
  [--nuget-sources-config-path <path>] [--exclude-configured-sources] [--feed-folder <name>] \
  [--signing-certificate-path <path>] [--signing-certificate-password <password>] [--signing-timestamp-server <url>] \
  [--author <text>] [--description <text>] [--release-notes <text>] [--project-url <url>] \
  [--repository-url <url>] [--repository-commit <sha>] [--repository-branch <branch>] [--repository-type <type>] \
  [--login-validity <minutes>]

El comando respeta las opciones globales y devuelve los códigos de salida estándar.

Argumentos

• <solutionPath> (obligatorio) : ruta a un directorio de soluciones (que contiene un manifiesto .uipx ) o un archivo .uis .
• (opcional) : directorio de salida donde se escribirá .zip [outputPath] Obligatorio a menos que se establezca --dry-run : omitirlo sin --dry-run falla con un puntero para añadir uno u otro.

Opciones

Núcleo

Largo	Valor	Predeterminado	Descripción
-n, --name <name>	text	nombre de la carpeta de la solución (o el nombre base del archivo .uis)	Nombre del paquete. El .zip empaquetado se llama <name>_<version>.zip.
-v, --version <version>	text	1.0.0	Versión del paquete. Aparece en el nombre del archivo de salida y es el valor pasado a --package-version el deploy run.
--dry-run	Marca	Desactivado	Ejecuta el proceso de paquete completo (sincronización de recursos, emisión de dependencia de runtime, validación de opciones de empaquetador) en una copia temporal desechable y descarta la salida. Captura los fallos en el tiempo de empaquetado (una dependencia que falta, una vinculación de recursos rota, un tipo de proyecto desempaquetable) sin producir un .zip ni escribir nada en la solución. No inspecciona el contenido del paquete producido, por lo que no puede garantizar que la fuente de la solución acepte el resultado. Hace que [outputPath] sea opcional.
--login-validity <minutes>	minutos	10	Minutos mínimos antes de la caducidad del token para desencadenar una actualización. Solo es relevante cuando la resolución de dependencias necesita una fuente de tenant.

Resolución de dependencias

Largo	Valor	Predeterminado	Descripción
--nuget-sources-config-path <path>	Ruta	—	Ruta a un archivo de configuración de fuentes de NuGet para resolver dependencias del proyecto.
--exclude-configured-sources	Marca	Desactivado	Resuelve las dependencias solo desde las fuentes del tenant y --nuget-sources-config-path. Elimina las fuentes integradas de UiPath y nuget.org: una dependencia que no esté en esas fuentes no se restaurará.
--feed-folder <name>	nombre o ruta	—	Resuelva las dependencias de la fuente de la biblioteca de esta carpeta de Orchestrator en lugar de cada fuente de tenant. Acepta un nombre de carpeta o una ruta completa.

Análisis de gobernanza

--skip-analyze, --governance-file-path y --automation-ops-profile controlan el analizador de flujo de trabajo que se ejecuta en cada proyecto de RPA en la solución. --governance-file-path y --automation-ops-profile son mutuamente excluyentes.

Largo	Valor	Predeterminado	Descripción
--skip-analyze	Marca	Desactivado	Omite el analizador de flujo de trabajo para cada proyecto de RPA. La compilación y la validación se siguen ejecutando: solo se omiten las reglas del analizador.
--governance-file-path <path>	Ruta	—	Analiza cada proyecto de RPA en comparación con este archivo de política de gobernanza local, en lugar de las reglas del analizador enviadas con WorkflowCompiler.
--automation-ops-profile <profile>	text	—	Analiza cada proyecto de RPA en comparación con la política de gobernanza publicada en AutomationOps para el tenant que ha iniciado sesión. El valor es el producto cuya política se descarga; por ejemplo, StudioWeb, Development, Business.

Un valor vacío para cualquiera de los marcadores de control (--governance-file-path "") se rechaza como un error, no se trata de forma silenciosa como "sin marcador";

Firma de paquetes

La firma de .nupkg de un proyecto ya empaquetado requiere la CLI dotnet en PATH.

Largo	Valor	Predeterminado	Descripción
--signing-certificate-path <path>	Ruta	—	Ruta a un certificado de firma de código .pfx. Cuando se establece, cada proyecto empaquetado .nupkg en la solución se firma antes de incluirse en la solución .zip.
--signing-certificate-password <password>	texto o env.VAR	—	Contraseña del certificado. Pasa env.ENV_NAME para leer desde una variable de entorno en lugar del historial del shell.
--signing-timestamp-server <url>	URL	—	URL del servidor de marca de tiempo para la firma.

Metadatos del paquete (trazabilidad de origen)

Estas marcas marcan los metadatos de trazabilidad en un archivo package.metadata.json en la raíz del archivo comprimido y en el archivo .nuspec de cada proyecto. No se requiere ninguno: omítelos todos y el paquete solo incluye el nombre, la versión y los dos valores predeterminados requeridos por WorkflowCompiler (author: "UiPath", description: "Created by UiPath" cuando no se anulan).

Largo	Valor	Predeterminado	Descripción
--author <text>	text	UiPath	Autor del paquete.
--description <text>	text	Created by UiPath	Descripción del paquete.
--release-notes <text>	text	—	Notas de la versión del paquete.
--project-url <url>	URL	—	URL de la idea de Automation Hub.
--repository-url <url>	URL	—	URL del repositorio de origen.
--repository-commit <sha>	text	—	Hash de confirmación del repositorio de origen.
--repository-branch <branch>	text	—	Rama del repositorio de origen.
--repository-type <type>	text	git (cuando se establece --repository-url)	Tipo de repositorio de origen. Solo se registra cuando --repository-url también está establecido.

Ejemplos

Mínimo

uip solution pack ./my-solution ./dist

Empaqueta la solución en ./my-solution en ./dist/my-solution_1.0.0.zip (versión predeterminada).

Común: nombre de pin y versión para una compilación de CI

uip solution pack ./my-solution ./dist --name invoices --version 1.2.0

Escribe ./dist/invoices_1.2.0.zip.

Validar sin empaquetar

uip solution pack ./my-solution --dry-run

Ejecuta el proceso de paquete completo en un directorio temporal y descarta la salida: útil como puerta previa a la implementación en CI, ya que detecta errores de vinculación de recursos, referencia de variables y dependencia de runtime sin necesidad de un outputPath.

Marcar metadatos de trazabilidad de origen

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --repository-url https://github.com/acme/repo \
  --repository-commit abc123 \
  --repository-branch main \
  --release-notes "v1.2.0"

Firmar proyectos empaquetados

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --signing-certificate-path ./cert.pfx \
  --signing-certificate-password env.UIPATH_SIGNING_CERTIFICATE_PASSWORD \
  --signing-timestamp-server http://timestamp.digicert.com

Omitir el analizador de flujo de trabajo

uip solution pack ./my-solution ./dist --version 1.2.0 --skip-analyze

La compilación y la validación se siguen ejecutando: solo se omiten las reglas del analizador.

Analizar contra una política de gobernanza de tenant

uip solution pack ./my-solution ./dist --version 1.2.0 --automation-ops-profile Development

Creación de scripts: captura la ruta de salida para el paso de publicación

PKG=$(uip solution pack ./my-solution ./dist --version 1.2.0 --output-filter "Data.Packages" --output plain)
uip solution publish "$PKG"

Forma de datos (--json de salida)

Paquete real:

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.2.0",
    "Packages": "./dist/my-solution_1.2.0.zip"
  }
}

• Package — identificador de <name>@<version> para la solución empaquetada.
• Packages — lista separada por comas de .zip rutas escritas en <outputPath>. Normalmente, una única ruta.

Ejecución en seco (--dry-run):

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.0.0",
    "DryRun": true,
    "Status": "Valid"
  }
}

Modos de fallo

• Falta outputPath sin --dry-run. Falla con un puntero para proporcionar un directorio de salida o pasar --dry-run.
• Marcadores de control en conflicto. --governance-file-path y --automation-ops-profile son mutuamente excluyentes; se rechaza un valor vacío para cualquiera de los dos.
• Ruta de salida dentro de un directorio de proyecto miembro. Rechazado: cualquier cosa escrita allí se empaquetaría en el propio paquete de ese proyecto en el siguiente paquete. Elige una ruta de salida fuera de los directorios del proyecto de la solución (por ejemplo, ./out en la raíz de la solución o un directorio completamente fuera de la solución).
• Tipo de proyecto no empaquetable. Nombra el tipo de proyecto y apunta a uip tools search / uip tools install <tool> para añadir la herramienta de empaquetado que lo gestiona (o uip update primero, si es un tipo recién añadido).

Comandos relacionados

• uip solution publish : carga el .zip empaquetado en la fuente de soluciones del tenant.
• uip solution upload : ruta alternativa que carga la solución a Studio Web para la edición interactiva en lugar de empaquetarla para la implementación.
• uip solution deploy run : implementa un paquete publicado en Orchestrator.

Ver también

• Tu primer proceso : empaquetar → publicar → implementar tutorial de ejecución.
• Información generaluip solution .