ハイブリッド デプロイを使用して独自のインフラストラクチャを Standard ロジック アプリ用に設定する (プレビュー)

適用対象: Azure Logic Apps (Standard)

Note

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

場合によっては、規制コンプライアンス、データのプライバシー、またはネットワーク制限に対する特定のニーズを満たすために、独自のインフラストラクチャを設定および管理する必要があります。 Azure Logic Apps には、オンプレミス、プライベート クラウド、またはパブリック クラウドのシナリオで Standard ロジック アプリ ワークフローをデプロイおよびホストできるように "ハイブリッド デプロイ モデル" が用意されています。 このモデルによって、ローカル処理、データ ストレージ、ネットワーク アクセスを使用する必要があるときに、部分的に接続された環境で統合ソリューションをホストする機能が提供されます。 ハイブリッド オプションを使用すると、ワークフローに最適な環境を自由に、かつ柔軟に選択できます。

ハイブリッド デプロイのしくみ

ハイブリッド デプロイ オプションを使用した Standard ロジック アプリ ワークフローは、Azure Container Apps 拡張機能でホストされている Azure Logic Apps ランタイムを活用します。 ワークフローでは、ローカル データ ソースへのアクセスのスループットが向上するように、すべての組み込み操作がこのランタイムを使用してローカルで実行されます。 ローカル以外のデータ リソース (たとえば、Microsoft Office 365、Microsoft Teams、Salesforce、GitHub、LinkedIn、ServiceNow などのクラウド ベースのサービス) へのアクセスが必要な場合は、Azure でホストされている 1,000 個を超えるコネクタから操作を選択してワークフローに含めることができます。 詳細については、マネージド (共有) コネクタに関するページを参照してください。 Azure portal でロジック アプリを管理するにはインターネット接続が必要ですが、このプラットフォームの半接続の性質により、一時的なインターネット接続の問題をすべて吸収できます。

たとえば、オンプレミスのシナリオがある場合は、次のアーキテクチャの概要によって、Standard ロジック アプリ ワークフローがハイブリッド モデル内のどこでホストされ、実行されるかが示されます。 部分的に接続された環境には、Azure Container Apps リソースとしてデプロイされる Standard ロジック アプリをホストして操作するための次のリソースが含まれています。

• Azure Arc 対応 Azure Kubernetes Service (AKS) クラスター
• ワークフローの実行履歴、入力、出力を処理のためにローカルに格納する SQL データベース
• ワークフローで使用される成果物をローカルに格納するサーバー メッセージ ブロック (SMB) ファイル共有

ホスティングについては、Azure Stack "ハイパーコンバージド" インフラストラクチャ (HCI) 上の Azure Arc 対応 Kubernetes クラスターまたは Windows Server 上の Azure Arc 対応 Kubernetes クラスターを設定して使用することもできます。

詳しくは、次のドキュメントをご覧ください。

• Azure Kubernetes Service とは
• Azure Kubernetes Services (AKS) の中心概念
• Azure Arc 対応 Kubernetes クラスターのためのカスタムの場所
• Azure Container Apps とは
• Azure Arc 上の Azure Container Apps

このハウツー ガイドでは、ハイブリッド デプロイ モデルを使用して Standard ロジック アプリ ワークフローを作成、デプロイ、ホストできるように、インフラストラクチャ内に必要なオンプレミス リソースを設定する方法を示します。

請求体系について

ハイブリッド オプションでは、次の項目はユーザーが責任を負います。

• Azure Arc 対応 Kubernetes インフラストラクチャ
• SQL Server ライセンス
• Standard ロジック アプリ ワークロードをサポートするための vCPU/時間あたり 0.18 米国ドルの課金料金

この課金モデルでは、ピーク時の使用量を購入しなくても、必要な分だけ支払い、動的ワークロードに対してリソースをスケーリングできます。 Azure でホストされるコネクタ操作を使用するワークフロー (Microsoft Teams や Microsoft Office 365 など) の場合は、既存の Standard (シングルテナント) 価格がこれらの操作の実行に適用されます。

制限事項

