Hochladen und Löschen von Lösungspaketen

Schritte zum Hochladen von Lösungspaketen in den Orchestrator und zum Löschen von Paketen, wenn sie nicht mehr benötigt werden.

Nach dem Packen einer Lösung können Sie das Paket im Orchestrator zu Lösungen hochladen. Sie können Pakete auch löschen, wenn sie nicht mehr benötigt werden.

Tipp:

Für Orchestrator-Instanzen, die von einer privaten Zertifizierungsstelle signiert wurden (z. B. UiPath Automation Suite), akzeptieren sowohl upload-package als auch delete-package auch --ca-cert und --pinnedpubkey -Parameter. Szenarien und Beispiele finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .

Paket wird hochgeladen

Der Befehl upload-package verschiebt eine Lösungsdatei .zip zu Lösungen.

Befehlssyntax

uipcli solution upload-package <package-path> [options]

Parameter

Parameter	Beschreibung	Erforderlich
<package-path>	Pfad zur .zip -Paketdatei	Ja
-U	Orchestrator-URL	Ja
-T	Name des Mandanten	Ja
-A	Name der Organisation	Ja
-I	Externe App-ID	Ja
-S	Externer App-Schlüssel	Ja
--applicationScope	Optionale Scopes (Standardwerte angewendet)	Nein
--traceLevel	Protokollierungsstufe	Nein
--ca-cert	Datei(en) der vertrauenswürdigen Stammzertifizierungsstelle (PEM, DER oder PKCS#7) für das TLS-Zertifikat von Orchestrator/Identity. Wiederholen oder durch Komma trennen. Siehe Vertrauenswürdigen benutzerdefinierten Zertifikaten.	Nein
--pinnedpubkey	Heften Sie den öffentlichen Blattschlüssel an (sha256//<base64>). Siehe Vertrauenswürdigen benutzerdefinierten Zertifikaten.	Nein

Authentication

Siehe Authentifizierung und Scopes für erforderliche Scopes und Einrichtung einer externen App.

Beispiel

uipcli solution upload-package C:\Output\MySolution.1.2.3.zip \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Verwenden von CI/CD-Geheimnissen

Codieren Sie niemals Anmeldeinformationen in Skripten hart. Verwenden Sie die Geheimnisverwaltung Ihrer Plattform:

Azure DevOps

- script: |
    uipcli solution upload-package $(Build.ArtifactStagingDirectory)\MySolution.$(Build.BuildId).zip \
      -U $(orchestratorUrl) \
      -T $(orchestratorTenant) \
      -A $(organizationName) \
      -I $(externalAppId) \
      -S $(externalAppSecret) \
      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
      --traceLevel Information
  displayName: 'Upload Solution Package'

GitHub-Aktionen

- name: Upload Solution Package
  run: |
    uipcli solution upload-package ${{ runner.temp }}/packages/MySolution.${{ github.run_number }}.zip \
      -U ${{ secrets.ORCHESTRATOR_URL }} \
      -T ${{ secrets.ORCHESTRATOR_TENANT }} \
      -A ${{ secrets.ORG_NAME }} \
      -I ${{ secrets.EXTERNAL_APP_ID }} \
      -S ${{ secrets.EXTERNAL_APP_SECRET }} \
      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
      --traceLevel Information

Was passiert nach dem Upload

Nach dem Hochladen:

• Wird in Lösungen im Orchestrator angezeigt.
• Kann in jedem Zielordner bereitgestellt werden.
• Ist versioniert und nachverfolgt.
• Kann von anderen Pipelines oder Benutzern heruntergeladen werden.

Deleting a package

Der Befehl delete-package entfernt ein Lösungspaket aus Lösungen.

Befehlssyntax

uipcli solution delete-package <package-name> [options]

Parameter

Parameter	Beschreibung	Erforderlich
<package-name>	Name des Pakets ( ohne .zip -Erweiterung)	Ja
-v oder --version	Zu löschende Versionsnummer	Ja
-U	Orchestrator-URL	Ja
-T	Name des Mandanten	Ja
-A	Name der Organisation	Ja
-I	Externe App-ID	Ja
-S	Externer App-Schlüssel	Ja
--applicationScope	Optionale Scopes (Standardwerte angewendet)	Nein
--traceLevel	Protokollierungsstufe	Nein
--ca-cert	Datei(en) der vertrauenswürdigen Stammzertifizierungsstelle (PEM, DER oder PKCS#7) für das TLS-Zertifikat von Orchestrator/Identity. Wiederholen oder durch Komma trennen. Siehe Vertrauenswürdigen benutzerdefinierten Zertifikaten.	Nein
--pinnedpubkey	Heften Sie den öffentlichen Blattschlüssel an (sha256//<base64>). Siehe Vertrauenswürdigen benutzerdefinierten Zertifikaten.	Nein

Hinweis:

Wenn Sie die Authentifizierung einer externen Anwendung verwenden, ohne den Parameter --applicationScope anzugeben, wendet die CLI automatisch diese standardmäßigen AutomationSolution-Scopes an:

Solutions.Packages Solutions.Deployments OR.Execution

Authentication

Siehe Authentifizierung und Scopes für erforderliche Scopes und Einrichtung einer externen App.

Beispiel

uipcli solution delete-package MySolution \
  -v 1.2.3 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Wann Pakete gelöscht werden sollen

Gängige Szenarien zum Löschen von Paketen:

• Bereinigungspipelines – Entfernen Sie alte Versionen nach der erfolgreichen Bereitstellung.
• Fehlgeschlagene Builds – Löschen Sie ungültige Pakete, die nicht bereitgestellt werden sollen.
• Aufbewahrungsrichtlinien – Erzwingen von Paketlebenszyklusregeln (z. B. nur die letzten 10 Versionen beibehalten).
• Speicherverwaltung – Geben Sie Speicherplatz in Lösungen frei.

Pipeline-Beispiel – Bereinigung alter Versionen

# Delete old version after deploying new one
uipcli solution delete-package MySolution \
  -v 1.2.2 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I $(externalAppId) \
  -S $(externalAppSecret) \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"

Paketbenennung

Der Paketname, der bei Upload- und Löschvorgängen verwendet wird, wird vom Lösungsnamen und nicht vom Dateinamen abgeleitet.

Beispiel

• Packbefehl erstellt: MySolution.1.2.3.zip
• Paketname zum Löschen: MySolution
• Version: 1.2.3

Nächste Schritte

Nach dem Hochladen eines Pakets können Sie:

1. Laden Sie Bereitstellungskonfigurationen herunter.
2. Stellen Sie die Lösung in einer Zielumgebung bereit .