Herunterladen von Lösungspaketen und Konfigurationen

Sie können Lösungspakete und Konfigurationsdateien für die Bereitstellung aus dem Bereich Lösungen im Orchestrator herunterladen. Dies ist nützlich für die Disaster Recovery, die Umgebungsförderung und das Konfigurationsmanagement.

Tipp:

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

Herunterladen eines Pakets

Der Befehl download-package ruft ein Lösungspaket von Lösungen ab.

Befehlssyntax

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

Parameter

Parameter	Beschreibung	Erforderlich
<package-name>	Name des herunterzuladenden Pakets	Ja
-d oder --destinationPath	Lokaler Zielpfad, unter dem das Paket gespeichert wird	Ja
-v oder --version	Versionsnummer (wenn nicht angegeben, wird die aktuelle Version heruntergeladen)	Nein
-f oder --fileName	Lokaler Dateiname (wenn nicht angegeben, ist der Dateiname Paketname und -version)	Nein
-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 download-package MySolution \
  -d C:\Downloads \
  -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

Dadurch wird das Paket heruntergeladen nach:

C:\Downloads\MySolution.1.2.3.zip

Beispiel mit einem benutzerdefinierten Dateinamen

uipcli solution download-package MySolution \
  -d C:\Downloads \
  -f CustomPackageName.zip \
  -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

Anwendungsfälle für das Herunterladen von Paketen

Disaster Recovery

• Archivieren Sie Pakete für die Sicherung
• Stellen Sie Pakete wieder her, wenn der Orchestrator nicht verfügbar ist

Umgebungs Förderung

• Aus der Testumgebung herunterladen
• In die Produktionsumgebung hochladen

Prüfung

• Bestimmte Versionen für Compliance-Überprüfungen abrufen
• Vergleichen Sie Paketinhalte zwischen Versionen

Lokales Testen

• Laden Sie ein bereitgestelltes Paket zur Validierung herunter
• Testen Sie entpacken und lokal bereitstellen

Herunterladen von Bereitstellungskonfigurationen

Der Befehl download-config ruft umgebungsspezifische Konfigurationsvorlagen für eine Lösungsbereitstellung ab.

Befehlssyntax

uipcli solution download-config <package-name> [options]

Parameter

Parameter	Beschreibung	Erforderlich
<package-name>	Name des Pakets	Ja
-d oder --destinationPath	Lokaler Zielpfad, unter dem Konfigurationsdateien gespeichert werden	Ja
-v oder --version	Versionsnummer (wenn nicht angegeben, wird die Konfiguration für die aktuelle Version heruntergeladen)	Nein
-f oder --fileName	Lokaler Dateiname (wenn nicht angegeben, ist der Dateiname Paketname und -version)	Nein
--format	Konfigurationsformat: yaml oder json (Standard: yaml)	Nein
-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

Wichtig: Alle drei Scopes sind für alle lösungsbezogenen CLI-Befehle erforderlich. Diese Scopes sind gruppiert, um eine umfassende Abdeckung für alle verfügbaren Lösungsbefehle zu bieten, und müssen gemeinsam pro Befehl konfiguriert werden.

Authentication

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

Beispiel

Konfiguration im YAML-Format herunterladen (Standard)

uipcli solution download-config MySolution \
  -d C:\Configs \
  -v 1.0.0 \
  -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

Laden Sie die Konfiguration im JSON-Format mit einem benutzerdefinierten Dateinamen herunter

uipcli solution download-config MySolution \
  -d C:\Configs \
  -f CustomConfigFile \
  -v 1.0.0 \
  --format json \
  -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

Was sind Bereitstellungskonfigurationen?

Bereitstellungskonfigurationen definieren umgebungsspezifische Einstellungen für eine Lösung:

• Verbindungszeichenfolge
• API-Endpunkte
• Anmeldeinformationsreferenzen
• Umgebungsvariablen
• Ordnerzuordnung

Diese Konfigurationen sind:

• Wird beim Bereitstellen einer Lösung erstellt
• Wird in Lösungen gespeichert
• Wiederverwendbar in mehreren Bereitstellungen
• Versionsgesteuert vom Paket separat

Anwendungsfälle für das Herunterladen von Konfigurationen

Pipelines mit mehreren Umgebungen

# Download Dev config
uipcli solution download-config MySolution \
  -d C:\Configs\Dev \
  -f dev-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

# Download Prod config
uipcli solution download-config MySolution \
  -d C:\Configs\Prod \
  -f prod-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

Konfiguration als Code

• Konfigurationsdateien der Versionskontrolle
• Verfolgen Sie Änderungen in den Umgebungseinstellungen
• Überprüfen Sie Konfigurationsunterschiede in Pull-Anforderungen

Generierung von Vorlagen

• Laden Sie eine funktionierende Konfiguration als Ausgangspunkt herunter
• Für neue Umgebungen ändern
• Wiederverwenden von Bereitstellungsmustern

Prüfung und Compliance

• Archivieren Sie Konfigurationen für jede Bereitstellung
• Vergleichen Sie Einstellungen zwischen verschiedenen Umgebungen
• Überprüfen Sie, ob die Produktionskonfiguration mit genehmigten Vorlagen übereinstimmt

Beispiel für die Pipelineintegration

Konfigurationen herunterladen und verwenden

- name: Download Solution Configs
  run: |
    # Download config from Test environment
    uipcli solution download-config MySolution \
      -d ./configs/test \
      -f test-config \
      --format yaml \
      -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"

- name: Commit configs to repo
  run: |
    git add ./configs
    git commit -m "Update deployment configs from Test"
    git push

Fehlersuche und ‑behebung

Fehler: „Unauthorized“ oder „403 Forbidden“

• Stellen Sie sicher, dass die externe App den Scope Solutions.Packages.Read hat
• Überprüfen Sie, ob der Organisationsname (-A) richtig ist
• Bestätigen Sie, dass die ID und der Geheimschlüssel der externen App gültig sind

Fehler: „Paket nicht gefunden“

• Überprüfen, ob der Paketname und die Version korrekt sind (Groß-/Kleinschreibung wird beachtet)
• Stellen Sie sicher, dass Sie den richtigen Mandanten und die richtige Organisation anvisieren
• Überprüfen Sie, ob das Paket erfolgreich hochgeladen wurde

Fehler: „Konfiguration nicht gefunden“

• Stellen Sie sicher, dass der Paketname korrekt ist
• Überprüfen, ob die Version vorhanden ist (oder -v weglassen, um die neueste Version zu verwenden)
• Stellen Sie sicher, dass das Paket über Konfigurationen zur Bereitstellung verfügt

Fehler: „Ausgabeverzeichnis nicht zugänglich“

• Stellen Sie sicher, dass der Zielpfad (-d) gültig und beschreibbar ist
• Überprüfen Sie die Verzeichnisberechtigungen auf dem Agenten
• Stellen Sie sicher, dass ausreichend Festplattenspeicher verfügbar ist

Nächste Schritte

Nach dem Herunterladen von Paketen oder Konfigurationen können Sie:

1. Bereitstellen von Lösungen in Zielumgebungen.
2. Konfigurationsdateien der Versionskontrolle für Prüfung und Compliance.
3. Verwenden Sie Konfigurationen als Vorlagen für neue Bereitstellungen.