• ハイブリッド デプロイは現在使用可能であり、次の Azure Arc 対応 Kubernetes クラスターでのみサポートされています。

  • Azure Arc 対応 Kubernetes クラスター
  • Azure Stack HCI 上の Azure Arc 対応 Kubernetes クラスター
  • Windows Server 上の Azure Arc 対応 Kubernetes クラスター

前提条件

• Azure アカウントとサブスクリプション。 サブスクリプションをお持ちでない場合には、無料の Azure アカウントにサインアップしてください。

• AKS の中心概念に関する基本的な理解

• Azure CLI を操作するための技術的な要件

• Azure Arc 対応 Kubernetes 上の Azure Container Apps に関する技術的な要件。Azure Container Registry などのパブリックまたはプライベート コンテナー レジストリへのアクセスが含まれます。

Kubernetes クラスターを作成する

Standard ロジック アプリを Azure Container Apps 接続環境内の Azure Arc 対応 Kubernetes クラスターにオンプレミス リソースとしてデプロイするには、まず Kubernetes クラスターが必要です。 このクラスターは、後で Azure Arc に接続して Azure Arc 対応 Kubernetes クラスターになるようにします。

Kubernetes クラスターには、ストレージ プロバイダーとして後で作成する SQL データベースと、成果物ストレージのために後で作成するサーバー メッセージ ブロック ファイル共有との受信および送信接続が必要です。 これらのリソースは、同じネットワーク内に存在する必要があります。

Note

Azure Stack HCI インフラストラクチャ上の Kubernetes クラスターまたは Windows Server 上の Kubernetes クラスターを作成し、このガイドの手順を適用してそのクラスターを Azure Arc に接続し、接続環境を設定することもできます。 Azure Stack HCI および Windows Server 上の AKS の詳細については、次のリソースを参照してください。

• Azure Stack HCI について
• Azure Stack HCI のデプロイの前提条件
• Azure CLI を使用して Azure Stack HCI 上に Kubernetes クラスターを作成する
• PowerShell を使用して Azure Stack HCI および Windows Server 上に Azure Kubernetes Service ホストを設定し、ワークロード クラスターをデプロイする

1. 作成する Kubernetes クラスターの次の環境変数を設定します。

   SUBSCRIPTION="<Azure-subscription-ID>"
   AKS_CLUSTER_GROUP_NAME="<aks-cluster-resource-group-name>"
   AKS_NAME="<aks-cluster-name>"
   LOCATION="eastus"
   

   パラメーター	必須	値	説明
   SUBSCRIPTION	はい	<Azure-subscription-ID>	Azure サブスクリプションの ID
   AKS_CLUSTER_GROUP_NAME	はい	<aks-cluster-resource-group-name>	Kubernetes クラスターで使用する Azure リソース グループの名前。 この名前は、リージョン間で一意である必要があり、文字、数字、ハイフン (-)、アンダースコア (_)、かっこ (())、ピリオド (.) のみを含めることができます。 この例では、Hybrid-RG を使用します。
   AKS_NAME	はい	<aks-cluster-name>	Kubernetes クラスターの名前。
   LOCATION	はい	<Azure-region>	Azure Arc 対応 Kubernetes 上の Azure コンテナー アプリをサポートする Azure リージョン。 この例では、eastus を使います。

2. Azure Cloud Shell の Bash 環境を使用するか、またはコンピューターにインストールされている Azure CLI をローカルで使用して、次のコマンドを実行します。

   Note

   max-count および min-count ノードの値を負荷要件に基づいて必ず変更してください。

   az login
   az account set --subscription $SUBSCRIPTION
   az provider register --namespace Microsoft.KubernetesConfiguration --wait
   az extension add --name k8s-extension --upgrade --yes
   az group create
      --name $AKS_CLUSTER_GROUP_NAME
      --location $LOCATION
   az aks create \
      --resource-group $AKS_CLUSTER_GROUP_NAME \
      --name $AKS_NAME \
      --enable-aad \
      --generate-ssh-keys \
      --enable-cluster-autoscaler \
      --max-count 6 \
      --min-count 1
   

   パラメーター	必須	値	説明
   max count	いいえ	<max-nodes-value>	enable-cluster-autoscaler オプションを含めるときに、オートスケーラーに使用するノードの最大数。 この値の範囲は 1 から 1000 までです。
   min count	いいえ	<min-nodes-value>	enable-cluster-autoscaler オプションを含めるときに、オートスケーラーに使用するノードの最小数。 この値の範囲は 1 から 1000 までです。

   詳細については、次のリソースを参照してください。

   • クイック スタート: Azure CLI を使用して Azure Kubernetes Service (AKS) クラスターをデプロイする
   • az account set
   • az group create
   • az aks create

