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

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

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

はじめる前に

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

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

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

Action Center の Azure App Service を作成する

Azure Portal に移動して、App Service を検索します。
新しい App Service を作成し、UiPathActionCenter などの名前を付けます。

注: [ランタイムスタック] ドロップダウンで .NET Core 3.1 を選択します。
前に作成した Web アプリを開き、左側のメニューから [構成] > [全般設定] に移動して、[プラットフォーム] フィールドを 64 ビットに設定します。

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

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

重要: アプリの登録にコントリビューター ロールを割り当てる必要があります。方法については、こちらをご覧ください。
アプリの [概要] ページで [アプリケーション (クライアント) ID] をコピーし、後で使用するために保存しておきます。これが、Azure のサービスプリンシパル ID です。
前に作成したアプリの登録の [クライアントシークレット] ページで、新しいクライアントシークレットを生成します。クライアントシークレットの [値] をコピーし、後で使用するために保存しておきます。これが、Azure のサービスプリンシパルのパスワードです。

注: 必要に応じて、App Service や関連するリソースグループにアクセス可能な Azure サービスプリンシパルの ID とパスワードを DevOps チームに問い合わせてください。

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

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

注: UiPath ではリクエストに応じて UiPathActionCenter.zip アーカイブを提供しています。詳細についてはこちらからお問い合わせください。
.zip ファイルの内容をマシン上のフォルダーに抽出します。
これらのインストールパラメーターを使用して PowerShell で Publish-ActionCenter-Azure.ps1 スクリプトを実行します。

このスクリプトの例は、こちらをご覧ください。
Azure Portal で Action Center を使用してください。

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

マルチノードでのインストールはシングルノードでのインストールと似ていますが、シングルノードの手順の手順 6 と 7 の間に追加の手順があります。

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

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

その後は、シングルノードの手順の手順 7 に進みます。

重要:

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 管理ポータルから取得するアクセストークンです。詳しくは、「ホストの認証設定」をご覧ください。
`azureSubscriptionId`	必須。Action Center をホストする App Service の Azure サブスクリプション ID。注: Azure Portal の、App Service の [概要] ページで確認できます。
`azureAccountTenantId`	必須。Azure テナント ID。注: Azure Portal でアプリの登録の [概要] ページで確認できます。
`azureAccountApplicationId`	必須。Azure のサービスプリンシパル ID。注: シングルノードでのインストール手順の手順 5 でコピーして保存した ID です。
`azureAccountPassword`	必須。Azure のサービスプリンシパルのパスワード。注: シングルノードでのインストール手順の手順 6 でコピーして保存したパスワードです。
`package`	必須です。`UiPath.ActionCenter.Web.zip` アーカイブのフルパスまたは相対パスを指定します。注: `UiPath.Actioncenter.zip` アーカイブにあります。
`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.\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 ファイルを編集します。
- <requestFiltering> <verbs> セクションに移動します。
- セクションの末尾に <add verb="OPTIONS" allowed="true" /> を追加します。
  
  注: Orchestrator をアップグレードすると web.config ファイルがリセットされるため、もう一度 OPTIONS 動詞を許可する必要があります。
  
  サードパーティのストレージプロバイダーの詳細については、「CORS/CSP の設定」をご覧ください。