Azure Arc 対応 Logic Apps を使用してシングルテナントベースのロジックアプリワークフローを作成してデプロイする (プレビュー)

[アーティクル]
01/04/2024

注意

この機能はプレビュー段階にあり、「Microsoft Azure プレビューの追加使用条件」が適用されます。

Azure Arc 対応 Logic Apps と Azure portal を使用すると、運用および管理する Kubernetes インフラストラクチャに対して、シングルテナントベースのロジックアプリワークフローを作成してデプロイできます。ロジックアプリは、Azure App Service プラットフォーム拡張機能バンドルをインストールして有効にした Azure Arc 対応 Kubernetes クラスターにマップされた "カスタムの場所" で実行されます。

たとえば、このクラスターは、Azure Kubernetes Service、ベアメタル Kubernetes、または別のセットアップにすることができます。拡張機能バンドルを使用すると、Kubernetes クラスターで Azure Logic Apps、Azure App Service、Azure Functions などのプラットフォームサービスを実行できます。

詳細については、次のドキュメントを確認してください。

前提条件

このセクションでは、ロジックアプリワークフローの作成とデプロイに使用できるすべてのアプローチとツールに共通する前提条件について説明します。ツール固有の前提条件が、対応する手順と共に表示されます。

アクティブなサブスクリプションが含まれる Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、無料アカウントを作成してください。
Azure Arc 対応 Kubernetes クラスターと、Azure Logic Apps、Azure App Service、Azure Functions をホストして実行できる "カスタムの場所" を備えた Kubernetes 環境。

重要

Kubernetes 環境、カスタムの場所、ロジックアプリには、同じリソースの場所を使用するようにしてください。

Kubernetes クラスターで App Service バンドル拡張機能を作成するときに、ロジックアプリワークフローを実行するために既定のスケーリング動作を変更することもできます。 Azure CLI コマンド az k8s-extension create を使用して拡張機能を作成する場合は、構成設定 keda.enabled=true を必ず含めてください。

az k8s-extension create {other-command-options} --configuration-settings "keda.enabled=true"

詳細については、次のドキュメントを確認してください。
独自の Microsoft Entra の ID

ワークフローで Office 365 Outlook や Azure Storage など、Azure でホストされた接続を使う必要がある場合は、ロジックアプリで認証に Microsoft Entra の ID を使う必要があります。 Azure Arc 対応 Logic Apps は任意のインフラストラクチャで実行できますが、Azure でホストされる接続を使用するためのアクセス許可を持つ ID が必要です。この ID を設定するには、ロジックアプリで必要な ID として使うアプリの登録を Microsoft Entra ID で作成します。

Note

マネージド ID のサポートは、Azure Arc 対応 Logic Apps では現在使用できません。

Azure CLI を使って Microsoft Entra のアプリの登録を作成するには、次の手順のようにします。
1. az ad sp create コマンドを使用して、アプリの登録を作成します。
2. すべての詳細を確認するには、az ad sp show コマンドを実行します。
3. 両方のコマンドの出力から、クライアント ID、オブジェクト ID、テナント ID、およびクライアントシークレットの値を見つけて保存します。これらは、後で使用するために保持しておく必要があります。
Azure portal を使って Microsoft Entra のアプリの登録を作成するには、次の手順のようにします。
1. Azure portal を使って、新しい Microsoft Entra アプリの登録を作成します。
2. 作成が完了したら、ポータルで新しいアプリの登録を見つけます。
3. 登録メニューで、 [概要] を選択し、クライアント ID、テナント ID、およびクライアントシークレットの値を保存します。
4. オブジェクト ID を検索するには、 [ローカルディレクトリでのマネージドアプリケーション] フィールドの横にあるアプリ登録の名前を選択します。プロパティビューからオブジェクト ID をコピーします。

ロジックアプリを作成してデプロイする

Azure CLI、Visual Studio Code、Azure portal のどれを使用するかに基づいて、一致するタブを選択して、特定の前提条件と手順を確認します。

始める前に、次の項目が必要になります。

ローカルコンピューターにインストールされた最新の Azure CLI 拡張機能。
- この拡張機能がない場合は、ご使用のオペレーティングシステムまたはプラットフォームのインストールガイドを確認してください。
- 最新バージョンかどうかが不明な場合は、環境と CLI のバージョンを確認する手順に従ってください。
"プレビュー" 版の Azure Logic Apps (Standard) の Azure CLI 用拡張機能。