Kubernetes クラスターを Azure Arc に接続する

Azure Arc 対応 Kubernetes クラスターを作成するには、Kubernetes クラスターを Azure Arc に接続します。

Note

このセクション以降、接続環境の作成までの手順は、Azure/logicapps という名前の GitHub リポジトリにある EnvironmentSetup.ps1 という名前のスクリプトで見つけることができます。 このスクリプトを実際の要件やシナリオを満たすように変更して使用できます。

このスクリプトは署名されていないため、スクリプトを実行する前に、次の Azure PowerShell コマンドを管理者として実行して実行ポリシーを設定してください。

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

詳細については、「Set-ExecutionPolicy」を参照してください。

1. 次の Azure CLI 拡張機能をインストールします。

   az extension add --name connectedk8s --upgrade --yes 
   az extension add --name k8s-extension --upgrade --yes 
   az extension add --name customlocation --upgrade --yes 
   az extension add --name containerapp --upgrade --yes 
   

   詳細については、次のリソースを参照してください。

   • Azure CLI 拡張機能をインストールする
   • az extension add

2. 次の必要な名前空間を登録します。

   az provider register --namespace Microsoft.ExtendedLocation --wait
   az provider register --namespace Microsoft.KubernetesConfiguration --wait
   az provider register --namespace Microsoft.App --wait
   az provider register --namespace Microsoft.OperationalInsights --wait
   

   詳細については、次のリソースを参照してください。

   • 必要な名前空間を登録する
   • az provider register

3. kubectl という名前の Kubernetes コマンド ライン インターフェイス (CLI) をインストールします。

   Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
   
   choco install kubernetes-cli -y
   

   詳細については、次のリソースを参照してください。

   • コマンド ライン ツール (kubectl)
   • Set-ExecutionPolicy
   • choco install kubernetes-cli

4. Helm という名前の Kubernetes パッケージ マネージャーをインストールします。

   choco install kubernetes-helm
   

   詳細については、次のリソースを参照してください。

   • Helm
   • choco install kubernetes-helm

5. 次の Helm コマンドを使用して SMB ドライバーをインストールします。

   1. 指定されたグラフ リポジトリを追加し、使用可能なグラフに関する最新情報を入手して、指定されたグラフ アーカイブをインストールします。

      helm repo add csi-driver-smb https://raw.githubusercontent.com/kubernetes-csi/csi-driver-smb/master/charts 
      helm repo update
      helm install csi-driver-smb csi-driver-smb/csi-driver-smb --namespace kube-system --version v1.15.0 
      

      詳細については、次のリソースを参照してください。

      • helm repo add
      • helm repo update
      • helm install

   2. 次の kubectl コマンドを実行して、SMB ドライバーがインストールされていることを確認します。これにより、smb.csi.k8s.io が一覧表示されるはずです。

      kubectl get csidriver
      

      詳細については、「kubectl get」を参照してください。

Kubernetes クラスターを Azure Arc に接続する

1. kubeconfig ファイルを取得して、クラスターへの接続をテストします。

   az aks get-credentials \
      --resource-group $AKS_CLUSTER_GROUP_NAME \
      --name $AKS_NAME \
      --admin
   kubectl get ns 
   

   既定では、kubeconfig ファイルはパス ~/.kube/config に保存されます。このコマンドは今回の Kubernetes クラスターの例に適用され、他の種類の Kubernetes クラスターでは異なります。

   詳細については、次のリソースを参照してください。

   • 接続されているクラスターを作成する
   • az aks get-credentials
   • kubectl get

