次の方法で共有


Windows コンテナーでセルフホステッド統合ランタイムを実行する方法

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新たに試用を開始する方法については、こちらをご覧ください。

Azure Data Factory では、セルフホステッド統合ランタイムに対する Windows コンテナーのサポートが提供されます。 Docker ビルドのソース コードをダウンロードし、独自の継続的デリバリー パイプラインにビルドと実行プロセスを組み合わせることができます。

ヒント

この記事では、互換性のある物理マシンまたは仮想マシン上の Windows コンテナーでセルフホステッド統合ランタイムを実行する方法について説明します。 インフラストラクチャを管理したくない場合は、Azure App Service でセルフホスト型統合ランタイムを実行できます。 詳細については、App Service での Azure Data Factory セルフホステッド統合ランタイム のサンプルを参照してください。

前提条件

はじめに

  1. Docker をインストールして Windows コンテナーを有効にします。

  2. GitHub からコンテナー イメージのソース コードをダウンロードします。

  3. 特定のバージョンの SHIR を使用する必要がある場合は、ダウンロードして SHIR フォルダーに移動できます。

    それ以外の場合、この手順はスキップしてください。 コンテナー イメージのビルド プロセスでは、最新バージョンの SHIR が自動的にダウンロードされます。

  4. シェルでフォルダーを開きます。

    cd "yourFolderPath"
    
  5. Windows コンテナー イメージをビルド:

    docker build . -t "yourDockerImageName" 
    
  6. 環境変数を渡して、特定の引数でコンテナーを実行します。

     docker run -d -e AUTH_KEY=<ir-authentication-key> \
     [-e NODE_NAME=<ir-node-name>] \
     [-e ENABLE_HA={true|false}] \
     [-e HA_PORT=<port>] \
     [-e ENABLE_AE={true|false}] \
     [-e AE_TIME=<expiration-time-in-seconds>] \
     <yourDockerImageName>   
    
名前 必要 Default 説明
AUTH_KEY 必須 セルフホステッド統合ランタイムの認証キー。
NODE_NAME オプション hostname ノードの指定した名前。
ENABLE_HA オプション false 高可用性とスケーラビリティを有効にするフラグ。
HA が有効になっている場合は、同じ IR に登録された最大 4 つのノードがサポートされます。それ以外の場合は 1 つだけが許可されます。
HA_PORT オプション 8060 高可用性クラスターを設定するポート。
ENABLE_AE オプション false オフライン ノードの自動期限終了を有効にするフラグ。
有効にした場合、期限切れのノードは、新しいノードが登録しようとしたときに IR から自動的に削除されます。
ENABLE_HA=true の場合にのみ機能します。
AE_TIME オプション 600 オフライン ノードの有効期限のタイムアウト時間 (秒単位)。
600 (10 分) 以上にする必要があります。

コンテナーの正常性チェック

120 秒の起動期間が経過すると、正常性チェックは 30 秒ごとに定期的に実行されます。 これは、SHIRの正常性ステータスをコンテナー エンジンに提供します。

制限事項

現在、Windows コンテナーでセルフホスト型統合ランタイムを実行する場合、以下の機能はサポートされません。

  • HTTP プロキシ
  • TLS/SSL 証明書を使用した暗号化されたノード間通信
  • バックアップの生成とインポート
  • デーモン サービス
  • 自動更新

Azure App Service で Azure Data Factory のセルフホステッド統合ランタイムをホストする場合、既存のコンテナーを再利用するのではなく、再起動によって新しいコンテナーが作成されるという既知の問題があります。 これにより、コンカレンシー調整などの構成設定が失われ、FQDN-to-IP マッピングのホスト ファイルに対する変更がリセットされ、ノード名が変更されます。