如何在 Windows 容器中运行自承载集成运行时

适用于: Azure 数据工厂 Azure Synapse Analytics

提示

试用 Microsoft Fabric 中的数据工厂,这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用

Azure 数据工厂为自承载集成运行时提供 Windows 容器支持。 你可以下载 Docker 生成源代码,并将生成和运行流程整合到自己的持续交付管道中。

提示

本文介绍如何在兼容的物理机或虚拟机上的 Windows 容器中运行自承载集成运行时。 如果不想管理基础结构,可以在 Azure 应用服务上运行自承载集成运行时。 有关详细信息,请参阅应用服务上的 Azure 数据工厂自承载集成运行时示例。

先决条件

  • Windows 容器要求
  • Docker 2.3 或更高版本
  • 自承载集成运行时 5.2.7713.1 或更高版本

入门

  1. 安装 Docker 并启用 Windows 容器

  2. 从 GitHub 下载容器映像源代码

  3. 如果需要使用特定版本的 SHIR,可以下载该版本并将其移至 SHIR 文件夹。

    否则,请跳过此步骤。 容器映像生成过程会自动下载最新版本的 SHIR。

  4. 在 shell 中打开文件夹:

    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>   
    
名称 必要性 默认 说明
AUTH_KEY 必需 自承载集成运行时的身份验证密钥。
NODE_NAME 可选 hostname 节点的指定名称。
ENABLE_HA 可选 false 用于实现高可用性和可伸缩性的标志。
启用 HA 时,它最多支持 4 个注册到同一 IR 的节点,否则只允许 1 个。
HA_PORT 可选 8060 用于设置高可用性群集的端口。
ENABLE_AE 可选 false 用于启用脱机节点自动过期的标志。
如果启用,当新节点尝试注册时,过期的节点将自动从 IR 中删除。
仅当 ENABLE_HA=true 时适用。
AE_TIME 可选 600 脱机节点的过期超时持续时间(以秒为单位)。
应不小于 600(10 分钟)。

容器运行状况检查

在 120 秒启动时限过后,运行状况检查将每隔 30 秒定期运行。 它会向容器引擎提供 SHIR 的运行状况。

限制

目前,在 Windows 容器中运行自承载集成运行时时,不支持以下功能:

  • HTTP 代理
  • 使用 TLS/SSL 证书进行节点间加密通信
  • 生成和导入备份
  • 守护程序服务
  • 自动更新

在 Azure 应用服务中承载 Azure 数据工厂自承载集成运行时时存在一个已知问题。 Azure 应用服务会创建新的容器,而不是在重启后重用现有容器。 这可能会导致自承载集成运行时节点泄漏问题。