solution UiP

Créez, publiez et déployez des solutions UiPath à l’aide de l’outil « uip solution », depuis l’élaboration et le compression vers l’activation Orchestrator.

uip solution crée, publie et déploie des solutions — des bundles de projets UiPath (workflows RPA, cas de test, bibliothèques, agents, flux Maestro et applications) livrés et versionnés sous forme d'artefact unique. Une solution est définie par un manifeste .uipx à la racine d'un répertoire de solution; chaque projet répertorié dans ce manifeste se déplace à travers le processus de compression, de publication et de déploiement.

La plupart de votre temps dans cet outil est consacré à trois étapes: élaborer ou modifier une solution localement (init, projects), l'empaqueter dans un .zip (pack) et déployer la version packagée dans Orchestrator (publish + deploy run). Voir Votre premier pipeline pour la présentation de bout en bout.

Taxonomie des verbes

Famille de verbes	Activer le	Objectif
init	Système de fichiers local	Élaborez un répertoire de solution .uipx vide.
projects	.uipx local/cloud	Ajoutez, importez, répertoriez, supprimez, publiez ou resynchronisez des projets enregistrés dans le manifeste de la solution.
resources	Solution locale	Répertoriez, obtenez, ajoutez, supprimez, modifiez et actualisez les déclarations de ressources (files d'attente, ressources, compartiments, processus, connexions, etc.) dans une solution.
pack	Solution locale	Générez un package .zip déployable à partir d’un répertoire de solution ou d’un fichier .uis. Valide également via --dry-run, signe les packages et tampons les métadonnées de traçabilité source.
publish	Flux de locataire/Espace de travail personnel/Flux de dossier	Chargez un package .zip compressé dans un flux de solution UiPath.
upload	Studio Web	Téléchargez une solution de modification basée sur le navigateur dans Studio Web.
download	Studio Web	Téléchargez et extrayez éventuellement une solution Studio Web par ID.
list (Preview)	Studio Web/système de fichiers local	Répertoriez vos solutions Studio Web ou analysez un répertoire pour les solutions locales.
delete	Studio Web	Supprimer une solution Studio Web par ID (nécessite -y, --yes).
cleanup	Système de fichiers local	Supprimez les éléments inutilisés de chaque projet d'une solution.
restore	Système de fichiers local	Résolvez les dépendances NuGet pour chaque projet dans une solution.
feeds	Locataire/Espace de travail/dossiers	Répertoriez les flux (emplacements de publication) dans lesquels vous pouvez publier ou déployer.
packages	Flux de locataire/Espace de travail personnel/Flux de dossier	Répertorier, télécharger et supprimer les packages de solutions publiés (la suppression nécessite -y, --yes).
deploy	Orchestrator	Installer un nouveau déploiement (run), déplacer un déploiement existant vers une nouvelle version de package en place (upgrade), vérifier l'état, activer, désinstaller (nécessite -y, --yes) et modifier les fichiers de configuration du déploiement.

uip solution est fourni par le plug-in @uipath/solution-tool . S’il n’est pas encore installé, uip tools install solution l’ajoute. Voir Outils.

Remarque :

projects était précédemment documenté sous la forme project (singulaire). Le formulaire unique fonctionne toujours - il est conservé en tant qu'alias masqué et obsolète pour la rétrocompatibilité - mais projects est canonique à l'avenir.

Synthèse

uip solution init <solutionName>

uip solution projects add <projectPath> [--solution-folder <path>]
uip solution projects import --source <path> [--solution-folder <path>]
uip solution projects remove <projectPath> [--solution-folder <path>]
uip solution projects list [--solution-folder <path>]
uip solution projects publish --project-name <name> --package-name <name> --package-version <version> [--folder-name <name>]
uip solution projects resync [project-name] [--sync-option <Sync|Reset>]

uip solution resources list [--solution-folder <path>] [--kind <kind>] [--search <term>] [--source <all|local|remote>]
uip solution resources get <resource-key> [--solution-folder <path>]
uip solution resources add --source <local|remote> --kind <kind> --name <name>
uip solution resources remove <resource-key>
uip solution resources edit <resource-key> --patch <json>
uip solution resources refresh [--solution-folder <path>]

uip solution pack <solutionPath> [outputPath] [--name <name>] [--version <version>] [--dry-run]
uip solution publish <packagePath> [--feed <name-or-key> | --personal-workspace] [--wait]
uip solution upload <solutionPath>
uip solution download <solution-id> [-d <destination>] [--extract]
uip solution list [--local [directory]] [--check-cloud]
uip solution delete <solution-id> -y
uip solution cleanup <solutionPath> [--dry-run]
uip solution restore <solutionPath>
uip solution feeds list

uip solution packages list [--personal-workspace | --feed <name-or-key>] [--limit <n>] [--offset <n>]
uip solution packages download <packageName> [packageVersion] [-d <path>]
uip solution packages delete <packageName> <packageVersion> --yes [--personal-workspace | --feed <name-or-key>]

uip solution deploy run --name <n> --package-name <n> --package-version <v> --folder-name <n> [--parent-folder-path <path> | --personal-workspace] [--feed <name-or-key>] [-y]
uip solution deploy upgrade <deployment-key> [--version <v>] [--no-wait]
uip solution deploy status <pipeline-deployment-id>
uip solution deploy activate <deployment-name>
uip solution deploy list [--folder-path <path>] [--operation-status <s>] [--activation-status <s>]
uip solution deploy uninstall <deployment-name> -y
uip solution deploy config get <package-name> [--package-version <v>] [-d <path>] [--format json|yaml]
uip solution deploy config set <file> [--all] <args...>
uip solution deploy config link <file> <resource> --name <n> [--folder-path <path>]
uip solution deploy config unlink <file> <resource>

Chaque sous-commande respecte les options globales (--output, --output-filter, --log-level, --log-file) et renvoie les codes de sortie standard. La sortie par défaut est JSON. deploy run ne met jamais à jour un déploiement existant — il en crée un nouveau ou, si --name est déjà déployé, refuse à moins que -y, --yes ne soit transmis (qui installe une deuxième copie indépendante); pour déplacer un déploiement existant vers une nouvelle version de package en place, utilisez deploy upgrade. Les lignes de synthèse pack/publish/packages/deploy ci-dessus sont abrégées - voir la page propre de chaque commande pour la liste complète et vérifiée des indicateurs.

Flux de bout en bout

┌──────────┐   ┌────────────┐   ┌──────────┐   ┌──────────────┐   ┌──────────────────┐
│ solution │   │ solution   │   │ solution │   │ solution     │   │ solution deploy  │
│ init     │ → │ projects   │ → │ pack     │ → │ publish      │ → │ run              │
│          │   │ add/import │   │          │   │ (tenant feed)│   │ (Orchestrator)   │
└──────────┘   └────────────┘   └──────────┘   └──────────────┘   └──────────────────┘

1. Élaborer. uip solution init my-solution crée un répertoire avec un manifeste .uipx vide (plus AGENTS.md/CLAUDE.md fichiers d'information).
2. Renseigner. uip solution projects add ./my-solution/my-project enregistre un sous-dossier de projet, ou uip solution projects import --source ./external copie un projet externe dans.
3. Créer un package uip solution pack ./my-solution ./dist --version 1.0.0 produit ./dist/my-solution_1.0.0.zip.
4. Publier. uip solution publish ./dist/my-solution_1.0.0.zip charge le .zip dans un flux de solution.
5. Déployer. uip solution deploy run --name my-deployment --package-name my-solution --package-version 1.0.0 --folder-name MySolution --parent-folder-path Shared crée un dossier Orchestrator, enregistre les ressources (files d'attente, ressources, processus) et active la solution.

Pour la création interactive, remplacez l'étape 3 par uip solution upload ./my-solution pour ouvrir la solution dans UiPath Studio Web au lieu de la compresser pour le déploiement.

Chaque étape de ce flux est documentée sur la page liée dans la table de taxonomie des verbes ci-dessus. L'exemple complet se trouve dans votre premier pipeline.

Modèle d’authentification et de flux

Commandes qui communiquent avec Orchestrator ou un flux de solution — publish, upload, download, list (mode cloud), delete, packages *, feeds list, resources list/add/refresh (chemins à distance), et toutes les sous-commandes deploy … — nécessitent une session active. Exécutez uip login une fois. Voir Authentification.

Plusieurs de ces commandes acceptent en outre --personal-workspace ou --feed <name-or-key> pour cibler un flux de solution spécifique au lieu du flux de locataire par défaut. Utilisez uip solution feeds list pour trouver le nom ou la clé d'un flux.

Les commandes locales (init, projects add/import/remove/list, pack, cleanup, restore, resources get/remove/edit, list --local) fonctionnent hors ligne par rapport aux fichiers sur disque.

Voir également

• uip solution feeds — répertorier les flux pour publish --feed.
• uip solution list, uip solution download — recherchez et récupérez des solutions Studio Web.
• uip solution cleanup, uip solution restore — maintenance du projet local avant la compression.
• Votre premier pipeline — présentation pratique de pack → publication → exécution de déploiement.
• Outils (extensions) : comment l’outil de solution est distribué et versionné.
• Authentification et configuration — configuration de la session et valeurs par défaut par locataire.
• Options globales et codes de sortie — contrats partagés par chaque verbe.
• uip or — CRUD des ressources Orchestrator (ressources, compartiments, files d'attente, bibliothèques, déclencheurs, webhooks), avec les tâches, les processus et les dossiers.