Azure App Service のインストール

概要

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

重要:

1.以下のインストール手順では、すべての手順が必須です。Orchestrator は Identity Server をインストールしなければ動作しません。

2. Orchestrator のインストールを開始する前に、証明書が Azure によって信頼された証明機関 (DigiCert など) によって発行されていることを確認してください。

3. Azure Stack は、API が非対応となる可能性があるため、サポートされていません。デプロイには Azure Cloud を使用してください。

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

Azure App Service 上に Orchestrator をインストールするには、次の手順を実行します。

Orchestrator の手順

1. Azure Portal の [App Service] で、UiPathOrchestrator などのカスタム名で新しいアプリケーション サービスを作成します。Web アプリケーションを作成する場合は、必ずスタック .NET Core 3.1 を選択してください。詳細については、Microsoft の公式ドキュメントをご覧ください。
2. Azure Portal で新規作成した Web アプリを開き、[設定] タブの [全般設定] を選択して、設定を次のように変更します。
   • [プラットフォーム] を [64 ビット] に設定
   • [Web ソケット] を [オン] に設定
3. データベースの接続文字列を、Web アプリの [設定] > [接続文字列] で、Default の名前で設定します。(例: Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True)。
   重要:

   • ここで指定した Azure SQL ユーザーは、サーバー レベルのアクセス権を持つ必要があります。インストールを成功させるためには、データベース レベルのアクセス権では不十分です。
   • データベース接続文字列の TrustServerCertificate 属性を必ず True に設定してください。
   • Test Automation モジュールのデータベース接続文字列を設定するには、「Publish-Orchestrator.ps1 パラメーター」の -testAutomationFeatureEnabled パラメーターの説明に記載された手順に従ってください。
4. Orchestrator の App Service やリソース グループにアクセスできる、Azure AD アプリケーションとサービス プリンシパルを作成します。必要に応じて、App Service や関連するリソース グループにアクセス可能な Azure サービス プリンシパルの ID とパスワードを DevOps (開発担当者と運用担当者間の連携や開発) チームに問い合わせてください。

Identity Server の手順

1. Azure Portal の [App Service] で、UiPathIdentity などのカスタム名で新しいアプリケーション サービスを作成します。Web アプリケーションを作成する場合は、必ずスタック .NET Core 3.1 を選択してください。詳細については、Microsoft の公式ドキュメントをご覧ください。
2. データベースの接続文字列を、Web アプリの [設定] > [接続文字列] で、DefaultConnection の名前で設定します。(例: Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True)。
   重要: データベース接続文字列の TrustServerCertificate 属性を必ず True に設定してください。
3. [設定] > [構成] > [全般設定] タブに移動します。[プラットフォーム] から [64 ビット] を選択します。
4. Identity の App Service やリソース グループにアクセスできる、Azure AD アプリケーションとサービス プリンシパルを作成します。必要に応じて、App Service や関連するリソース グループにアクセス可能な Azure サービス プリンシパルの ID とパスワードを DevOps (開発担当者と運用担当者間の連携や開発) チームに問い合わせてください。

共通の手順

1. UiPathOrchestrator.zip アーカイブをローカル マシンにダウンロードします。このファイルには Orchestrator、Identity Server、Webhook サービスをインストールするのに必要なスクリプトがすべて含まれています。UiPath ではリクエストに応じて UiPathOrchestrator.zip アーカイブを提供しています。詳細についてはこちらからお問い合わせください。
2. Zip ファイルの内容をマシン上のフォルダーに抽出します。
   注: 以下の手順では PowerShell スクリプトを実行する必要があります。これらのタスクを中断するプロンプトを無効化するには、手順 10 で選択したディレクトリで Get-ChildItem *.ps1 -Recurse | Unblock-File コマンドを実行します。
3. こちらに記載されたパラメーターを使用して、Powershell で Publish-Orchestrator.ps1 スクリプトを実行します。
   重要:

   • Publish-Orchestrator.ps1 スクリプトを実行する前に、AzureRM PowerShell モジュールがアンインストールされていることを確認してください。替わりに Az PowerShell モジュールを使用することをお勧めします。AzureRM モジュールと Az モジュールの両方が同時にインストールされた状態はサポートされません。
   • スクリプトの実行時に、必要な Az バージョンが検出されず、AzureRM が存在する場合、無人インストールであっても、AzureRM の削除を確認するメッセージが表示されます。
   • 以前のバージョンの Az モジュールが使用されている状態で Az v6.0.0 にアップグレードすると、WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications (警告: バージョン 'x.x.x' のモジュール 'Az.<Name>' が現在使用されています。アプリケーションを閉じてから操作をもう一度お試しください。) というメッセージが表示されます。この問題を解決するには、新しい PowerShell セッションで Publish-Orchestrator.ps1 を実行してください。
   • Microsoft がホストするエージェントを使用している場合は、Publish-Orchestrator.ps1 の問題により、正しい Az バージョンが実行されません。バージョン 5.4.0 または 6.0.0 を使用できず、4.7.0 を使用しなければなりません。回避策としては、C:\Modules\az_4.7.0 フォルダーを削除してください。
4. こちらに記載されたパラメーターを使用して、Powershell で Publish-IdentityServer.ps1 スクリプトを実行します。
   重要:「Identity Server へのパブリッシュ」ページに記載された手順に従ってプロセスを完了してください。
