publication de la solution uip

Syntaxe et options pour `uip solution publish`, qui télécharge une solution `.zip` dans un flux de solution.

uip solution publish télécharge une solution .zip — produite par uip solution pack — vers un flux de solution. Par défaut, le package arrive dans le flux du locataire; transmettez --personal-workspace pour cibler le flux d’espace de travail personnel de l’utilisateur actuel à la place, ou --feed <name-or-key> pour cibler un flux de dossier spécifique. Une fois qu'un package est publié, il est visible par uip solution packages list et peut être déployé avec uip solution deploy run

La publication est une opération authentifiée. Exécutez d'abord uip login .

Remarque :

Un package publié n’est pas encore déployé. La publication charge uniquement le fichier .zip dans un flux — elle ne crée pas de dossier Orchestrator, n'enregistre pas de ressources et ne rend pas le package exécutable. Déployez-le avec uip solution deploy run avant qu'il n'apparaisse dans la liste des processus ou qu'il puisse être démarré en tant que tâche.

Synthèse

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>]

La commande respecte les options globales et renvoie les codes de sortie standard.

Arguments

• <packagePath> (requis) : chemin d'accès à un package .zip produit par uip solution pack. Le fichier doit exister et avoir une extension .zip; tout le reste échoue avec un résultat Failure. Un .nupkg (le package d’un projet unique, par exemple de uip maestro flow pack) est explicitement rejeté - compressez plutôt la solution d’encapsulation.

Options

Long	Valeur (Value)	Default	Description
--personal-workspace	Drapeau	désactivé	Téléchargez le flux dans le flux d'espace de travail personnel de l'utilisateur actuel au lieu du flux du locataire. Résout automatiquement la clé de dossier de l'espace de travail à partir d'Orchestrator. Capture mutuellement exclusive avec --feed.
--feed <name-or-key>	text	—	Publiez dans un flux par son nom ou sa clé de dossier (à partir de solution feeds list) au lieu du flux de locataire. Capture mutuellement exclusive avec --personal-workspace.
--package-name <name>	text	nom sur le .zip	Publiez sous ce nom au lieu de celui avec lequel .zip était packagé. Réécrit le solutionMetadata.json de l'archive en mémoire (avec une nouvelle clé de version de package): le fichier sur disque n'est pas modifié et les packages de projet groupés conservent leurs propres noms/versions. Fonctionne uniquement sur un package produit par uip solution pack.
--package-version <version>	text	à partir du .zip	Publiez sous cette version au lieu de celle avec laquelle .zip était packagé. Utilisez-le pour effacer une « version déjà existante »; rejeter lorsque vous avez le fichier .zip packagé, mais pas la source de la solution, sans procéder à un nouveau compressage. Même réécriture en mémoire que --package-name.
--wait	Drapeau	désactivé	Attendez que le package publié atteigne l’état Ready ou Active avant de revenir.
--timeout <seconds>	secondes	360	Délai d’interrogation de l’état du package (pertinent uniquement avec --wait).
--poll-interval <ms>	ms	5000	Millisecondes entre les interrogations de l’état du package.
--login-validity <minutes>	minutes	10	Nombre minimum de minutes avant l’expiration du jeton pour déclencher une actualisation.

Exemples

Minimum

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

Republiez le même fichier.zip sous une nouvelle version

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

Utilisez cette option lorsque le flux a rejeté le package, car son nom+version existe déjà et vous disposez de la .zip source de la solution, mais pas de la source de la solution. --package-name fonctionne de la même manière pour le nom.

Publier sur l’espace de travail personnel de l’utilisateur actuel

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

Publier dans un flux nommé

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

Scripting — pack de chaîne → publier et capturer la clé de version du package

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"

Format des données (--sortie json)

{
  "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 identifiant cette version spécifique du package dans le flux.
• PackageName / PackageVersion — les valeurs du package (ou le remplacement --package-name/--package-version); les réutiliser sur deploy run --package-name --package-version.
• State — présent uniquement lorsque --wait a été utilisé; l'état du package de terminal (Ready ou Active).

Conflits de version

La publication d'un package dont le name + version existe déjà dans le flux cible échoue avec une Error descriptive. Soit:

• Incrémenter la version et procéder au compressage: uip solution pack <solution-path> <output-path> --version <new-version>, ou
• Republiez le même .zip sous une nouvelle version sans procéder à un nouveau compressage: uip solution publish <package-path> --package-version <new-version>.

Commandes associées

• uip solution pack — produit le .zip à publier.
• uip solution feeds list — permet de trouver le nom ou la clé d'un flux pour --feed.
• uip solution packages list — voir les versions publiées.
• uip solution packages delete — supprime une version publiée.
• uip solution deploy run — déployer le package publié dans Orchestrator.

Voir également

• Votre premier pipeline — empaqueter → publier → déployer l'exécution.
• Authentification — Gestion des sessions.
• Vue d’ensemble du typeuip solution .