Publicación de la solución UIP

Sintaxis y opciones para `publicación de solución de uip`, que carga un `.zip` de solución a una fuente de soluciones.

uip solution publish carga una solución .zip , producida por uip solution pack , a una fuente de soluciones. De forma predeterminada, el paquete aterriza en la fuente del tenant; en su lugar, pasa --personal-workspace para apuntar a la fuente del Espacio de trabajo personal del usuario actual, o --feed <name-or-key> para apuntar a una fuente de carpeta específica. Una vez que se publica un paquete, es visible para uip solution packages list y puede implementarse con uip solution deploy run.

La publicación es una operación autenticada. Ejecuta uip login primero.

Nota:

Aún no se ha implementado un paquete publicado. La publicación solo carga el .zip en una fuente: no crea una carpeta de Orchestrator, no aprovisiona recursos ni hace que el paquete sea ejecutable. Impleméntelo con uip solution deploy run antes de que aparezca en la lista de procesos o pueda iniciarse como un trabajo.

Sinopsis

uip solution publish <packagePath> \
  [--personal-workspace | --feed <name-or-key>] \
  [--package-name <name>] [--package-version <version>] \
  [--wait] [--timeout <seconds>] [--poll-interval <ms>] \
  [--login-validity <minutes>]

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

Argumentos

• <packagePath> (obligatorio) : ruta a un paquete .zip producido por uip solution pack. El archivo debe existir y tener una extensión .zip; cualquier otra cosa falla con un resultado Failure. Un .nupkg (un solo paquete de proyecto, por ejemplo, de uip maestro flow pack) se rechaza explícitamente; en su lugar, empaqueta la solución que lo contiene.

Opciones

Largo	Valor	Predeterminado	Descripción
--personal-workspace	Marca	Desactivado	Cargar en la fuente del Espacio de trabajo personal del usuario actual en lugar de la fuente del tenant. Resuelve la clave de la carpeta del espacio de trabajo de Orchestrator automáticamente. Mutuamente exclusivo con --feed.
--feed <name-or-key>	text	—	Publicar en una fuente por su nombre o clave de carpeta (de solution feeds list) en lugar de la fuente del tenant. Mutuamente exclusivo con --personal-workspace.
--package-name <name>	text	nombre de la .zip	Publicar con este nombre en lugar de con el que .zip estaba empaquetado. Reescribe el solutionMetadata.json del archivo en la memoria (con una nueva clave de versión del paquete): el archivo en el disco permanece intacto y los paquetes de proyectos incluidos mantienen sus propios nombres/versiones. Solo funciona en un paquete producido por uip solution pack.
--package-version <version>	text	versión de la .zip	Publicar en esta versión en lugar de en la que .zip estaba empaquetada. Úselo para borrar un mensaje "la versión ya existe" rechazo cuando tienes el .zip empaquetado pero no el origen de la solución, sin volver a empaquetar. La misma reescritura en memoria que --package-name.
--wait	Marca	Desactivado	Espere hasta que el paquete publicado alcance el estado Ready o Active antes de volver.
--timeout <seconds>	segundos	360	Tiempo de espera de sondeo del estado del paquete (solo relevante con --wait).
--poll-interval <ms>	ms	5000	Milisegundos entre sondeos de estado de paquete.
--login-validity <minutes>	minutos	10	Minutos mínimos antes de la caducidad del token para desencadenar una actualización.

Ejemplos

Mínimo

uip solution publish ./dist/my-solution_1.0.0.zip

Volver a publicar el mismo archivo.zip bajo una nueva versión

uip solution publish ./dist/my-solution_1.0.0.zip --package-version 1.0.1

Utilízalo cuando la fuente haya rechazado el paquete porque su nombre+versión ya existe y tienes el .zip pero no el origen de la solución. --package-name funciona de la misma manera para el nombre.

Publicar en el espacio de trabajo personal del usuario actual

uip solution publish ./dist/my-solution_1.0.0.zip --personal-workspace

Publicar en una fuente con nombre

uip solution publish ./dist/my-solution_1.0.0.zip --feed Finance

Scripting: paquete de cadena → publicar y capturar la clave de versión del paquete

uip solution pack ./my-solution ./dist --version 1.2.0
KEY=$(uip solution publish ./dist/my-solution_1.2.0.zip --output-filter "Data.PackageVersionKey" --output plain)
echo "Published version key: $KEY"

Forma de datos (--json de salida)

{
  "Code": "SolutionPublish",
  "Data": {
    "Status": "Package is published to Orchestrator but not yet deployed",
    "PackageVersionKey": "a1b2c3d4-0000-0000-0000-000000000001",
    "PackageName": "my-solution",
    "PackageVersion": "1.0.0",
    "State": "Ready",
    "NextSteps": "Package is published to Orchestrator but not yet deployed. Deploy/activate it into an Orchestrator folder before it appears in the processes list or can be started as a job."
  }
}

• PackageVersionKey — GUID que identifica esta versión específica del paquete en la fuente.
• PackageName / PackageVersion: los valores del paquete (o la anulación --package-name/--package-version); reutilizarlos en deploy run --package-name --package-version.
• State: solo presente cuando se utilizó --wait; el estado del paquete terminal (Ready o Active).

Conflictos de versión

La publicación de un paquete cuyo name + version ya existe en la fuente de destino falla con un error descriptivo. O bien:

• Incrementar la versión y volver a empaquetar: uip solution pack <solution-path> <output-path> --version <new-version>, o
• Volver a publicar el mismo .zip en una nueva versión sin volver a empaquetar: uip solution publish <package-path> --package-version <new-version>.

Comandos relacionados

• uip solution pack — produce el .zip para publicar.
• uip solution feeds list : busca el nombre o clave de una fuente para --feed.
• uip solution packages list : consulta las versiones publicadas.
• uip solution packages delete : elimina una versión publicada.
• uip solution deploy run : implementa el paquete publicado en Orchestrator.

Ver también

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