シングルテナントの Azure Logic Apps で Standard ロジック アプリのアプリとホストの設定を編集する

適用対象: Azure Logic Apps (Standard)

このガイドでは、シングルテナントの Azure Logic Apps で Standard ロジック アプリのランタイムと環境設定を管理する方法について説明します。

標準ロジック アプリのアプリ設定 では、そのロジック アプリ 内のすべてのワークフロー に影響するグローバル構成オプションを指定します。 ただし、これらの設定は、これらのワークフローがローカル開発環境で実行されている場合にのみ適用されます。 これらのアプリ設定は、ローカルで実行されているワークフローから "ローカル環境変数" としてアクセスでき、環境間で変わることが多い値に対して、ローカル開発ツールで使用されます。 たとえば、これらの値には接続文字列を含めることができます。 Azure にデプロイするとき、アプリ設定は無視され、デプロイには含まれません。

ロジック アプリにはホスト設定もあります。この設定では、ローカルで実行するか Azure で実行するかに関係なく、スループット、容量、データ サイズなどの既定値など、そのロジック アプリ内のすべてのワークフローに適用されるランタイム構成設定と値を指定します。

設定は、設定名と値を定義する キーと値 のペアです。

アプリ設定、パラメーター、デプロイ

マルチテナント Azure Logic Apps では、デプロイは、ロジック アプリとインフラストラクチャの両方のリソース プロビジョニングを組み合わせて処理する Azure Resource Manager テンプレート (ARM テンプレート) に依存します。 この設計では、さまざまな開発、テスト、運用環境でロジック アプリの環境変数を維持する必要がある場合に、課題が生じます。 ARM テンプレート内のすべては、デプロイ時に定義されます。 1 つの変数を変更するだけでよい場合も、すべてを再デプロイする必要があります。

シングルテナントの Azure Logic Apps では、アプリとインフラストラクチャ間でリソース プロビジョニングを分離できるため、デプロイが簡単になります。 パラメーターを使用すると、環境間で変更される可能性のある値を抽象化できます。 ワークフローで使用するパラメーターを定義することで、まずワークフローの設計に集中し、後で環境固有の変数を挿入できます。 アプリ設定とパラメーターを使用して、実行時に環境変数を呼び出して参照できます。 そうすることで、頻繁に再デプロイする必要がなくなります。

アプリ設定は、Azure Key Vault と統合できます。 接続文字列やキーなど、セキュリティで保護された文字列を直接参照できます。 デプロイ時に環境変数を定義できる ARM テンプレートと同様に、 ロジック アプリ ワークフロー定義内でアプリ設定を定義できます。 そうしておいて、接続エンドポイントやストレージ文字列などの動的に生成されるインフラストラクチャ値を取得できます。 ただし、アプリ設定にはサイズの制限があり、Azure Logic Apps の特定の領域からは参照できません。

デプロイ用にロジック アプリを設定する方法の詳細については、次のドキュメントを参照してください。

• Azure Logic Apps のワークフロー入力のためのクロス環境パラメーターを作成する
• シングルテナント ベースのロジック アプリ用の DevOps デプロイの概要
• シングルテナント ベースのロジック アプリ用の DevOps デプロイを設定する

Visual Studio Code プロジェクトの構造

Visual Studio Code では、ロジック アプリ プロジェクトには次のいずれかの種類があります。

• 拡張バンドルベース (Node.js) (既定の種類)
• NuGet パッケージベース (.NET) (既定の種類から変換できます)

これらの種類に基づいて、プロジェクトには多少異なるフォルダーやファイルが含まれる場合があります。 たとえば、Nuget パッケージベースのプロジェクトには、パッケージやその他のライブラリ ファイルを含む .bin フォルダーがあります。 拡張機能バンドルベースのプロジェクトには、この .bin フォルダーは含まれません。

一部のシナリオでは、たとえば、カスタムの組み込み操作を開発して実行する場合などに、アプリを実行するために NuGet パッケージベースのプロジェクトが必要です。 NuGet を使用するようにプロジェクトを変換する方法の詳細については、「組み込みコネクタの作成を有効にする」を参照してください。

既定の拡張機能バンドルベースのプロジェクトには、次の例のようなフォルダーとファイル構造があります。

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

プロジェクトのルート レベルには、他の項目と共に次のフォルダーとファイルがあります。

アプリ設定のリファレンス - local.settings.json

Visual Studio Code では、ロジック アプリ プロジェクトのルート レベルで、 local.settings.json ファイルには、ローカル開発環境での実行中にそのロジック アプリ 内のすべてのワークフロー に影響を与えるグローバル構成オプションが含まれています。 ワークフローがローカルで実行されている場合、これらの設定はローカル環境変数としてアクセスされます。それらの値は、多くの場合、ワークフローを実行するさまざまな環境間で変わる可能性があります。 これらの設定を表示および管理する方法については、「 アプリ設定の管理 - local.settings.json」を参照してください。

Azure Logic Apps のアプリ設定は、Azure Functions または Azure Web Apps のアプリ設定と同様に機能します。 以前にこれらの他のサービスを使用したことがある場合は、既にアプリ設定に慣れていることもあるでしょう。 詳細については、「 Azure Functions のアプリ設定リファレンス 」および「 Azure Functions Core Tools の操作 - ローカル設定ファイル」を参照してください。