2. Kubernetes クラスターのデプロイに基づいて、次の環境変数を設定して、Azure Arc 対応クラスターとリソースを含む Azure リソース グループに使用する名前を指定します。

   GROUP_NAME="<Azure-Arc-cluster-resource-group-name>"
   

   パラメーター	必須	値	説明
   GROUP_NAME	はい	<Azure-Arc-cluster-resource-group-name>	Azure Arc 対応クラスターとその他のリソース (Azure Container Apps 拡張機能、カスタムの場所、Azure Container Apps 接続環境など) で使用する Azure リソース グループの名前。 この名前は、リージョン間で一意である必要があり、文字、数字、ハイフン (-)、アンダースコア (_)、かっこ (())、ピリオド (.) のみを含めることができます。 この例では、Hybrid-Arc-RG を使用します。

3. Azure Arc 対応クラスターとリソースのための Azure リソース グループを作成します。

   az group create \
      --name $GROUP_NAME \
      --location $LOCATION
   

   詳細については、次のリソースを参照してください。

   • 接続されているクラスターを作成する
   • az group create

4. Azure Arc 対応 Kubernetes クラスターの名前を指定するには、次の環境変数を設定します。

   CONNECTED_CLUSTER_NAME="$GROUP_NAME-cluster"
   

   パラメーター	必須	値	説明
   CONNECTED_CLUSTER_NAME	はい	<Azure-Arc-cluster-resource-group-name>-cluster	Azure Arc 対応クラスターに使用する名前。 この名前は、リージョン間で一意である必要があり、文字、数字、ハイフン (-)、アンダースコア (_)、かっこ (())、ピリオド (.) のみを含めることができます。 この例では、Hybrid-Arc-RG-cluster を使用します。

5. 以前に作成された Kubernetes クラスターを Azure Arc に接続します。

   az connectedk8s connect \
      --resource-group $GROUP_NAME \
      --name $CONNECTED_CLUSTER_NAME
   

   詳細については、次のリソースを参照してください。

   • 接続されているクラスターを作成する
   • az connectedk8s connect

6. Azure Arc と Kubernetes クラスターの間の接続を検証します。

   az connectedk8s show \
      --resource-group $GROUP_NAME \
      --name $CONNECTED_CLUSTER_NAME
   

   この出力に provisioningState プロパティ値が Succeeded に設定されていないことが示されている場合は、1 分後に、このコマンドをもう一度実行します。

   詳細については、次のリソースを参照してください。

   • 接続されているクラスターを作成する
   • az connectedk8s show

Azure Log Analytics ワークスペースを作成する

Azure Arc 対応 Kubernetes クラスターで実行されるアプリに関するログへのアクセスを提供する、省略可能ではあるが推奨される Azure Log Analytics ワークスペースを作成できます。

1. Log Analytics ワークスペースの名前を指定するには、次の環境変数を設定します。

   WORKSPACE_NAME="$GROUP_NAME-workspace"
   

   パラメーター	必須	値	説明
   WORKSPACE_NAME	はい	<Azure-Arc-cluster-resource-group-name>-workspace	Log Analytics ワークスペースに使用する名前。 この名前は、リソース グループ内で一意である必要があります。 この例では、Hybrid-Arc-RG-workspace を使用します。

2. Log Analytics ワークスペースを作成します。

   az monitor log-analytics workspace create \
      --resource-group $GROUP_NAME \
      --workspace-name $WORKSPACE_NAME
   

   詳細については、次のリソースを参照してください。

   • Log Analytics ワークスペースの作成
   • az monitor log-analytics

3. Log Analytics ワークスペースの Base64 でエンコードされた ID と共有キーを取得します。 これらの値は後の手順に必要です。

   LOG_ANALYTICS_WORKSPACE_ID=$(az monitor log-analytics workspace show \
      --resource-group $GROUP_NAME \
      --workspace-name $WORKSPACE_NAME \
      --query customerId \
      --output tsv)
   
   LOG_ANALYTICS_WORKSPACE_ID_ENC=[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($LOG_ANALYTICS_WORKSPACE_ID))
   
   LOG_ANALYTICS_KEY=$(az monitor log-analytics workspace get-shared-keys \
      --resource-group $GROUP_NAME \
      --workspace-name $WORKSPACE_NAME \
      --query primarySharedKey \
      --output tsv)
   
   LOG_ANALYTICS_KEY_ENC=[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($LOG_ANALYTICS_KEY))
   

   パラメーター	必須	値	説明
   LOG_ANALYTICS_WORKSPACE_ID	はい	Log Analytics ワークスペースの ID。
   LOG_ANALYTICS_WORKSPACE_ID_ENC	はい	Log Analytics ワークスペースの Base64 でエンコードされた ID。
   LOG_ANALYTICS_KEY	はい	Log Analytics ワークスペースの共有キー。
   LOG_ANALYTICS_ENC	はい	Log Analytics ワークスペースの Base64 でエンコードされた共有キー。

   詳細については、次のリソースを参照してください。

   • Log Analytics ワークスペースの作成
   • az monitor log-analytics