Azure Logic Apps は一般提供されていますが、シングルテナント Azure Logic Apps の拡張機能はまだプレビュー段階です。
ロジックアプリを作成する Azure リソースグループ。

このリソースグループがない場合は、リソースグループを作成する手順に従ってください。
データと実行履歴の保持のためにロジックアプリで使用する Azure ストレージアカウント。

このストレージアカウントを持っていない場合は、ロジックアプリの作成時にこのアカウントを作成するか、手順に従ってストレージアカウントを作成することができます。

環境と CLI バージョンを確認する

Azure portal にサインインします。次のコマンドを実行して、サブスクリプションがアクティブであることを確認します。
```
az login
```
次のコマンドを実行して、ターミナルまたはコマンドウィンドウで Azure CLI のバージョンを確認します。
```
az --version
```
最新バージョンについては、最新のリリースノートを参照してください。
最新バージョンを使用していない場合は、オペレーティングシステムまたはプラットフォーム用のインストールガイドに従ってインストールを更新します。

Azure Logic Apps (Standard) の Azure CLI 用拡張機能をインストールする

"プレビュー" 版のシングルテナント Azure Logic Apps (Standard) の Azure CLI 用拡張機能をインストールするには、次のコマンドを実行します。

az extension add --yes --source "https://aka.ms/logicapp-latest-py2.py3-none-any.whl"

リソースグループの作成

ロジックアプリのリソースグループがまだない場合は、コマンド az group create を実行してグループを作成します。 Azure アカウントの既定のサブスクリプションをまだ設定していない場合は、--subscription パラメーターでサブスクリプション名または識別子を使用してください。そうでない場合は、--subscription パラメーターを使用する必要はありません。

ヒント

既定のサブスクリプションを設定するには、次のコマンドを実行し、MySubscription をご自分のサブスクリプション名または識別子に置き換える必要があります。

az account set --subscription MySubscription

たとえば、次のコマンドは MyResourceGroupName という名前のリソースグループを、MySubscription という名前の Azure サブスクリプションを使用して eastus の場所に作成します。

az group create --name MyResourceGroupName 
   --subscription MySubscription 
   --location eastus

リソースグループが正常に作成されると、出力に provisioningState が Succeeded として示されます。

<...>
   "name": "testResourceGroup",
   "properties": {
      "provisioningState": "Succeeded"
    },
<...>

ロジックアプリを作成する

Azure Arc 対応ロジックアプリを作成するには、次の必須パラメーターを指定してコマンド az logicapp create を実行します。ロジックアプリのリソースの場所、カスタムの場所、Kubernetes 環境はすべて同じである必要があります。

パラメーター	説明
`--name -n`	ロジックアプリの一意の名前。
`--resource-group -g`	ロジックアプリの作成先となるリソースグループの名前。使用するリソースグループがない場合は、リソースグループを作成してください。
`--storage-account -s`	ロジックアプリで使用するストレージアカウント。同じリソースグループ内のストレージアカウントの場合は、文字列値を使用します。別のリソースグループ内のストレージアカウントの場合は、リソース ID を使用します。

az logicapp create --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription 
   --storage-account MyStorageAccount --custom-location MyCustomLocation

プライベート Azure Container Registry (ACR) イメージを使用して Azure Arc 対応ロジックアプリを作成するには、次の必須パラメーターを指定してコマンド az logicapp create を実行します。

az logicapp create --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription 
   --storage-account MyStorageAccount --custom-location MyCustomLocation 
   --deployment-container-image-name myacr.azurecr.io/myimage:tag
   --docker-registry-server-password MyPassword 
   --docker-registry-server-user MyUsername

ロジックアプリの詳細を表示する

Azure Arc 対応ロジックアプリの詳細を表示するには、次の必須パラメーターを指定してコマンド az logicapp show を実行します。

az logicapp show --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription

ロジックアプリをデプロイする

Azure App Service の Kudu zip のデプロイを使用して Azure Arc 対応ロジックアプリをデプロイするには、次の必須パラメーターを指定してコマンド az logicapp deployment source config-zip を実行します。

重要

zip ファイルにプロジェクトの成果物がルートレベルで含まれていることを確認します。これらの成果物には、すべてのワークフローフォルダー、host.json、connections.js などの構成ファイル、および他の関連ファイルが含まれます。余分なフォルダーを追加したり、プロジェクト構造にまだ存在しないフォルダーに成果物を含めたりしないでください。たとえば次の一覧は MyBuildArtifacts.zip ファイル構造の例を示しています。

MyStatefulWorkflow1-Folder
MyStatefulWorkflow2-Folder
connections.json
host.json