次の表では、ロジック アプリで使用されるアプリの設定について説明します。 ロジック アプリが正しく動作するためには、いくつかの設定が必要です。

アプリ設定の管理 - local.settings.json

アプリ設定を追加、更新、または削除するには、Azure portal、Visual Studio Code、または Azure CLI の次のセクションを選択して確認します。 ロジック アプリに固有のアプリ設定については、「 アプリ設定のリファレンス - local.settings.json」を 参照してください。

az logicapp config appsettings list --name <MyLogicApp> --resource-group <MyResourceGroup>

az logicapp config appsettings set --name <MyLogicApp> --resource-group <MyResourceGroup> --settings CUSTOM_LOGIC_APP_SETTING=12345 

ホスト設定のリファレンス - host.json

Visual Studio Code では、ロジック アプリ プロジェクトのルート レベルで、 host.json メタデータ ファイルには、ローカルまたは Azure で実行されているかどうかにかかわらず、ロジック アプリ リソース 内のすべてのワークフロー に適用されるランタイム設定と既定値が含まれています。 これらの設定を表示および管理する方法については、「 ホスト設定の管理 - host.json」を参照してください。 また、関連する制限の情報については、Azure Logic Apps の制限と構成に関するドキュメントも参照してください。

ジョブ オーケストレーションのスループット

これらの設定は、シングルテナントの Azure Logic Apps でワークフロー操作を実行するためのスループットと容量に影響します。

次の設定は、Standard ロジック アプリで指定されたワークフローを手動で停止して直ちに削除するために使用されます。

個々のワークフローを指定するには、次の構文を使用します。各ワークフロー ID の後にコロン (:) が続き、セミコロン (;) で区切られます。

"Jobs.CleanupJobPartition": "<workflow-ID-1>:;<workflow-ID-2>",
"Jobs.SuspendedJobPartition": "<workflow-ID-1>:;<workflow-ID-2>:",
"SequencerJobs.SuspendedSequencerPartition": "<workflow-ID-1>:;<workflow-ID-2>:"

特定の実行を取り消すには、ワークフロー ID に続く実行 ID を区切り記号として 2D で指定します。次に例を示します。

"Jobs.SuspendedJobPartition": "<workflow-ID-1>:2D<run-ID>;",

繰り返しベースのトリガー

並列処理をトリガーする

次のコンカレンシー設定は、 組み込みのサービス プロバイダー ベースのコネクタ の繰り返しベースのトリガーで始まり、同時に実行されるワークフローの数を制御するワークフローにのみ適用されます。

関数ベースのトリガーで始まるワークフローの場合で、サポートされている場合はバッチ処理を設定してみることをお勧めします。 ただし、バッチ処理が必ずしも適切な解決策であるとは限りません。 たとえば、Azure Service Bus トリガーでは、バッチでロック期間を超えてメッセージが保持される可能性があります。 その結果、そのようなメッセージに対する完了や破棄などのアクションは失敗します。

実行継続時間および履歴保有

アクションの実行

関数ベースの組み込み操作のタイムアウト値を変更する

Azure Functions で関数呼び出しとして実行される組み込み操作の場合は、次の例に示すように、Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeoutとfunctionTimeoutの両方のホスト設定をhost.jsonファイルに追加します。

{
   "version": "2.0",
   "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
      "version": "[1.*, 2.0.0)"
   },
   "extensions": {
      "workflow": {
         "settings": {
            "Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout": "01:00:00"
         }
      }
   },
   "functionTimeout": "01:00:00"
}

入力と出力

Pagination

Chunking

コンテンツをインラインで格納するか、BLOB を使用する

For each ループ

Until ループ

Variables

組み込みの HTTP 操作

組み込みの HTTP Webhook 操作

組み込みの Azure Storage 操作

ブロブストレージ

テーブルおよびキュー ストレージ

ファイル共有

組み込みの Azure Functions 操作

組み込みの Azure Service Bus 操作

組み込みの SFTP 操作

マネージド コネクタの操作

他のすべての操作の再試行ポリシー

Limitations

最大コンテンツ サイズ:

既定では、HTTP または要求などの組み込みのトリガーは、「制約と構成の参考文献 - メッセージ」の中で説明されているメッセージ サイズに制限されます。 その制限を超えるファイルを処理するには、ご利用のコンテンツを BLOB として Azure Blob Storage にアップロードし、それから Azure Blob コネクタを使用してそのコンテンツを取得してみてください。

ホスト設定の管理 - host.json

ホスト設定を追加、更新、または削除できます。これは、"ローカルと Azure のどちらで実行される場合でも" そのロジック アプリ内の "すべてのワークフロー" に適用される、ランタイム構成の設定と値を指定するもので、例として、スループット、容量、データ サイズなどの既定値があります。 ロジック アプリに固有のホスト設定については、「 ホスト設定のリファレンス - host.json」を 参照してください。

関連コンテンツ

• Azure Logic Apps のワークフロー入力のためのクロス環境パラメーターを作成する
• シングルテナントの Azure Logic Apps に Standard ロジック アプリの DevOps デプロイを設定する