Action Center: Azure PaaS-Installation

Das Azure-Installationsskript ermöglicht Ihnen die Installation von Action Center auf einem oder mehreren Knoten.

Important: Alle Schritte in den unten aufgeführten Installationsverfahren sind obligatorisch.

Bevor Sie beginnen

Stellen Sie sicher, dass die folgenden Tools auf Ihrem Computer installiert sind:

• PowerShell Web Deploy Snapin
• PowerShell AzureAZ-Modul Version 7.0 oder höher.

Einzelknoten-Installation

Erstellen des Azure App Service für Action Center

1. Navigieren Sie zu Ihrem Azure Portal und suchen Sie nach App Services.
2. Erstellen Sie einen neuen App-Dienst und benennen Sie ihn entsprechend, z. B. UiPathActionCenter.
   Hinweis: Wählen Sie aus der Dropdown-Liste Runtime-Stapel .NET Core 3.1 aus.
3. Öffnen Sie die zuvor erstellte Web-App, navigieren Sie über das linke Menü zu Konfiguration > Allgemeine Einstellungen und legen Sie das Feld Plattform auf 64 Bit fest.

Erstellen des Azure-Dienstprinzipals für Action Center

1. Suchen Sie im Azure-Portal nach App-Registrierungen und erstellen Sie eine neue, die dementsprechend benannt ist.

   Important: Sie müssen der App-Registrierung die Rolle Mitwirkender zuweisen. Wie das geht, erfahren Sie hier.

2. Kopieren Sie auf der Seite Übersicht Ihrer App die Anwendungs-ID (Client) und speichern Sie sie für die spätere Verwendung. Dies ist Ihre Azure-Dienstprinzipal-ID.

   
   

   

   
   

3. Generieren Sie auf der Seite Clients und Geheimnisse der zuvor erstellten App-Registrierung einen neuen Geheimschlüssel für den Client. Kopieren Sie den Wert und speichern Sie ihn für die spätere Verwendung. Dies ist Ihr Azure-Dienstprinzipalkennwort.

   
   

   

   
   
   Hinweis: Optional können Sie Ihr DevOps-Team bitten, Ihnen eine Azure-Dienstprinzipal-ID samt Kennwort zur Verfügung zu stellen, die auf den App-Dienst und die zugehörige Ressourcengruppe zugreifen kann.

Installieren von Action Center in Azure

1. Laden Sie das UiPathActionCenter.zip-Archiv auf Ihre lokale Maschine herunter. Es enthält alle erforderlichen Installationsskripts.
   Hinweis: UiPath stellt das UiPathActionCenter.zip-Archiv auf Anfrage bereit. Kontaktieren Sie uns für weitere Informationen.
2. Extrahieren Sie den Inhalt der .zip-Datei in einen Ordner auf Ihrer Maschine.
3. Führen Sie das Publish-ActionCenter-Azure.ps1 -Skript in PowerShell mit diesen Installationsparameternaus.

   Sehen Sie sich dieses Skriptbeispiel an.

4. Nutzen Sie Action Center in Ihrem Azure Portal.

Mehrfach-Knoten-Installation

Die Installation mit mehreren Knoten ähnelt der Installation mit einem Knoten, mit einem zusätzlichen Schritt zwischen den Schritten 6 und 7 des Verfahrens für einen einzelnen Knoten.

Daher müssen Sie nach Schritt 6 die folgenden Aktionen ausführen:

• Öffnen Sie den neu erstellten App-Dienst.
• Wechseln Sie über das linke Menü zur Registerkarte Skalierung (App-Serviceplan).
• Wählen Sie die Option Skalieren auf eine bestimmte Instanzenzahl aus.
• Geben Sie die gewünschte Instanzenzahl an.

Fahren Sie anschließend mit Schritt 7 des Verfahrens für einzelne Knoten fort.

Wichtig:

Nach der Migration oder dem Upgrade auf Orchestrator PaaS 2022.4 wechseln Sie zur Azure App-Dienstkonfiguration und stellen Sie sicher, dass die folgenden Schlüssel in der Liste vorhanden sind und ihr Wert auf true festgelegt ist:

• IdentityServer.OAuth.Enabled
• IdentityServer.S2SIntegration.Enabled

Skriptparameter für Powershell-Installation

Hinweis:

Wenn Sie eine benutzerdefinierte Domäne für Ihren Action Center-App-Dienst verwenden möchten, legen Sie zuerst die benutzerdefinierte Domäne fest und verwenden Sie dann diesen Domänennamen in den Skriptparametern.

Wenn Ihre benutzerdefinierte Domäne beispielsweise https://actioncenter.xyz.com lautet, verwenden Sie denselben Wert für den actionCenterUrl-Skriptparameter.