az logicapp deployment source config-zip --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription 
   --src MyBuildArtifact.zip

ロジックアプリを起動する

Azure Arc 対応ロジックアプリを起動するには、次の必須パラメーターを指定してコマンド az logicapp start を実行します。

az logicapp start --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription

ロジックアプリを停止する

Azure Arc 対応ロジックアプリを停止するには、次の必須パラメーターを指定してコマンド az logicapp stop を実行します。

az logicapp stop --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription

ロジックアプリを再起動する

Azure Arc 対応ロジックアプリを再起動するには、次の必須パラメーターを指定してコマンド az logicapp restart を実行します。

az logicapp restart --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription

ロジックアプリを削除する

Azure Arc 対応ロジックアプリを削除するには、次の必須パラメーターを指定してコマンド az logicapp delete を実行します。

az logicapp delete --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription

接続の認証を設定する

現在、Azure Arc 対応 Kubernetes クラスターでは、ロジックアプリのマネージド ID を使用したマネージド API 接続の認証はサポートされていません。ワークフローでマネージドコネクタを使用する場合は、これらの Azure がホストするマネージド接続を作成します。

代わりに、Microsoft Entra ID で独自のアプリの登録を作成する必要があります。その後、このアプリの登録を、Azure Arc 対応 Logic Apps でデプロイおよび実行されているロジックアプリの ID として使用できます。詳細については、最重要の前提条件を確認してください。

アプリの登録から、クライアント ID、オブジェクト ID、テナント ID、およびクライアントシークレットが必要です。 Visual Studio Code を使ってデプロイする場合は、Microsoft Entra の ID でロジックアプリを設定するための組み込みのエクスペリエンスがあります。詳細については、ロジックアプリワークフローを作成してデプロイする - Visual Studio Code に関するセクションを参照してください。

ただし、開発には Visual Studio Code を使用するが、Azure CLI または自動パイプラインを使用してデプロイする場合は、こちらの手順に従います。

プロジェクトで接続とアプリの設定を構成する

ロジックアプリプロジェクトの connections.json ファイルで、マネージド接続の authentication オブジェクトを探します。このオブジェクトの内容を、最重要の前提条件で以前に生成した、ご自分のアプリの登録情報に置き換えます。

"authentication": {
   "type": "ActiveDirectoryOAuth",
   "audience": "https://management.core.windows.net/",
   "credentialType": "Secret",
   "clientId": "@appsetting('WORKFLOWAPP_AAD_CLIENTID')",
   "tenant": "@appsetting('WORKFLOWAPP_AAD_TENANTID')",
   "secret": "@appsetting('WORKFLOWAPP_AAD_CLIENTSECRET')"
}

ロジックアプリプロジェクトの local.settings.json ファイルに、クライアント ID、オブジェクト ID、テナント ID、およびクライアントシークレットを追加します。デプロイ後、これらの設定はロジックアプリの設定になります。
```
{
   "IsEncrypted": false,
   "Values": {
      <...>
      "WORKFLOWAPP_AAD_CLIENTID":"<my-client-ID>",
      "WORKFLOWAPP_AAD_OBJECTID":"<my-object-ID",
      "WORKFLOWAPP_AAD_TENANTID":"<my-tenant-ID>",
      "WORKFLOWAPP_AAD_CLIENTSECRET":"<my-client-secret>"
   }
}
```

重要

運用シナリオまたは環境では、キーコンテナーを使用するなどして、このようなシークレットや機密情報をセキュリティで保護するようにしてください。

アクセスポリシーを追加する

シングルテナントの Azure Logic Apps では、ロジックアプリごとに ID があります。これには、Azure でホストされているマネージド接続を使用するためのアクセス許可がアクセスポリシーによって付与されています。これらのアクセスポリシーは、Azure portal またはインフラストラクチャデプロイを使用して設定できます。

ARM テンプレート

Azure Resource Manager テンプレート (ARM テンプレート) には、マネージド API 接続 "ごと" に次のリソース定義を含め、次の情報を指定します。

パラメーター	説明
<connection-name>	マネージド API 接続の名前 (例: `office365`)
<object-ID>	アプリの登録から以前に保存した、Microsoft Entra の ID のオブジェクト ID
<tenant-ID>	アプリの登録から以前に保存した、Microsoft Entra の ID のテナント ID

