So: Wiederverwenden vorhandener Orchestrator-Ressourcen bei der Bereitstellung

Verwenden Sie eine vorhandene Orchestrator-Verbindung, ein Asset oder eine Warteschlange wieder, wenn Sie eine Lösung aus einer CI/CD-Pipeline bereitstellen, anstatt eine neue bereitzustellen.

Wenn Sie eine Lösung bereitstellen, wird jede Ressource, die sie deklariert – Warteschlangen, Assets, Prozesse, Verbindungen – im Bereitstellungsordner bereitgestellt. Oft haben Sie bereits eine gemeinsam genutzte Ressource in der Zielumgebung, z. B. eine Verbindung zu einem externen System, und Sie möchten, dass die Bereitstellung diese wiederverwendet, anstatt eine neue zu erstellen.

Auf der Orchestrator-Benutzeroberfläche wählen Sie dazu Anpassen beim Bereitstellen und Verknüpfen der Ressource manuell aus. Dieser manuelle Schritt führt nicht zu einer Unattended-Pipeline. Das CLI-Äquivalent besteht darin, die Bereitstellungskonfiguration abzurufen, die Ressource innerhalb dieser Datei zu verknüpfen und die Datei dann an deploy run zu übergeben.

Hinweis:

config link bindet eine deklarierte Ressource an eine vorhandene. Damit jede Ressource stattdessen ein vorhandenes Gegenstück wiederverwendet, siehe Wiederverwenden jeder Ressource .

Voraussetzungen

• Ein veröffentlichtes Lösungspaket im Mandanten. Siehe Packen und Veröffentlichen einer Lösung.
• Eine externe Anwendung, die für die Authentifizierung von Client-Anmeldeinformationen konfiguriert ist, mit folgenden Scopes: AutomationSolutions, Solutions.Deployments, Solutions.Packages, OR.Folders, RCS.FolderAuthorization. Siehe Authentifizierung – Flow 2. OR.Folders und RCS.FolderAuthorization sind erforderlich, damit die CLI Ressourcen auflösen und binden kann, die sich in Orchestrator-Ordnern befinden.
• Die externe Anwendung, die dem Orchestrator-Ordner zugewiesen ist, der die vorhandene Ressource enthält.

Schritte

1. Authentifizieren Sie sich bei der externen Anwendung.

   uip login \
     --client-id env.UIPATH_CLIENT_ID \
     --client-secret env.UIPATH_CLIENT_SECRET \
     --tenant "$UIPATH_TENANT"
   

2. Laden Sie die Bereitstellungskonfiguration für das Paket herunter.

   uip solution deploy config get "my-package" \
     --package-version 1.0.0 \
     -d ./deploy-config.json
   

3. Verknüpfen Sie die Lösungsressource mit der vorhandenen Orchestrator-Ressource. Verwenden Sie den Ressourcennamen, wie er in der Konfigurationsdatei angezeigt wird, und verweisen Sie --folder-path auf den Ordner, in dem sich die vorhandene Ressource befindet.

   uip solution deploy config link ./deploy-config.json "MyConnection" \
     --name "SharedCrmConnection" \
     --folder-path "Shared"
   

4. Stellen Sie das Paket mit der bearbeiteten Konfiguration bereit.

   uip solution deploy run \
     --name "my-deployment" \
     --package-name "my-package" \
     --package-version 1.0.0 \
     --folder-name "MySolution" \
     --parent-folder-path "Shared" \
     --config-file ./deploy-config.json
   

Die Bereitstellung verwendet die verknüpfte Ressource wieder und erstellt keine neue im Bereitstellungsordner.

Hinweis:

Auf config link befindet sich --folder-path in der vorhandenen Ressource. Auf deploy run wird --parent-folder-path erstellt, wo der Bereitstellungsordner erstellt wird. Es handelt sich um separate Flags in separaten Unterbefehlen.

Verbindungen: Verschieben Sie die Auswahl auf die Runtime

Bei Verbindungsressourcen ist die Verknüpfung einer vorhandenen Verbindung nicht die einzige Option. Wenn Sie den authenticationType der Verbindung in der Bereitstellungskonfiguration auf ConfigurableByUsers festlegen, können Sie die Verbindung ungebunden lassen und deren Auswahl und Authentifizierung auf die Ausführungszeit verschieben – Benutzer wählen und authentifizieren die Verbindung, wenn die Automatisierung ausgeführt wird. Dies ist auch eine gültige Konfiguration für die Aktivierung.

authenticationType akzeptiert zwei Werte: ConfigurableByUsers (zur Laufzeit auf den Benutzer übertragen) und AuthenticateAfterDeployment (die Verbindung muss nach der Bereitstellung authentifiziert werden). Mit AuthenticateAfterDeployment wird die Aktivierung als fehlgeschlagen gemeldet, wenn die Verbindung bis zur Ausführung der Aktivierung nicht authentifiziert ist.

Verwenden Sie jede Ressource wieder

Wenn Sie möchten, dass die gesamte Bereitstellung vorhandene Ressourcen wiederverwendet, anstatt neue zu erstellen, legen Sie vor der Bereitstellung die Konfliktrichtlinie für alle Ressourcen in einem Aufruf fest.

1. Legen Sie die Konfliktrichtlinie für jede Ressource in der Konfigurationsdatei fest.

   uip solution deploy config set ./deploy-config.json --all conflictFixingAction UseExisting
   

2. Übergeben Sie dieselbe Datei an deploy run --config-file, wie in Schritt 4 gezeigt.

Siehe auch

• uip solution deploy – die Referenz für config get, config link, config set und deploy run.
• Orchestrator-Assets und Warteschlangen verwalten – Erstellen Sie die Ressourcen, die Sie später verknüpfen.
• Bereitstellen von CI im Orchestrator – Authentifizierung, Zwischenspeicherung und Versionsheftung für die Pipeline, in die diese passt.
• Authentifizierung – der hier verwendete Ablauf der externen Anwendung.