UIP-Agent-Veröffentlichung

uip agent publish verpackt ein Agent-Projekt und pusht das resultierende Paket als neue Lösungspaketversion in Orchestrator. Das zurückgegebene PackageVersionKey ist die Eingabe für uip agent deploy.

Intern führt publish eine mehrstufige Pipeline aus:

1. Wenn es sich bei der Eingabe um ein Verzeichnis handelt, wird die Projektstruktur validiert und in ein temporäres .uis gepackt.
2. Es extrahiert die .uis, migriert alle agent.json / resource.json nach unten in die erwartete storageVersion (derzeit 44.0.0) und führt eine Neupaketierung durch.
3. Er erstellt eine Lösung uip solution pack , um eine Lösung .zip (mit einer oder mehreren .nupkg -Dateien) zu erstellen.
4. Die Lösung wird hochgeladen – entweder über die Standard-Lösungs-API (Standard) oder direkt in den Paket-Feed des Orchestrator, wenn --direct festgelegt ist.

Erfordert eine aktive CLI-Sitzung (uip login).

Zusammenfassung

uip agent publish [path] [-t <tenant>] [-l <locationKey>] [-n <name>]
                  [--package-version <version>]
                  [--folder-id <id>] [--direct]
                  [--login-validity <minutes>]

Alle uip agent publish -Aufrufe berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Argumente

• [path] (optional, Standard .) – Der Pfad zum Agent-Projektverzeichnis oder zu einer bereits gepackten .uis -Datei. Eine .uis -Eingabe überspringt den Packschritt; alles nachgelagert (Migrieren, Neupacken, Lösungspacken, Hochladen) wird noch ausgeführt.

Optionen

Markieren	Standard	Zweck
-t, --tenant <tenant>	Mandanten anzumelden	Zielmandant. Erforderlich, wenn die Anmeldesitzung keinen Standardmandanten hat.
-l, --location-key <guid>	–	Optionale GUID, die an den Lösungs-API-Aufruf packagesUpload weitergeleitet wird (wird nur vom standardmäßigen Upload-Pfad verwendet).
-n, --name <name>	Agent metadata.name → Pfadbasisname	Paketname. Wird der Dateiname .uis / .zip und der Paketname im Orchestrator.
--package-version <version>	1.0.0	Versionszeichenfolge für das hochgeladene Paket.
--folder-id <id>	ID der Organisationseinheit des Anmeldeordners	ID der Organisationseinheit des Orchestrator-Ordners. Wird nur abgefragt, wenn --direct festgelegt ist; der standardmäßige Solutions-Upload-Pfad ignoriert dies.
--direct	aus	Laden Sie jedes .nupkg direkt in den Paketfeed von Orchestrator hoch und erstellen Sie unter Umgehung der Lösungs-API ein Release pro Paket. Verwenden Sie dies, wenn der Lösungsbereitstellungspfad fehlschlägt oder Sie möchten, dass Releases sofort in einem bestimmten Ordner erstellt werden.
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich. Siehe Authentifizierung.

Beispiele

# Publish the current project to the login tenant
uip agent publish --package-version 1.0.0

# Publish a specific project folder
uip agent publish ./my-agent --package-version 1.0.0

# Publish a pre-packed .uis
uip agent publish ./dist/my-agent.uis --package-version 1.0.0

# Direct upload into a specific folder (creates releases in that folder)
uip agent publish ./my-agent \
  --package-version 1.1.0 \
  --direct --folder-id 42

# Override tenant and name
uip agent publish ./my-agent \
  -t production \
  -n invoice-agent \
  --package-version 2.0.0

Datenform (--output json)

Standard-Upload-Pfad (Code: "AgentPublish"):

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published successfully",
    "Name": "my-agent",
    "Version": "1.0.0",
    "PackageVersionKey": "a1b2c3d4-0000-0000-0000-000000000050"
  }
}

PackageVersionKey ist das, was Sie an uip agent deploy übergeben.

--direct Pfad

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published to Orchestrator (direct)",
    "Name": "my-agent",
    "Version": "1.0.0",
    "Releases": [
      {
        "Name": "InvoiceAgent",
        "Key": "a1b2c3d4-0000-0000-0000-000000000055",
        "ProcessKey": "com.uipath.agent.InvoiceAgent"
      }
    ]
  }
}

Im Modus --direct wird jedes .nupkg innerhalb der Lösung .zip separat hochgeladen und es wird ein Release pro Paket erstellt. Es gibt kein PackageVersionKey; Das entsprechende Konzept ist das Key pro Release – direkt mit uip agent run start verwendbar.

Migrationsverhalten

publish erwartet ein storageVersion nicht höher als 44.0.0, während neue Studio Web-Projekte 47.0.0 sein können. Es schreibt agent.json und Tool- resource.json -Dateien innerhalb des temporären Extraktionsverzeichnisses in das erwartete Schema neu, bevor es neu gepackt wird. Ihr Projekt auf der Festplatte wird nie geändert.

Jede migrierte Datei erzeugt einen Message -Protokolleintrag (z. B. Migrated /tmp/…/agent.json: storageVersion 47.0.0 → 44.0.0).

Zugehörig

• uip agent pack – der lokale Packschritt (intern enthalten).
• uip agent deploy – Installieren und aktivieren Sie die hochgeladene Paketversion.
• uip agent validate – Führen Sie vor der Veröffentlichung statische Prüfungen und Migrationen für Ihr Projekt auf der Festplatte durch.

Siehe auch

• Authentifizierung – Sitzungen, Mandanten und --login-validity.
• Orchestrator: Aufträge – bei denen freigegebene Agent-Prozesse endgültig ausgeführt werden.
• Globale Optionen, Exitcodes.