Azure Container Apps 拡張機能を作成してインストールする

次に、Azure Arc 対応 Kubernetes クラスターをオンプレミス リソースとして使用して、Azure Container Apps 拡張機能を作成してインストールします。

重要

Azure Stack HCI 上の AKS にデプロイする場合は、Azure Container Apps 拡張機能を作成してインストールする前に、必ず HAProxy またはカスタム ロード バランサーを設定してください。

1. 次の環境変数を次の値に設定します。

   EXTENSION_NAME="logicapps-aca-extension"
   NAMESPACE="logicapps-aca-ns"
   CONNECTED_ENVIRONMENT_NAME="<connected-environment-name>"
   

   パラメーター	必須	値	説明
   EXTENSION_NAME	はい	logicapps-aca-extension	Azure Container Apps 拡張機能の名前。
   NAMESPACE	はい	logicapps-aca-ns	リソースをプロビジョニングするクラスター名前空間。
   CONNECTED_ENVIRONMENT_NAME	はい	<connected-environment-name>	Azure Container Apps 接続環境に使用する一意の名前。 この名前は、Azure Container Apps 接続環境で作成、デプロイ、ホストする Standard ロジック アプリのドメイン名の一部になります。

2. Azure Arc 対応 Kubernetes クラスターに対して有効になっている Log Analytics で拡張機能を作成してインストールします。 この拡張機能に後で Log Analytics を追加することはできません。

   az k8s-extension create \
      --resource-group $GROUP_NAME \
      --name $EXTENSION_NAME \
      --cluster-type connectedClusters \
      --cluster-name $CONNECTED_CLUSTER_NAME \
      --extension-type 'Microsoft.App.Environment' \
      --release-train stable \
      --auto-upgrade-minor-version true \
      --scope cluster \
      --release-namespace $NAMESPACE \
      --configuration-settings "Microsoft.CustomLocation.ServiceAccount=default" \
      --configuration-settings "appsNamespace=${NAMESPACE}" \
      --configuration-settings "keda.enabled=true" \
      --configuration-settings "keda.logicAppsScaler.enabled=true" \
      --configuration-settings "keda.logicAppsScaler.replicaCount=1" \
      --configuration-settings "containerAppController.api.functionsServerEnabled=true" \
      --configuration-settings "envoy.externalServiceAzureILB=false" \
      --configuration-settings "functionsProxyApiConfig.enabled=true" \
      --configuration-settings "clusterName=${CONNECTED_ENVIRONMENT_NAME}" \
      --configuration-settings "envoy.annotations.service.beta.kubernetes.io/azure-load-balancer-resource-group=${GROUP_NAME}" \
      --configuration-settings "logProcessor.appLogs.destination=log-analytics" \
      --configuration-protected-settings "logProcessor.appLogs.logAnalyticsConfig.customerId=${LOG_ANALYTICS_WORKSPACE_ID_ENC}" \
      --configuration-protected-settings "logProcessor.appLogs.logAnalyticsConfig.sharedKey=${LOG_ANALYTICS_KEY_ENC}"
   

   パラメーター	必須	説明
   Microsoft.CustomLocation.ServiceAccount	はい	カスタムの場所用に作成されたサービス アカウントです。 推奨事項: この値を default に設定します。
   appsNamespace	はい	アプリの定義とリビジョンを作成するために使用する名前空間。 この値は、Azure Container Apps 拡張機能のリリース名前空間と一致している必要があります。
   clusterName	はい	拡張機能のために作成する Azure Container Apps 拡張機能 Kubernetes 環境の名前。
   keda.enabled	はい	Kubernetes イベント ドリブン自動スケーリング (KEDA) を有効にします。 この値は必須であり、true に設定する必要があります。
   keda.logicAppsScaler.enabled	はい	KEDA で Azure Logic Apps スケーラーを有効にします。 この値は必須であり、true に設定する必要があります。
   keda.logicAppsScaler.replicaCount	はい	起動するロジック アプリ スケーラーの初期数。 この既定値は 1 に設定されています。 環境内にロジック アプリが存在しない場合、この値は 0 にスケールアップまたはスケールダウンします。
   containerAppController.api.functionsServerEnabled	はい	ロジック アプリのワークフロー トリガーを KEDA スケーリング オブジェクトに変換する役割を果たすサービスを有効にします。 この値は必須であり、true に設定する必要があります。
   envoy.externalServiceAzureILB	はい	envoy が内部ロード バランサーまたはパブリック ロード バランサーのどちらとして機能するかを決定します。 - true: envoy は内部ロード バランサーとして機能します。 Azure Logic Apps ランタイムにはプライベート ネットワーク内でしかアクセスできません。 - false: envoy はパブリック ロード バランサーとして機能します。 Azure Logic Apps ランタイムにパブリック ネットワーク経由でアクセスできます。
   functionsProxyApiConfig.enabled	はい	Azure portal から Azure Logic Apps ランタイムへの API アクセスを容易にするプロキシ サービスを有効にします。 この値は必須であり、true に設定する必要があります。
   envoy.annotations.service.beta.kubernetes.io/azure-load-balancer-resource-group	はい。ただし、基になるクラスターが Azure Kubernetes Service である場合のみです。	Kubernetes クラスターが存在するリソース グループの名前。
   logProcessor.appLogs.destination	いいえ	アプリケーション ログに使用する宛先。 この値は、log-analytics または none (これにより、ログ記録が無効になります) のどちらかです。
   logProcessor.appLogs.logAnalyticsConfig.customerId	はい。ただし、logProcessor.appLogs.destination が log-analytics に設定されている場合のみです。	Log Analytics ワークスペースの Base64 でエンコードされた ID。 このパラメーターは、必ず保護された設定として構成してください。
   logProcessor.appLogs.logAnalyticsConfig.sharedKey	はい。ただし、logProcessor.appLogs.destination が log-analytics に設定されている場合のみです。	Log Analytics ワークスペースの Base64 でエンコードされた共有キー。 このパラメーターは、必ず保護された設定として構成してください。

   詳細については、次のリソースを参照してください。

   • Azure Container Apps 拡張機能をインストールする
   • az k8s-extension create

