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. これらのインストール パラメーターを使用して PowerShell で Publish-ActionCenter-Azure.ps1 スクリプトを実行します。

   このスクリプトの例をご覧ください。

4. 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 でコピーして保存したものです。
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

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

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 の設定」をご覧ください。

アップグレード

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

アンインストールする

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

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