{
   "type": "Microsoft.Web/connections/accessPolicies",
   "apiVersion": "2016-06-01",
   "name": "[concat('<connection-name>'),'/','<object-ID>')]",
   "location": "<location>",
   "dependsOn": [
      "[resourceId('Microsoft.Web/connections', parameters('connection_name'))]"
   ],
   "properties": {
      "principal": {
         "type": "ActiveDirectory",
         "identity": {
            "objectId": "<object-ID>",
            "tenantId": "<tenant-ID>"
         }
      }
   }
}

詳細については、Microsoft.Web/connections/accesspolicies (ARM テンプレート) のドキュメントを参照してください。

Azure portal

このタスクでは、以前に保存したクライアント ID を "アプリケーション ID" として使用します。

Azure Portal で、ご利用のロジックアプリを探して選択します。ロジックアプリのメニューの [ワークフロー] で、 [接続] を選択します。これにより、ロジックアプリのワークフロー内のすべての接続が一覧表示されます。
[API 接続] で接続を選択します。この例では office365 です。
接続のメニューの [設定] で、 [アクセスポリシー]>[追加] を選択します。
[アクセスポリシーの追加] ペインの検索ボックスで、以前に保存したクライアント ID を検索して選択します。
終了したら、 [追加] を選択します。
ロジックアプリで Azure でホストされる接続ごとに、これらの手順を繰り返します。

DevOps のデプロイを自動化する

Azure Arc 対応ロジックアプリをビルドしてデプロイするために、シングルテナントベースのロジックアプリと同じパイプラインとプロセスを使用できます。 DevOps 用のパイプラインを使用してインフラストラクチャのデプロイを自動化するには、コンテナー以外とコンテナーの両方のデプロイに対してインフラストラクチャレベルで次の変更を行います。

標準のデプロイ (コンテナー以外)

ロジックアプリのデプロイに zip デプロイを使用する場合は、コンテナーイメージをホストするために Docker レジストリを設定する必要はありません。 Kubernetes のロジックアプリは、厳密にはコンテナーで実行されますが、これらのコンテナーは Azure Arc 対応 Logic Apps によって自動的に管理されます。このシナリオの場合は、インフラストラクチャを設定するときに次のタスクを実行します。

Kubernetes でロジックアプリを作成しているリソースプロバイダーに通知します。
デプロイに App Service プランを含めます。詳細については、「デプロイに App Service プランを含める」を参照してください。

Azure Resource Manager テンプレート (ARM テンプレート) に、次の値を含めます。

Item	JSON プロパティ	説明
場所	`location`	カスタムの場所および Kubernetes 環境と同じリソースの場所 (Azure リージョン) を必ず使用してください。ロジックアプリのリソースの場所、カスタムの場所、Kubernetes 環境はすべて同じである必要があります。注: この値は、カスタムの場所の "名前" と同じではありません。
アプリの種類	`kind`	Azure プラットフォームでアプリを識別できるようにデプロイするアプリの種類。 Azure Logic Apps の場合、この情報は次の例のようになります: `kubernetes,functionapp,workflowapp,linux`
拡張された場所	`extendedLocation`	このオブジェクトでは、Kubernetes 環境に "カスタムの場所" の `"name"` が必要であるため、`"type"` が `"CustomLocation"` に設定されている必要があります。
ホスティングプランのリソース ID	`serverFarmId`	関連付けられている App Service プランのリソース ID。これは次のような形式になります。 `"/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}"`
ストレージ接続文字列	`AzureWebJobsStorage`	ストレージアカウントの接続文字列重要: ARM テンプレートでは、自分のストレージアカウントの接続文字列を指定する必要があります。運用シナリオまたは環境では、キーコンテナーを使用するなどして、このようなシークレットや機密情報をセキュリティで保護するようにしてください。

ARM テンプレート

次の例は、ARM テンプレートで使用できる Azure Arc 対応 Logic Apps リソース定義のサンプルを示しています。詳細については、Microsoft.Web/sites template format (JSON) のドキュメントを参照してください。