3. Azure Container Apps 拡張機能の ID 値を後で使用するために保存します。

   EXTENSION_ID=$(az k8s-extension show \
      --cluster-type connectedClusters \
      --cluster-name $CONNECTED_CLUSTER_NAME \
      --resource-group $GROUP_NAME \
      --name $EXTENSION_NAME \
      --query id \
      --output tsv)
   

   パラメーター	必須	値	説明
   EXTENSION_ID	はい	<extension-ID>	Azure Container Apps 拡張機能の ID。

   詳細については、次のリソースを参照してください。

   • Azure Container Apps 拡張機能をインストールする
   • az k8s-extension show

4. 続行する前に、拡張機能が完全にインストールされるまで待ちます。 ターミナル セッションがインストール完了まで待つようにするには、次のコマンドを実行します。

   az resource wait \
      --ids $EXTENSION_ID \
      --custom "properties.provisioningState!='Pending'" \
      --api-version "2020-07-01-preview" 
   

   詳細については、次のリソースを参照してください。

   • Azure Container Apps 拡張機能をインストールする
   • az resource wait

カスタムの場所を作成する

1. 次の環境変数を指定された値に設定します。

   CUSTOM_LOCATION_NAME="my-custom-location"
   
   CONNECTED_CLUSTER_ID=$(az connectedk8s show \
      --resource-group $GROUP_NAME \
      --name $CONNECTED_CLUSTER_NAME \
      --query id \
      --output tsv)
   

   パラメーター	必須	値	説明
   CUSTOM_LOCATION_NAME	はい	my-custom-location	カスタムの場所に使用する名前。
   CONNECTED_CLUSTER_ID	はい	<Azure-Arc-cluster-ID>	Azure Arc 対応 Kubernetes クラスターの ID。

   詳細については、次のリソースを参照してください。

   • カスタムの場所を作成する
   • az k8s-extension show