5. こちらに記載されたパラメーターを使用して、Powershell で MigrateTo-IdentityServer.ps1 スクリプトを実行します。
6. Webhook サービスをインストールします。
7. Orchestrator および Identity のアプリ サービスを開始します。Azure Portal で Orchestrator を使用してください。

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

注: マルチノード インストールでは、High Availability Add-on を設定する必要があります。

Azure App Service 上に、Orchestrator をマルチノードでインストールするには、次の手順を実行します。

Orchestrator の手順

1. Azure Portal の [App Service] で、UiPathOrchestrator などのカスタム名で新しいアプリケーション サービスを作成します。Web アプリケーションを作成する場合は、必ずスタック .NET Core 3.1 を選択してください。詳細については、Microsoft の公式ドキュメントをご覧ください。
2. Azure Portal で新規作成した Web アプリを開き、[設定] タブの [全般設定] を選択して、設定を次のように変更します。
   • [プラットフォーム] を [64 ビット] に設定
   • [Web ソケット] を [オン] に設定
3. データベースの接続文字列を、Web アプリの [設定] > [接続文字列] で、"Default" という名前で設定します。たとえば、Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True です。
   重要:

   • ここで指定した Azure SQL ユーザーは、サーバー レベルのアクセス権を持つ必要があります。インストールを成功させるためには、データベース レベルのアクセス権では不十分です。
   • データベース接続文字列の TrustServerCertificate 属性を必ず True に設定してください。
4. Orchestrator の App Service やリソース グループにアクセスできる、Azure AD アプリケーションとサービス プリンシパルを作成します。必要に応じて、App Service や関連するリソース グループにアクセス可能な Azure サービス プリンシパルの ID とパスワードを DevOps (開発担当者と運用担当者間の連携や開発) チームに問い合わせてください。
5. [スケールアウト (App Service のプラン)] タブで、[特定のインスタンス数に調整] オプションを選択して目的のインスタンス数を指定します。

Identity Server の手順

1. Azure Portal の [App Service] で、UiPathIdentity などのカスタム名で新しいアプリケーション サービスを作成します。Web アプリケーションを作成する場合は、必ずスタック .NET Core 3.1 を選択してください。詳細については、Microsoft の公式ドキュメントをご覧ください。
2. データベースの接続文字列を、Web アプリの [設定] > [接続文字列] で、DefaultConnection の名前で設定します。(例: Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True)。
   重要: データベース接続文字列の TrustServerCertificate 属性を必ず True に設定してください。
3. [設定] > [構成] > [全般設定] タブに移動します。[プラットフォーム] から [64 ビット] を選択します。
4. Identity の App Service やリソース グループにアクセスできる、Azure AD アプリケーションとサービス プリンシパルを作成します。必要に応じて、App Service や関連するリソース グループにアクセス可能な Azure サービス プリンシパルの ID とパスワードを DevOps (開発担当者と運用担当者間の連携や開発) チームに問い合わせてください。

共通の手順

1. UiPathOrchestrator.zip アーカイブをローカル マシンにダウンロードします。このファイルには Orchestrator、Identity Server、Webhook サービスをインストールするのに必要なスクリプトがすべて含まれています。UiPath ではリクエストに応じて UiPathOrchestrator.zip アーカイブを提供しています。詳細についてはこちらからお問い合わせください。
2. Zip ファイルの内容をマシン上のフォルダーに抽出します。
   注: 以下の手順では PowerShell スクリプトを実行する必要があります。これらのタスクを中断するプロンプトを無効化するには、手順 11 で選択したディレクトリで Get-ChildItem *.ps1 -Recurse | Unblock-File コマンドを実行します。
3. こちらに記載されたパラメーターを使用して、Powershell で Publish-Orchestrator.ps1 スクリプトを実行します。
   重要:

   • Publish-Orchestrator.ps1 スクリプトを実行する前に、AzureRM PowerShell モジュールがアンインストールされていることを確認してください。替わりに Az PowerShell モジュールを使用することをお勧めします。AzureRM モジュールと Az モジュールの両方が同時にインストールされた状態はサポートされません。
   • スクリプトの実行時に、必要な Az バージョンが検出されず、AzureRM が存在する場合、無人インストールであっても、AzureRM の削除を確認するメッセージが表示されます。
   • 以前のバージョンの Az モジュールが使用されている状態で Az v6.0.0 にアップグレードすると、WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications (警告: バージョン 'x.x.x' のモジュール 'Az.<Name>' が現在使用されています。アプリケーションを閉じてから操作をもう一度お試しください。) というメッセージが表示されます。この問題を解決するには、新しい PowerShell セッションで Publish-Orchestrator.ps1 を実行してください。
   • Microsoft がホストするエージェントを使用している場合は、Publish-Orchestrator.ps1 の問題により、正しい Az バージョンが実行されません。バージョン 5.4.0 または 6.0.0 を使用できず、4.7.0 を使用しなければなりません。回避策としては、C:\Modules\az_4.7.0 フォルダーを削除してください。
4. こちらに記載されたパラメーターを使用して、Powershell で Publish-IdentityServer.ps1 スクリプトを実行します。
   重要:「Identity Server へのパブリッシュ」ページに記載された手順に従ってプロセスを完了してください。
5. こちらに記載されたパラメーターを使用して、Powershell で MigrateTo-IdentityServer.ps1 スクリプトを実行します。
6. Webhook サービスをインストールします。
7. Orchestrator および Identity のアプリ サービスを開始します。Azure Portal で Orchestrator を使用してください。