Bereitstellen und Aktivieren von Lösungen

Nach dem Hochladen eines Lösungspakets in Solutions können Sie es in einem Zielordner bereitstellen und aktivieren, um es betriebsbereit zu machen.

Bereitstellungsworkflow

Die Bereitstellung einer Lösung ist ein zweistufiger Prozess:

1. Bereitstellen: Erstellen Sie eine Bereitstellungskonfiguration und verknüpfen Sie das Paket mit einem Zielordner.
2. Aktivieren: Machen Sie die Bereitstellung live und betriebsbereit.

Durch diese Trennung können Sie Bereitstellungen im Voraus vorbereiten und während der Wartungsfenster oder nach der manuellen Genehmigung aktivieren.

Bereitstellen einer Lösung

Der Befehl deploy erstellt eine Bereitstellung eines Lösungspakets in einer bestimmten Umgebung.

Befehlssyntax

uipcli solution deploy <package-name> [options]

Parameter:

Parameter	Beschreibung	Erforderlich
<package-name>	Name des hochgeladenen Pakets	Ja
-v oder --version	Zu bereitstellende Paketversion	Ja
-d oder --deploymentName	Name für diese Bereitstellung	Ja
-f oder --deploymentFolderName	Name des Zielordners im Orchestrator	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
--deploymentParentFolder	Der Orchestrator-Ordner, in dem der Bereitstellungsordner erstellt wird. Wenn nicht angegeben, wird der Bereitstellungsordner im Mandantenordner erstellt. Wenn angegeben, erfolgt die Bereitstellung im jeweiligen Ordner. Wenn auf „ [e-mail]“ festgelegt ist workspace" befindet sich die Bereitstellung im persönlichen Arbeitsbereich für den angegebenen Benutzer.	Nein
--configPath	Lokaler Pfad zur Lösungskonfigurationsdatei; dies in Szenarien mit überschreibenden Bindungen erforderlich ist. Weitere Informationen zum Abrufen von Konfigurationsdateien finden Sie unter Herunterladen von Lösungspaketen und Konfigurationen .	Nein
--traceLevel	Protokollierungsstufe	Nein

Hinweis: Standardmäßige Anwendungs-Scopes für Lösungen

Wenn Sie die Authentifizierung einer externen Anwendung verwenden, ohne den Parameter --applicationScope anzugeben, wendet die CLI automatisch diese standardmäßigen Lösungs-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.

Wichtig:

Wenn eine Bereitstellung mit demselben Namen bereits auf beliebiger Ebene innerhalb des Mandanten im Orchestrator vorhanden ist, aktualisiert dieser Vorgang die vorhandene Bereitstellung, anstatt eine neue zu erstellen. Wenn sich die vorhandene Bereitstellung im Status „Fehlgeschlagen“ befindet, wird das Upgrade nicht fortgesetzt; können Sie die fehlgeschlagene Bereitstellung beheben oder deinstallieren, bevor Sie es erneut versuchen.

Wichtig:

Lösungen, die auf Mandantenebene bereitgestellt werden, weisen dem resultierenden Ordner nicht automatisch einen Benutzer zu. Um ein Konto zuzuweisen, stellen Sie sicher, dass die entsprechende Konfiguration im Orchestrator festgelegt ist (Mandant > Ordner).

Authentication

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

Beispiel

uipcli solution deploy MySolution \
  -v 1.2.3 \
  -d MySolution-Prod-v1.2.3 \
  -f Production \
  -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

Namenskonventionen für die Bereitstellung

Wählen Sie aussagekräftige Bereitstellungsnamen, die Folgendes enthalten:

• Lösungsname
• Umgebungsbezeichner
• Version oder Datum

Beispiele:

MySolution-Dev-v1.2.3
MySolution-Test-2025-01-15
MySolution-Prod-Release-1.2.3
InvoiceProcessing-Production-v2.0.0

Dies erleichtert die Nachverfolgung und Verwaltung von Bereitstellungen in verschiedenen Umgebungen.

Was passiert während der Bereitstellung

Wenn Sie den Bereitstellungsbefehl ausführen:

1. Das Paket wird in Lösungen validiert.
2. Eine Bereitstellungskonfiguration wird erstellt.
3. Die Bereitstellung ist mit dem Zielordner verknüpft.
4. Umgebungsspezifische Bindungen werden initialisiert.
5. Die Bereitstellung ist vorbereitet, aber noch nicht aktiv.