2. カスタムの場所を作成する:

   az customlocation create \
      --resource-group $GROUP_NAME \
      --name $CUSTOM_LOCATION_NAME \
      --host-resource-id $CONNECTED_CLUSTER_ID \
      --namespace $NAMESPACE \
      --cluster-extension-ids $EXTENSION_ID \
      --location $LOCATION
   

   Note

   クラスターでのカスタムの場所の作成で問題が発生するときは、クラスターで "カスタムの場所" 機能を有効にすることが必要になる場合があります。 この手順は、サービス プリンシパルを使用して Azure CLI にサインインした場合、またはクラスター リソースに対するアクセス許可が制限された Microsoft Entra ユーザーとしてサインインした場合に必要です。

   詳細については、次のリソースを参照してください。

   • カスタムの場所を作成する
   • az customlocation create

3. カスタムの場所が正常に作成されたことを確認します。

   az customlocation show \
      --resource-group $GROUP_NAME \
      --name $CUSTOM_LOCATION_NAME
   

   この出力に provisioningState プロパティ値が Succeeded に設定されていないことが示されている場合は、1 分後に、このコマンドをもう一度実行します。

4. カスタムの場所 ID を後の手順で使用するために保存します。

   CUSTOM_LOCATION_ID=$(az customlocation show \
      --resource-group $GROUP_NAME \
      --name $CUSTOM_LOCATION_NAME \
      --query id \
      --output tsv)
   

   パラメーター	必須	値	説明
   CUSTOM_LOCATION_ID	はい	<my-custom-location-ID>	カスタムの場所の ID。

   詳細については、次のリソースを参照してください。

   • カスタムの場所を作成する
   • az customlocation show

Azure Container Apps 接続環境を作成する

次に、Standard ロジック アプリで使用する Azure Container Apps 接続環境を作成します。

az containerapp connected-env create \
   --resource-group $GROUP_NAME \
   --name $CONNECTED_ENVIRONMENT_NAME \
   --custom-location $CUSTOM_LOCATION_ID \
   --location $LOCATION

詳細については、次のリソースを参照してください。

• カスタムの場所を作成する
• az containerapp connected-env create

SQL Server ストレージ プロバイダーを作成する

ハイブリッド デプロイ モデルの Standard ロジック アプリ ワークフローでは、ワークフローや Azure Logic Apps ランタイムで使用されるデータ (ワークフローの実行履歴、入力、出力など) のストレージ プロバイダーとして SQL データベースを使用します。

この SQL データベースには Kubernetes クラスターとの受信および送信接続が必要なため、これらのリソースは同じネットワーク内に存在する必要があります。

1. 次のいずれかの SQL Server エディションを設定します。

   • オンプレミスの SQL Server
   • Azure SQL Database
   • Azure SQL Managed Instance
   • Azure Arcによって有効化された SQL Server

   詳細については、SQL データベース ストレージを Standard ロジック アプリ ワークフロー用に設定する方法に関するページを参照してください。

2. この SQL データベースが Arc 対応 Kubernetes クラスターおよび SMB ファイル共有と同じネットワーク内にあることを確認します。

3. 作成した SQL データベースの接続文字列を見つけて保存します。

成果物ストレージの SMB ファイル共有を設定する

ロジック アプリ (コンテナー アプリ) リソースのマップ、スキーマ、アセンブリなどの成果物を格納するには、サーバー メッセージ ブロック (SMB) プロトコルを使用するファイル共有が必要です。

• SMB ファイル共有を設定するには、管理者アクセスが必要です。

• この SMB ファイル共有は、Kubernetes クラスターおよび SQL データベースと同じネットワーク内に存在する必要があります。

• この SMB ファイル共有には、Kubernetes クラスターとの受信および送信接続が必要です。 Azure 仮想ネットワークの制限を有効にしている場合は、そのファイル共有が Kubernetes クラスターと同じ仮想ネットワークまたはピアリングされた仮想ネットワーク内に存在することを確認してください。

• 複数のロジック アプリに同じ正確なファイル共有パスを使用しないでください。

