pack de solution uip

Syntaxe et options pour `uip solution pack`, qui produit un fichier `.zip` déployable à partir d'un répertoire de solution ou d'un fichier de bundle `.uis`.

uip solution pack produit un package .zip déployable à partir d'un répertoire de solution (contenu un manifeste .uipx ) ou d'un fichier de bundle .uis . L’archive résultante est ce que uip solution publish télécharge dans le flux de locataire, que uip solution deploy run peut ensuite déployer.

La compression est une opération hors ligne. Elle ne contacte pas Orchestrator, sauf pour résoudre les dépendances NuGet à partir des flux de locataires (ou du flux de bibliothèque d'un dossier Orchestrator via --feed-folder) afin qu'il soit possible d'exécuter en toute sécurité dans des étapes de création qui ne disposent pas encore d'informations d'identification complètes, comme tant que la résolution des dépendances est couverte.

Synthèse

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

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

Arguments

• <solutionPath> (requis) : Chemin d'accès à un répertoire de solution (contenant un manifeste .uipx ) ou un fichier .uis .
• [outputPath] (facultatif) : le répertoire de sortie où le package .zip sera écrit. Obligatoire si --dry-run n'est pas défini — l'omettre sans --dry-run échoue avec un pointeur pour ajouter l'une ou l'autre.

Options

Core

Long	Valeur (Value)	Default	Description
-n, --name <name>	text	nom du dossier de la solution (ou nom de base du fichier .uis)	Nom du package. Le package .zip se nomme <name>_<version>.zip.
-v, --version <version>	text	1.0.0	Version du package. Apparaît dans le nom du fichier de sortie et correspond à la valeur transmise à --package-version le deploy run.
--dry-run	Drapeau	désactivé	Exécutez le pipeline de pack complet (synchronisation des ressources, émission de dépendances du runtime, validation de l'option du package) sur une copie temporaire jeton et supprimez la sortie. Détecte les échecs de compression — une dépendance manquante, une liaison de ressources interrompue, un type de projet non compressé — sans produire de .zip ni écrire quoi que ce soit dans la solution. Elle n’inspecte pas le contenu du package produit et ne peut donc pas garantir que le flux de solution acceptera le résultat. rend [outputPath] facultatif.
--login-validity <minutes>	minutes	10	Nombre minimum de minutes avant l’expiration du jeton pour déclencher une actualisation. Uniquement pertinent lorsque la résolution des dépendances nécessite un flux de locataire.

Résolution des dépendances

Long	Valeur (Value)	Default	Description
--nuget-sources-config-path <path>	Chemin d'accès	—	Chemin d’accès à un fichier de configuration des sources NuGet pour résoudre les dépendances du projet.
--exclude-configured-sources	Drapeau	désactivé	Résolvez les dépendances uniquement à partir des flux de locataires et de --nuget-sources-config-path. Dépose les flux UiPath et nuget.org intégrés — une dépendance non basée sur ces flux ne parvient pas à être restaurée.
--feed-folder <name>	nom ou chemin	—	Résolvez les dépendances à partir du flux de bibliothèque de ce dossier Orchestrator au lieu de chaque flux de locataire. Accepte un nom de dossier ou un chemin complet.

Analyse de la gouvernance

--skip-analyze, --governance-file-path et --automation-ops-profile contrôlent l'analyseur de workflow qui s'exécute sur chaque projet RPA dans la solution. --governance-file-path et --automation-ops-profile sont mutuellement exclusifs.

Long	Valeur (Value)	Default	Description
--skip-analyze	Drapeau	désactivé	Ignorez l’analyseur de workflow pour chaque projet RPA. La compilation et la validation continuent de s’exécuter: seules les règles d’analyse sont ignorées.
--governance-file-path <path>	Chemin d'accès	—	Analysez chaque projet RPA par rapport à ce fichier de politique de gouvernance locale, au lieu des règles d’analyse fournies avec WorkflowCompiler.
--automation-ops-profile <profile>	text	—	Analysez chaque projet RPA par rapport à la politique de gouvernance publiée dans AutomationOps pour le locataire connecté. La valeur correspond au produit dont la politique est téléchargée, par exemple StudioWeb, Development, Business.

Une valeur vide pour l’un ou l’autre des indicateurs de gouvernance (--governance-file-path "") est rejetée comme une erreur et non traitée silencieusement comme « aucun indicateur».

Signature du package

La signature du .nupkg d'un projet déjà compressé nécessite la CLI dotnet sur PATH.

Long	Valeur (Value)	Default	Description
--signing-certificate-path <path>	Chemin d'accès	—	Chemin d'accès à un certificat de signature de code .pfx. Lorsque cette option est définie, chaque projet compressé .nupkg dans la solution est signé avant d'être intégré à la solution .zip.
--signing-certificate-password <password>	texte ou env.VAR	—	Mot de passe du certificat. Transmettez env.ENV_NAME pour lire à partir d'une variable d'environnement au lieu de l'historique du shell.
--signing-timestamp-server <url>	URL	—	URL du serveur d’horodatage pour la signature.

Métadonnées des packages (traçage des sources)

Ces indicateurs marquent les métadonnées de traçabilité dans un fichier package.metadata.json à la racine de l'archive et dans le fichier .nuspec de chaque projet. Aucun n'est requis - omettez-les tous et le package ne transporte que le nom, la version et les deux valeurs par défaut requises par WorkflowCompiler (author: "UiPath", description: "Created by UiPath" lorsqu'ils ne sont pas remplacés).

Long	Valeur (Value)	Default	Description
--author <text>	text	UiPath	Auteur du package.
--description <text>	text	Created by UiPath	Description du package.
--release-notes <text>	text	—	Notes de publication du package.
--project-url <url>	URL	—	URL de l'idée Automation Hub.
--repository-url <url>	URL	—	URL du référentiel source.
--repository-commit <sha>	text	—	Hachage de validation du référentiel source.
--repository-branch <branch>	text	—	Branche du référentiel source.
--repository-type <type>	text	git (lorsque --repository-url est défini)	Type du référentiel source. Enregistré uniquement lorsque --repository-url est également défini.

Exemples

Minimum

uip solution pack ./my-solution ./dist

Compresse la solution à ./my-solution dans ./dist/my-solution_1.0.0.zip (version par défaut).

Commun — nom et version du code PIN pour une version CI

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

Écrit ./dist/invoices_1.2.0.zip.

Valider sans mise en package

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

Exécute le pipeline de compression complet par rapport à un répertoire temporaire et supprime la sortie - utile comme passerelle de pré-déploiement dans CI, car il détecte les erreurs de liaison de ressources, de référence de variables et de dépendance du runtime sans nécessiter un outputPath.

Métadonnées de traçabilité de la source

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"

Signer les projets compressés

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

Ignorer l’analyseur de workflow

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

La compilation et la validation continuent de s’exécuter: seules les règles d’analyse sont ignorées.

Analyser par rapport à une politique de gouvernance de locataire

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

Scripts — capturez le chemin de sortie de l'étape de publication

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

Format des données (--sortie json)

Pack réel:

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

• Package — <name>@<version> identifiant de la solution packagée.
• Packages — Liste de .zip chemin(s) séparés par des virgules écrites dans <outputPath>. Généralement un chemin unique.

Test (--dry-run):

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

Modes d’échec

• outputPath manquant sans --dry-run. Échec avec un pointeur pour fournir un répertoire de sortie ou transmettre --dry-run.
• Indicateurs de gouvernance conflictuels. --governance-file-path et --automation-ops-profile sont mutuellement exclusifs; une valeur vide pour l'un ou l'autre est rejetée.
• Chemin de sortie dans un répertoire de projet membre. Refuser: tout ce qui y est écrit serait compressé dans le package suivant de ce projet. Choisissez un chemin de sortie situé en dehors des répertoires du projet de solution (par exemple ./out à la racine de la solution ou un répertoire entièrement en dehors de la solution).
• Type de projet ne peut pas être compressé. Nommez le type de projet et pointez sur uip tools search / uip tools install <tool> pour ajouter l'outil de packaging qui le gère (ou uip update d'abord, s'il s'agit d'un type récemment ajouté).

Commandes associées

• uip solution publish — télécharge le fichier .zip compressé dans le flux de solution du locataire.
• uip solution upload — chemin alternatif qui charge la solution dans Studio Web pour la modification interactive au lieu de la compresser pour le déploiement.
• uip solution deploy run — déploie un package publié dans Orchestrator.

Voir également

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