{
   "type": "Microsoft.Web/sites",
   "apiVersion": "2020-12-01",
   "name": "[parameters('name')]",
   "location": "[parameters('location')]",
   "kind": "kubernetes,functionapp,workflowapp,linux",
   "extendedLocation": {
      "name": "[parameters('customLocationId')]",
      "type": "CustomLocation"
    },
   "properties": {
      "clientAffinityEnabled": false,
      "name": "[parameters('name')]",
      "serverFarmId": "<hosting-plan-ID>",
      "siteConfig": {
         "appSettings": [
            {
               "name": "FUNCTIONS_EXTENSION_VERSION",
               "value": "~3"
            },
            {
               "name": "FUNCTIONS_WORKER_RUNTIME",
               "value": "node"
            },
            {
               "name": "AzureWebJobsStorage",
               "value": "<storage-connection-string>"
            },
            {
               "name": "AzureFunctionsJobHost__extensionBundle__id",
               "value": "Microsoft.Azure.Functions.ExtensionBundle.Workflows"
            },
            {
               "name": "AzureFunctionsJobHost__extensionBundle__version",
               "value": "[1.*, 2.0.0)"
            },
            {
               "name": "APP_KIND",
               "value": "workflowapp"
            }
         ],
         "use32BitWorkerProcess": "[parameters('use32BitWorkerProcess')]",
         "linuxFxVersion": "Node|12"
      }
   }
}

コンテナーのデプロイ

コンテナーツールとデプロイプロセスを使用する場合は、ロジックアプリをコンテナー化し、Azure Arc 対応 Logic Apps にデプロイできます。このシナリオの場合は、インフラストラクチャを設定するときに次の高度なタスクを実行します。

コンテナーイメージをホストするための Docker レジストリを設定します。
ロジックアプリをコンテナー化するには、たとえば、ロジックアプリプロジェクトのルートフォルダーに次の Dockerfile を追加し、Docker レジストリにイメージをビルドして発行する手順に従います。「チュートリアル: Azure Container Registry タスクを使用して、クラウドでコンテナーイメージをビルドしてデプロイする」を参照してください。

注意

ストレージプロバイダーとして SQL を使用する場合は、Azure Functions イメージバージョン 3.3.1 以降を使用してください。
```
FROM mcr.microsoft.com/azure-functions/node:3.3.1
ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
AzureFunctionsJobHost__Logging__Console__IsEnabled=true \
FUNCTIONS_V2_COMPATIBILITY_MODE=true
COPY . /home/site/wwwroot
RUN cd /home/site/wwwroot
```
Kubernetes でロジックアプリを作成しているリソースプロバイダーに通知します。
デプロイテンプレートで、デプロイを計画している Docker レジストリとコンテナーイメージをポイントします。シングルテナントの Azure Logic Apps は、この情報を使用して、Docker レジストリからコンテナーイメージを取得します。
デプロイに App Service プランを含めます。詳細については、「デプロイに App Service プランを含める」を参照してください。

Azure Resource Manager テンプレート (ARM テンプレート) に、次の値を含めます。

Item	JSON プロパティ	説明
場所	`location`	カスタムの場所および Kubernetes 環境と同じリソースの場所 (Azure リージョン) を必ず使用してください。ロジックアプリのリソースの場所、カスタムの場所、Kubernetes 環境はすべて同じである必要があります。注: この値は、カスタムの場所の "名前" と "同じではありません"。
アプリの種類	`kind`	Azure プラットフォームでアプリを識別できるようにデプロイするアプリの種類。 Azure Logic Apps の場合、この情報は次の例のようになります: `kubernetes,functionapp,workflowapp,container`
拡張された場所	`extendedLocation`	このオブジェクトでは、Kubernetes 環境に "カスタムの場所" の `"name"` が必要であるため、`"type"` が `"CustomLocation"` に設定されている必要があります。
コンテナー名	`linuxFxVersion`	コンテナーの名前。次のような形式になります。`DOCKER\\|<container-name>`
ホスティングプランのリソース ID	`serverFarmId`	関連付けられている App Service プランのリソース ID。これは次のような形式になります。 `"/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}"`
ストレージ接続文字列	`AzureWebJobsStorage`	ストレージアカウントの接続文字列重要: Docker コンテナーにデプロイする際に、ARM テンプレートで自分のストレージアカウントの接続文字列を指定する必要があります。運用シナリオまたは環境では、キーコンテナーを使用するなどして、このようなシークレットや機密情報をセキュリティで保護するようにしてください。

Docker レジストリとコンテナーイメージを参照するには、こちらの値をテンプレートに含めます。

Item	JSON プロパティ	説明
Docker レジストリサーバー URL	`DOCKER_REGISTRY_SERVER_URL`	Docker レジストリサーバーの URL
Docker レジストリサーバー	`DOCKER_REGISTRY_SERVER_USERNAME`	Docker レジストリサーバーにアクセスするユーザー名
Docker レジストリサーバーのパスワード	`DOCKER_REGISTRY_SERVER_PASSWORD`	Docker レジストリサーバーにアクセスするためのパスワード

ARM テンプレート