• ロジック アプリごとに別の SMB ファイル共有を使用することも、同じ SMB ファイル共有内のフォルダーが入れ子になっていない限り、それらの異なるフォルダーを使用することもできます。 たとえば、あるロジック アプリでルート パスを使用し、その後に別のロジック アプリでサブフォルダーを使用することはしないでください。

• Visual Studio Code を使用してロジック アプリをデプロイするには、Visual Studio Code を含むローカル コンピューターがファイル共有にアクセスできることを確認してください。

Windows 上で SMB ファイル共有を設定する

SMB ファイル共有が、そのファイル共有をマウントするクラスターと同じ仮想ネットワーク内に存在することを確認してください。

1. Windows で、共有するフォルダーに移動し、ショートカット メニューを開いて [プロパティ] を選択します。

2. [共有] タブで、[共有] を選択します。

3. 開かれたボックスで、ファイル共有にアクセスできるようにしたい人物を選択します。

4. [共有] を選択し、ネットワーク パスのリンクをコピーします。

   ローカル コンピューターがドメインに接続されていない場合は、ネットワーク パス内のコンピューター名を IP アドレスに置き換えます。

5. その IP アドレスを後でホスト名として使用するために保存します。

SMB ファイル共有として Azure Files を設定する

別の方法として、テストの目的で、SMB ファイル共有として Azure Files を使用できます。 SMB ファイル共有が、そのファイル共有をマウントするクラスターと同じ仮想ネットワーク内に存在することを確認してください。

1. Azure portal で、Azure ストレージ アカウントを作成します。

2. ストレージ アカウントのメニューの [データ ストレージ] で、[ファイル共有] を選択します。

3. [ファイル共有] ページのツール バーから、[+ ファイル共有] を選択し、SMB ファイル共有に必要な情報を指定します。

4. デプロイが完了したら、[リソースに移動] を選択します。

5. ファイル共有のメニューで、[概要] を選択します (選択されていない場合)。

6. [概要] ページのツール バーで、[接続] を選択します。 [接続] ペインで、[スクリプトの表示] を選択します。

7. 次の値をコピーし、それらを後で使用するために安全な場所に保存します。

   • ファイル共有のホスト名 (mystorage.file.core.windows.net など)
   • ファイル共有パス
   • localhost\ を含まないユーザー名
   • Password

8. [概要] ページのツール バーで、[+ ディレクトリの追加] を選択し、ディレクトリに使用する名前を指定します。 この名前を後で使用するために保存します。

これらの保存された値は、ロジック アプリ リソースをデプロイするときに SMB ファイル共有の情報を指定するために必要です。

詳細については、SMB Azure ファイル共有の作成に関するページを参照してください。

SMB ファイル共有の接続を確認する

Arc 対応 Kubernetes クラスターと SMB ファイル共有の間の接続をテストしたり、ファイル共有が正しく設定されていることを確認したりするには、次の手順に従います。

• SMB ファイル共有が同じクラスター上にない場合は、Arc 対応 Kubernetes クラスターから SMB ファイル共有が存在する仮想マシンへの ping 操作が機能することを確認します。 ping 操作が機能することを確認するには、次の手順に従います。

  1. Arc 対応 Kubernetes クラスターで、任意の Linux イメージ (BusyBox や Ubuntu など) を実行するテスト ポッドを作成します。

  2. ポッド内のコンテナーに移動し、次の Linux コマンドを実行して iputils-ping パッケージをインストールします。

     apt-get update
     apt-get install iputils-ping
     

• SMB ファイル共有が正しく設定されていることを確認するには、次の手順に従います。

  1. 同じ Linux イメージが含まれているテスト ポッドで、mnt/smb という名前のパスを持つフォルダーを作成します。

  2. mnt フォルダーを含むルートまたはホーム ディレクトリに移動します。

  3. 次のコマンドを実行します。

     - mount -t cifs //{ip-address-smb-computer}/{file-share-name}/mnt/smb -o username={user-name}, password={password}

• 成果物が正しくアップロードされることを確認するには、SMB ファイル共有パスに接続し、成果物ファイルがデプロイ中に指定した正しいフォルダー内に存在するかどうかを確認します。

次のステップ

独自のインフラストラクチャでハイブリッド デプロイ用の Standard ロジック アプリ ワークフローを作成する