Parameter	Beschreibung
orchestratorUrl	Obligatorisch. Die URL der Orchestrator-Instanz.
identityServerUrl	Obligatorisch.. Die URL der Identity Server-Instanz.
actionCenterUrl	Obligatorisch.. Die URL der ActionCenter-Instanz.
identityInstallationAccessToken	Obligatorisch. Das Zugriffstoken aus dem Identitätsverwaltungsportal. Weitere Informationen finden Sie unter Hostauthentifizierungseinstellungen .
azureSubscriptionId	Obligatorisch.. Die Azure-Abonnement-ID für den App-Dienst, der Action Center hostet. Hinweis: Sie finden es auf der Seite Übersicht des App-Dienstes in Ihrem Azure Portal.
azureAccountTenantId	Obligatorisch. Die Azure-Mandanten-ID. Hinweis: Sie finden es auf der Übersichtsseite der App-Registrierung in Ihrem Azure-Portal.
azureAccountApplicationId	Obligatorisch.. Die Azure-Dienstprinzipal-ID. Hinweis: Es ist dasjenige, das Sie kopiert und in Schritt 5 der Einzelknoten-Installation gespeichert haben.
azureAccountPassword	Obligatorisch.. Das Kennwort der Azure-Dienstprinzipal-ID. Hinweis: Es ist dasjenige, das Sie kopiert und in Schritt 6 der Einzelknoten-Installation gespeichert haben.
package	Obligatorisch. Geben Sie den vollständigen Pfad oder relativen Pfad des Archivs UiPath.ActionCenter.Web.zip an. Hinweis: Befindet sich im UiPath.Actioncenter.zip-Archiv.
resourceGroupName	Obligatorisch.. Der Name der Azure-Ressourcengruppe, die den Action Center-App-Dienst enthält.
appServiceName	Obligatorisch.. Der Name des Azure-App-Diensts für Action Center.
stopApplicationBeforePublish	Optional. Wenn vorhanden, wird die Anwendung vor der Bereitstellung angehalten und nach Abschluss der Bereitstellung gestartet.
unattended	Optional. Wenn vorhanden, wird die Bereitstellung ohne Benutzerbestätigung fortgesetzt.

PowerShell-Skriptbeispiel

.\Publish-ActionCenter-Azure.ps1 `
    -orchestratorUrl "https://<OrchestratorServiceURL>" `
    -identityServerUrl "https://<IdentityServerURL>/identity" `
    -actionCenterUrl "https://<ActionCenterServiceURL>" `
    -identityInstallationAccessToken "abcdefgh ... MAxJeysh6IQFSabcd" `
    -azureSubscriptionId "d12f123e-12ac-1da1-1234-ed1234d5cf4b" `
    -azureAccountTenantId "d1234d2a-b123-1d12-1234-902c51f12345" `
    -azureAccountApplicationId "12345678-67e1-123d-1234-1c6cd123b123" `
    -azureAccountPassword "O.T5pX4bX89I3~Wi.clbM_u0-R5Aa-sRl~" `
    -package "E:\)\)Work\)\)UiPathActionCenter\)\)UiPath.ActionCenter.Web.zip" `
    -stopApplicationBeforePublish `
    -resourceGroupName "<ResourceGroupName" `
    -appServiceName "<ActionCenterServiceName>" `
    -unattended

Anforderungen für Speicher-Buckets

Action Center-Funktionen, die die Speicher-Buckets im Orchestrator verwenden, wie Z. B. Bilder und PDF-Rendering für Formularaktionen, Dokumentklassifizierung und Dokumentvalidierungsaktionen, erfordern die folgende Konfiguration im Orchestrator:

Akzeptieren von Action Center-Anforderungen an den Orchestrator:

• Öffnen Sie die Orchestrator-Web-App in Ihrem Azure Portal.
• Navigieren Sie zu Konfiguration und wählen Sie Anwendungseinstellungen aus.

• Fügen Sie eine Neue Anwendungseinstellung hinzu und geben Sie Folgendes ein:

  • Name: AcceptedRootUrls
  • Wert – https://localhost:6234,https://<ActionCenterServiceURL>
    Important: Stellen Sie sicher, dass der im Feld Value eingegebene Wert keine Leerzeichen enthält.
    Hinweis: Ersetzen Sie <ActionCenterServiceURL> mit der entsprechenden URL Ihres Action Center-Diensts.

    

So lassen Sie OPTIONS in der web.config-Datei der Orchestrator-Web-App zu:

• Öffnen Sie die Orchestrator-Web-App in Ihrem Azure Portal.
• Navigieren Sie zu App Service-Editor (Vorschau).
• Bearbeiten Sie die web.config-Datei:
  • Navigieren Sie zum Abschnitt <requestFiltering> <verbs>.
  • Fügen Sie <add verb="OPTIONS" allowed="true" /> am Ende des Abschnitts ein.
    Hinweis: Das Aktualisieren des Orchestrators setzt die web.config-Datei zurück, sodass Sie das OPTIONS-Verb erneut zulassen müssen.

    Für externe Speicheranbietern lesen Sie Näheres zur CORS/CSP-Konfiguration.

Upgrades

Um das Azure PaaS Action Center zu aktualisieren, müssen Sie eine neue, höhere Version installieren, die die aktuelle Version ersetzt.

Deinstallieren

Um Action Center aus Ihrem Azure Portal zu entfernen, löschen Sie die folgenden Azure-Ressourcen:

• Action Center-App-Dienst
• App-Registrierung von Action Center