次の例は、ARM テンプレートで使用できる Azure Arc 対応 Logic Apps リソース定義のサンプルを示しています。詳細については、Microsoft.Web/sites template format (ARM テンプレート) のドキュメントを参照してください。

{
   "type": "Microsoft.Web/sites",
   "apiVersion": "2020-12-01",
   "name": "[parameters('name')]",
   "location": "[parameters('location')]",
   "kind": " kubernetes,functionapp,workflowapp,container",
   "extendedLocation": {
      "name": "[parameters('customLocationId')]",
      "type": "CustomLocation"
    },
   "properties": {
      "name": "[parameters('name')]",
      "clientAffinityEnabled": false,
      "serverFarmId": "<hosting-plan-ID>",
      "siteConfig": {
         "appSettings": [
            {
               "name": "FUNCTIONS_EXTENSION_VERSION",
               "value": "~3"
            },
            {
               "name": "FUNCTIONS_WORKER_RUNTIME",
               "value": "node"
            },
            {
               "name": "AzureWebJobsStorage",
               "value": "<storage-connection-string>"
            },
            {
               "name": "AzureFunctionsJobHost__extensionBundle__id",
               "value": "Microsoft.Azure.Functions.ExtensionBundle.Workflows"
            },
            {
               "name": "AzureFunctionsJobHost__extensionBundle__version",
               "value": "[1.*, 2.0.0)"
            },
            {
               "name": "APP_KIND",
               "value": "workflowapp"
            }, 
            {
               "name": "DOCKER_REGISTRY_SERVER_URL",
               "value": "<docker-registry-server-URL>"
            },
            { 
               "name": "DOCKER_REGISTRY_SERVER_USERNAME",
               "value": "<docker-registry-server-username>"
            },
            {
               "name": "DOCKER_REGISTRY_SERVER_PASSWORD",
               "value": "<docker-registry-server-password>"
            }
         ],
         "use32BitWorkerProcess": "[parameters('use32BitWorkerProcess')]",
         "linuxFxVersion": "DOCKER|<container-name>"
      }
   }
}

デプロイに App Service プランを含める

標準またはコンテナーのいずれのデプロイの場合でも、デプロイにApp Service プランを含める必要があります。このプランは Kubernetes 環境との関連性は低くなりますが、標準とコンテナーのどちらのデプロイにも、App Service プランが引き続き必要です。

他の作成オプションでは通常、このプラン用に Azure リソースのプロビジョニングが処理されますが、デプロイで "コードとしてのインフラストラクチャ" テンプレートを使用する場合は、プラン用に Azure リソースを明示的に作成する必要があります。ホスティングプランリソースは変更されず、sku の情報だけが変更されます。

Azure Resource Manager テンプレート (ARM テンプレート) に、次の値を含めます。

Item	JSON プロパティ	説明
場所	`location`	カスタムの場所および Kubernetes 環境と同じリソースの場所 (Azure リージョン) を必ず使用してください。ロジックアプリのリソースの場所、カスタムの場所、Kubernetes 環境はすべて同じである必要があります。注: この値は、カスタムの場所の "名前" と同じではありません。
種類	`kind`	`kubernetes,linux` である必要がある、デプロイされる App Service プランの種類
拡張された場所	`extendedLocation`	このオブジェクトでは、Kubernetes 環境に "カスタムの場所" の `"name"` が必要であるため、`"type"` が `"CustomLocation"` に設定されている必要があります。
ホスティングプラン名	`name`	App Service プランの名前
プランレベル	`sku: tier`	App Serviceプランレベル (`K1`)
プラン名	`sku: name`	App Serviceプラン名 (`Kubernetes`)

ARM テンプレート

次の例は、アプリのデプロイで使用できる App Service プランのリソース定義のサンプルを示しています。詳細については、Microsoft.Web/serverfarms template format (ARM テンプレート) のドキュメントを参照してください。

{
   "type": "Microsoft.Web/serverfarms",
   "apiVersion": "2020-12-01",
   "location": "<location>",
   "name": "<hosting-plan-name>",
   "kind": "kubernetes,linux",
   "extendedLocation": {
      "name": "[parameters('customLocationId')]",
      "type": "CustomLocation"
   },
   "sku": {
      "tier": "Kubernetes",
      "name": "K1", 
      "capacity": 1
   },
   "properties": {
      "kubeEnvironmentProfile": {
         "id": "[parameters('kubeEnvironmentId')]"
      }
   }
}

既定のスケーリング動作を変更する