Die Lösung beginnt erst dann mit der Ausführung von Prozessen, wenn Sie sie aktivieren.

Aktivieren einer Bereitstellung

Der Befehl deploy-activate macht eine Bereitstellung live und betriebsbereit.

Befehlssyntax

uipcli solution deploy-activate <deployment-name> [options]

Parameter:

Parameter	Beschreibung	Erforderlich
<deployment-name>	Name der zu aktivierenden Bereitstellung	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	Erforderliche Scopes	Ja
--traceLevel	Protokollierungsstufe	Nein

Authentication

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

Beispiel

uipcli solution deploy-activate MySolution-Prod-v1.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

Was passiert während der Aktivierung

Wenn Sie eine Bereitstellung aktivieren:

1. Die Bereitstellung wird zur aktiven Version im Zielordner.
2. Trigger sind aktiviert.
3. Jede zuvor aktive Bereitstellung im selben Ordner wird deaktiviert.

CI/CD-Pipelineintegration

Vollständiger Bereitstellungsworkflow

steps:
  # 1. Pack the Solution
  - name: Pack Solution
    run: |
      uipcli solution pack ./MySolution \
        --output ./packages \
        --version "1.0.${{ github.run_number }}"

  # 2. Upload to Solutions Management
  - name: Upload Package
    run: |
      uipcli solution upload-package ./packages/MySolution.1.0.${{ 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.Packages Solutions.Packages.Write"

  # 3. Deploy to target environment
  - name: Deploy Solution
    run: |
      uipcli solution deploy MySolution \
        -v "1.0.${{ github.run_number }}" \
        -d "MySolution-Prod-v1.0.${{ github.run_number }}" \
        -f Production \
        -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"

  # 4. Activate the deployment
  - name: Activate Deployment
    run: |
      uipcli solution deploy-activate "MySolution-Prod-v1.0.${{ github.run_number }}" \
        -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"

Gruppierte Bereitstellungen mit manueller Genehmigung

Sie können Schritte zum Bereitstellen und Aktivieren trennen, um Genehmigungsworkflows zu implementieren:

# Stage 1: Deploy (automated)
- stage: DeployToProduction
  jobs:
  - job: Deploy
    steps:
    - script: |
        uipcli solution deploy MySolution -v $(version) -d MySolution-Prod-$(version) -f Production ...
      displayName: 'Prepare Production Deployment'

# Stage 2: Activate (requires approval)
- stage: ActivateProduction
  dependsOn: DeployToProduction
  # Manual approval gate configured in Azure DevOps
  jobs:
  - deployment: Activate
    environment: 'Production'
    steps:
    - script: |
        uipcli solution deploy-activate MySolution-Prod-$(version) ...
      displayName: 'Activate Production Deployment'

Förderung in mehreren Umgebungen

Stellen Sie dieselbe Version nacheinander in mehreren Umgebungen bereit:

# Deploy to Dev
uipcli solution deploy MySolution -v 1.2.3 -d MySolution-Dev-1.2.3 -f Dev ...
uipcli solution deploy-activate MySolution-Dev-1.2.3 ...

# Deploy to Test
uipcli solution deploy MySolution -v 1.2.3 -d MySolution-Test-1.2.3 -f Test ...
uipcli solution deploy-activate MySolution-Test-1.2.3 ...

# Deploy to Production (after approval)
uipcli solution deploy MySolution -v 1.2.3 -d MySolution-Prod-1.2.3 -f Production ...
uipcli solution deploy-activate MySolution-Prod-1.2.3 ...

Rollback-Strategie

So stellen Sie eine frühere Version wieder her:

1. Stellen Sie die vorherige Version mit einem neuen Bereitstellungsnamen bereit.
2. Aktivieren Sie die Bereitstellung der vorherigen Version.
3. Deinstallieren Sie optional die neuere Bereitstellung.

# Roll back to v1.2.2
uipcli solution deploy MySolution -v 1.2.2 -d MySolution-Prod-Rollback-1.2.2 -f Production ...
uipcli solution deploy-activate MySolution-Prod-Rollback-1.2.2 ...

Nächste Schritte

Nach dem Bereitstellen und Aktivieren von Lösungen können Sie:

1. Überwachen Sie die Ausführung im Orchestrator.
2. Deinstallieren Sie Bereitstellungen , wenn sie nicht mehr benötigt werden.
3. Stellen Sie neue Versionen nach demselben Workflow bereit.