Action Center: Azure PaaS のインストール

Azure インストール スクリプトを使用して Action Center を 1 つのノードまたはマルチノードでインストールできます。

重要:

以下のインストール手順では、すべての手順が必須です。

はじめる前に

マシンに次のツールがインストールされていることを確認します。

• PowerShell Web デプロイ スナップイン
• PowerShell AzureAZ モジュール バージョン 7.0 以降。

シングル ノードでのインストール

Action Center の Azure App Service を作成する

1. Azure Portal に移動して、App Service を検索します。

2. 新しい App Service を作成し、UiPathActionCenter などの名前を付けます。

   注:

   [ランタイム スタック] ドロップダウンで .NET Core 3.1 を選択します。

3. 前に作成した Web アプリを開き、左側のメニューから [構成] > [全般設定] に移動して、[プラットフォーム] フィールドを 64 ビットに設定します。

Action Center の Azure サービス プリンシパルを作成する

1. Azure Portal で「アプリの登録を検索し、新しいアプリの登録を作成して名前を付けます。

   重要:

   アプリの登録に コントリビューター ロールを割り当てる必要があります。方法については、こちらをご覧ください。

2. アプリの [概要] ページで [アプリケーション (クライアント) ID] をコピーし、後で使用するために保存しておきます。これが、Azure のサービス プリンシパル ID です。

   

3. 前に作成したアプリの登録の [クライアント シークレット] ページで、新しいクライアント シークレットを生成します。クライアント シークレットの [値] をコピーし、後で使用するために保存しておきます。これが、Azure のサービス プリンシパルのパスワードです。

   

   注:

   必要に応じて、App Service とそれに関連するリソース グループにアクセス可能な Azure サービス プリンシパルの ID とパスワードを DevOps (開発担当者と運用担当者間の連携や開発) チームに問い合わせてください。

Azure に Action Center をインストールする

1. UiPathActionCenter.zip アーカイブをローカル マシンにダウンロードします。これには、必要なインストール スクリプトがすべて含まれています。

   注:

   UiPath ではリクエストに応じて UiPathActionCenter.zip アーカイブを提供しています。詳細についてはこちらからお問い合わせください。

2. .zip ファイルの内容をマシン上のフォルダーに抽出します。

3. Run the Publish-ActionCenter-Azure.ps1 script in PowerShell, using these installation parameters.

   Check out this script example.

4. Azure Portal で Action Center を使用してください。

マルチノードでのインストール

The multi-node installation is similar to the single node installation, with an additional step between steps 6 and 7 of the single node procedure.

このため、手順 6 の後に、次の操作を実行する必要があります。

• 新しく作成した App Service を開きます。
• 左のメニューから [スケールアウト (App Service のプラン)] タブに移動します。
• [特定のインスタンス数に調整] オプションを選択します。
• 必要なインスタンス数を指定します。

Continue with step 7 of the single node procedure afterward.

重要:

Orchestrator 2022.4 PaaS に移行またはアップグレードした後は、Azure App Service の設定に移動し、以下のキーがリストに表示され、それらの値が true に設定されていることを確認してください。

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

PowerShell インストール スクリプトのパラメーター

注:

Action Center の App Service にカスタム ドメインを使用する場合は、まずカスタム ドメインを設定してから、このドメイン名をスクリプトのパラメーターで使用してください。

たとえば、カスタム ドメインが https://actioncenter.xyz.com の場合は、actionCenterUrl スクリプトのパラメーターに同じ値を使用します。

パラメーター	説明
orchestratorUrl	必須です。Orchestrator インスタンスの URL です。
identityServerUrl	必須。Identity Server インスタンスの URL です。
actionCenterUrl	必須。Action Center インスタンスの URL です。
identityInstallationAccessToken	必須。ID 管理ポータルから取得するアクセス トークンです。 See Host authentication settings for details.
azureSubscriptionId	必須。Action Center をホストする App Service の Azure サブスクリプション ID。 Find it on the app service's Overview page, in your Azure Portal.
azureAccountTenantId	必須。Azure テナント ID。 Find it on the app registration's Overview page, in your Azure Portal.
azureAccountApplicationId	必須。Azure のサービス プリンシパル ID。 It's the one you copied and saved at step 5 of the Single Node Installation procedure.
azureAccountPassword	必須。Azure のサービス プリンシパルのパスワード。 It's the one you copied and saved at step 6 of the Single Node Installation procedure.
package	Mandatory. Indicate the full path or relative path of the UiPath.ActionCenter.Web.zip archive. Find it in the UiPath.Actioncenter.zip archive.
resourceGroupName	必須。Action Center の App Service を含む Azure リソース グループの名前。
appServiceName	必須。Action Center の Azure App Service の名前。
stopApplicationBeforePublish	任意です。存在する場合は、アプリケーションをデプロイ前に停止し、デプロイの完了後に起動します。
unattended	任意です。存在する場合は、ユーザーの確認なしにデプロイが続行されます。

PowerShell スクリプトの例

.\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

ストレージ バケットの要求

Orchestrator 内のストレージ バケットを使用する Action Center の機能 (フォーム アクション、ドキュメント分類アクション、ドキュメント検証アクションにおける画像と PDF のレンダリングなど) には、Orchestrator の次の設定が必要です。

Action Center から Orchestrator への要求を受け入れるには

• Azure Portal で Orchestrator Web アプリを開きます。
• [構成] に移動して [アプリケーション設定] を選択します。
• 新しいアプリケーション設定を追加して、以下を入力します。

  • 名前 - AcceptedRootUrls

  • 値 - https://localhost:6234,https://<ActionCenterServiceURL>

    重要:

    [値] フィールドに入力した値に空のスペースがないことを確認します。

    注:

    <ActionCenterServiceURL> を Action Center サービスの対応する URL に置き換えます。

    

Orchestrator Web アプリの web.config ファイルでOPTIONSを許可するには、次の手順を実行します

• Azure Portal で Orchestrator Web アプリを開きます。
• App Service エディター (プレビュー) に移動します。
• web.config ファイルを編集します。

  • Navigate to the <requestFiltering>``<verbs> section.

  • セクションの末尾に <add verb="OPTIONS" allowed="true" /> を追加します。

    注:

    Orchestrator をアップグレードすると web.config ファイルがリセットされるため、もう一度 OPTIONS 動詞を許可する必要があります。

    サードパーティのストレージ プロバイダーの詳細については、「 CORS/CSP の設定」をご覧ください。

アップグレード

Azure PaaS の Action Center をアップグレードするには、現在のバージョンに置き換わる新しい上位バージョンをインストールする必要があります。

アンインストールする

Azure Portal から Action Center を削除するには、以下の Azure リソースを削除します。

• Action Center の App Service
• Action Center のアプリの登録