Azure Arc 対応 Logic Apps では、バックエンドストレージキュー内の "ジョブ" の数に基づいて、ロジックアプリのスケーリングが自動的に管理されます。ただし、この既定のスケーリング動作は変更できます。

ロジックアプリでは、ワークフロー定義によって実行するアクションのシーケンスが指定されます。ワークフローの実行がトリガーされるたびに、Azure Logic Apps ランタイムによって、ワークフロー定義内のアクションの種類ごとに "ジョブ" が作成されます。次に、ランタイムによってこれらのジョブが "ジョブシーケンサー" に整理されます。このシーケンサーによって、ワークフロー定義のジョブの実行がオーケストレーションされますが、基になる Azure Logic Apps ジョブオーケストレーションエンジンによって各ジョブが実行されます。

ステートフルワークフローの場合、ジョブオーケストレーションエンジンによりストレージキューメッセージが使用され、ジョブシーケンサーでジョブがスケジュールされます。バックグラウンドでは、"ジョブディスパッチャー" (または "ディスパッチャー worker インスタンス") によってこれらのジョブキューが監視されます。オーケストレーションエンジンにより worker インスタンスの既定の最小および最大数が使用され、ジョブキューが監視されます。ステートレスワークフローの場合、オーケストレーションエンジンによって、アクションの状態がメモリ内に完全に保持されます。

既定のスケーリング動作を変更するには、ジョブキューを監視する worker インスタンスの最小および最大数に異なる値を指定します。

スケーリングを変更するための前提条件

Azure Arc 対応 Kubernetes クラスターで、以前に作成した App Service バンドル拡張機能の keda.enabled プロパティを true に設定する必要があります。詳細については、最重要の前提条件を確認してください。

スケーリングしきい値を変更する

Azure Arc 対応 Logic Apps では、ジョブキューの長さによってスケールイベントがトリガーされ、ロジックアプリのスケーリング発生頻度のしきい値が設定されます。キューの長さ (既定値は 20 ジョブに設定されています) は変更することができます。スケーリングの頻度を低くするには、キューの長さを増やします。スケーリングの頻度を高くするには、キューの長さを減らします。このプロセスでは試行錯誤が必要になる場合があります。

キューの長さを変更するには、ロジックアプリプロジェクトのルートレベルの host.json ファイルで、Runtime.ScaleMonitor.KEDA.TargetQueueLength プロパティを設定します。次に例を示します。

"extensions": {
   "workflow": {
      "settings": {
         "Runtime.ScaleMonitor.KEDA.TargetQueueLength": "10"
      }
   }
}

スループットの最大値を変更する

既存のロジックアプリリソースで、worker インスタンスの最大数 (既定値は 2 に設定されています) を変更できます。この値によって、ジョブキューを監視できる worker インスタンスの数の上限を制御します。

この最大値を変更するには、Azure CLI (ロジックアプリの作成のみ) と Azure portal を使用します。

Azure CLI

新しいロジックアプリを作成するには、次のパラメーターを指定してコマンド az logicapp create を実行します。

az logicapp create --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription 
   --storage-account MyStorageAccount --custom-location MyCustomLocation 
   [--plan MyHostingPlan] [--min-worker-count 1] [--max-worker-count 4]

インスタンスの最大数を構成するには、--settings パラメーターを使用します。

az logicapp config appsettings set --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription
   --settings "K8SE_APP_MAX_INSTANCE_COUNT=10"

Azure portal

シングルテナントベースのロジックアプリの設定で、こちらの手順に従って、K8SE_APP_MAX_INSTANCE_COUNT の設定値を追加または編集します。

Azure portal で、シングルテナントベースのロジックアプリを検索して開きます。
ロジックアプリメニューの [設定] で、 [構成] を選択します。
[構成] ペインの [アプリケーション設定] で、新しいアプリケーション設定を追加するか、既に追加されている場合は既存の値を編集します。
1. [新しいアプリケーション設定] を選択し、必要な最大値を指定した設定 K8SE_APP_MAX_INSTANCE_COUNT を追加します。
2. 設定 K8SE_APP_MAX_INSTANCE_COUNT の既存の値を編集します。
完了したら、変更を保存します。

スループットの最小値を変更する

既存のロジックアプリリソースで、worker インスタンスの最小数 (既定値は 1 に設定されています) を変更できます。この値によって、ジョブキューを監視できる worker インスタンスの数の下限を制御します。高可用性またはパフォーマンスを実現するには、この値を大きくします。

この最小値を変更するには、Azure CLI または Azure portal を使用します。

Azure CLI

既存のロジックアプリのリソースの場合は、次のパラメーターを指定してコマンド az logicapp scale を実行します。

az logicapp scale --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription 
   --instance-count 5

新しいロジックアプリを作成するには、次のパラメーターを指定してコマンド az logicapp create を実行します。

az logicapp create --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription 
   --storage-account MyStorageAccount --custom-location MyCustomLocation 
   [--plan MyHostingPlan] [--min-worker-count 2] [--max-worker-count 4]

Azure portal

シングルテナントベースのロジックアプリの設定で、こちらの手順に従って [Scale Out] プロパティの値を変更します。

Azure portal で、シングルテナントベースのロジックアプリを検索して開きます。
ロジックアプリのメニューの [設定] で、 [Scale Out] を選択します。
[Scale Out] ペインで、最小インスタンススライダーを目的の値にドラッグします。
完了したら、変更を保存します。

問題のトラブルシューティング

デプロイしたロジックアプリの詳細情報を取得するには、次のオプションを試してください。

アプリの設定と構成にアクセスする

アプリの設定にアクセスするには、次のパラメーターを指定してコマンド az logicapp config appsettings を実行します。

az logicapp config appsettings list --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription

アプリの設定を構成するには、次のパラメーターを指定してコマンド az logicapp config appsettings set を実行します。ご自分の設定の名前と値を持つ --settings パラメーターを必ず使用してください。

az logicapp config appsettings set --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription 
   --settings "MySetting=1"

アプリの設定を削除するには、次のパラメーターを指定してコマンド az logicapp config appsettings delete を実行します。削除する設定の名前を持つ --setting-names パラメーターを必ず使用してください。

az logicapp config appsettings delete --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription
   --setting-names MySetting

ロジックアプリのプロパティを表示する

アプリの情報とプロパティを表示するには、次のパラメーターを指定してコマンド az logicapp show を実行します。

az logicapp show --name MyLogicAppName 
   --resource-group MyResourceGroupName --subscription MySubscription

ワークフローアクティビティを監視する

ロジックアプリでワークフローのアクティビティを表示するには、こちらの手順を実行します。

Azure portal で、デプロイされたロジックアプリを見つけて開きます。
ロジックアプリのメニューで、[ワークフロー] を選択し、ワークフローを選択します。
[ワークフロー] メニューで、[モニター] を選択します。

ログの収集

ロジックアプリに関するログデータを取得するには、ロジックアプリで Application Insights を有効にします (まだ有効になっていない場合)。

次の手順

Azure Arc 対応 Logic Apps について

Azure Arc 対応 Logic Apps を使用してシングルテナント ベースのロジック アプリ ワークフローを作成してデプロイする (プレビュー)

前提条件

ロジック アプリを作成してデプロイする

環境と CLI バージョンを確認する

Azure Logic Apps (Standard) の Azure CLI 用拡張機能をインストールする

リソース グループの作成

ロジック アプリを作成する

ロジック アプリの詳細を表示する

ロジック アプリをデプロイする

ロジック アプリを起動する

ロジック アプリを停止する

ロジック アプリを再起動する

ロジック アプリを削除する

接続の認証を設定する

プロジェクトで接続とアプリの設定を構成する

アクセス ポリシーを追加する

ARM テンプレート

Azure portal

DevOps のデプロイを自動化する

標準のデプロイ (コンテナー以外)

ARM テンプレート

コンテナーのデプロイ

ARM テンプレート

デプロイに App Service プランを含める

ARM テンプレート

既定のスケーリング動作を変更する

スケーリングを変更するための前提条件

スケーリングしきい値を変更する

スループットの最大値を変更する

Azure CLI

Azure portal

スループットの最小値を変更する

Azure CLI

Azure portal

問題のトラブルシューティング

アプリの設定と構成にアクセスする

ロジック アプリのプロパティを表示する

ワークフロー アクティビティを監視する

ログの収集

次の手順

その他のリソース

Azure Arc 対応 Logic Apps を使用してシングルテナントベースのロジックアプリワークフローを作成してデプロイする (プレビュー)

ロジックアプリを作成してデプロイする

リソースグループの作成

ロジックアプリを作成する

ロジックアプリの詳細を表示する

ロジックアプリをデプロイする

ロジックアプリを起動する

ロジックアプリを停止する

ロジックアプリを再起動する

ロジックアプリを削除する

アクセスポリシーを追加する

ロジックアプリのプロパティを表示する

ワークフローアクティビティを監視する