在本地使用语言检测 Docker 容器

利用容器能够在自己的基础结构上托管语言检测 API。 如果你的安全或数据管理要求不能通过远程调用语言检测来完成，则容器可能是一个不错的选择。

先决条件

• 如果没有 Azure 订阅，请创建一个试用帐户。
• 在主机上安装 Docker。 必须将 Docker 配置为允许容器连接 Azure 并向其发送账单数据。
  • 在 Windows 上，还必须将 Docker 配置为支持 Linux 容器。
  • 应基本了解 Docker 概念。
• 使用免费 (F0) 或标准 (S) 定价层的语言资源 。

收集必需的参数

所有 Azure AI 容器都需要三个主要参数。 Microsoft 软件许可条款的值必须为 accept。 还需要终结点 URI 和 API 密钥。

终结点 URI

可在 Azure 门户中相应 Azure AI 服务资源的“概览”页上找到 {ENDPOINT_URI} 值。 转到“概述”页，将鼠标悬停在终结点上就会显示一个“复制到剪贴板” 图标。 在需要的地方复制并使用终结点。

键

{API_KEY} 值用于启动容器，可在 Azure 门户中相应 Azure AI 服务资源的“密钥”页上找到。 转到“密钥”页，选择“复制到剪贴板” 图标。

主机要求和建议

主机是运行 Docker 容器且基于 x64 的计算机。 它可以是本地计算机或 Azure 中的 Docker 托管服务，例如：

• Azure Kubernetes 服务。
• Azure 容器实例。
• 部署到 Azure Stack 的 Kubernetes 群集。 有关详细信息，请参阅将 Kubernetes 部署到 Azure Stack。

下表显示了语言检测容器的最小资源规范和建议资源规范。 每个 CPU 核心必须至少为 2.6 千兆赫 (GHz) 或更快。 还列出了允许的每秒事务数 (TPS)。

CPU 核心和内存对应于 --cpus 和 --memory 设置，用作 docker run 命令的一部分。

使用 docker pull 获取容器映像

在 mcr.microsoft.com 容器注册表联合项中可以找到语言检测容器映像。 该映像驻留在 azure-cognitive-services/textanalytics/ 存储库中，名为 language。 完全限定的容器映像名称为 mcr.microsoft.com/azure-cognitive-services/textanalytics/language

要使用最新版本的容器，可以使用 latest 标记。 还可以在 MCR 上找到标记的完整列表。

使用 docker pull 命令从 Microsoft 容器注册表下载容器映像。

docker pull mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

通过 docker run 运行容器

一旦容器位于主机上，请使用 docker run 命令运行容器。 容器将继续运行，直到停止它。

若要运行语言检测容器，请执行以下 docker run 命令。 将下面的占位符替换为你自己的值：

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/textanalytics/language \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

此命令：

• 从容器映像运行语言检测容器
• 分配一个 CPU 核心和 4 GB 内存
• 公开 TCP 端口 5000，并为容器分配伪 TTY
• 退出后自动删除容器。 容器映像在主计算机上仍然可用。

在同一主机上运行多个容器

若要使用公开端口运行多个容器，请确保在运行每个容器时使用不同的公开端口。 例如，在端口 5000 上运行第一个容器，在端口 5001 上运行第二个容器。

可以让此容器和其他 Azure AI 服务容器一起在主机上运行。 此外，还可以让同一 Azure AI 服务容器的多个容器一起运行。

查询容器的预测终结点

容器提供了基于 REST 的查询预测终结点 API。

为容器 API 使用主机 http://localhost:5000。

验证容器是否正在运行

有几种方法可用于验证容器是否正在运行。 找到相关容器的外部 IP 地址和公开端口，并打开你常用的 Web 浏览器。 使用以下各种请求 URL 验证容器是否正在运行。 此处列出的示例请求 URL 是 http://localhost:5000，但是你的特定容器可能会有所不同。 请确保依赖容器的外部 IP 地址和公开端口。

停止容器

若要关闭容器，请在运行容器的命令行环境中选择 Ctrl+C。

故障排除

如果运行启用了输出装入点和日志记录的容器，该容器会生成有助于排查启动或运行容器时发生的问题的日志文件。

计费

语言检测容器使用 Azure 帐户中的语言资源向 Azure 发送账单信息。

对该容器的查询在用于 ApiKey 参数的 Azure 资源的定价层计费。

Azure AI 服务容器在未连接到计量或计费终结点的情况下无权运行。 必须始终让容器可以向计费终结点传送计费信息。 Azure AI 服务容器不会将客户数据（例如，正在分析的图像或文本）发送给 Azure。

连接到 Azure

容器需要计费参数值才能运行。 这些值使容器可以连接到计费终结点。 容器约每 10 到 15 分钟报告一次使用情况。 如果容器未在允许的时间范围内连接到 Azure，容器将继续运行，但不会为查询提供服务，直到计费终结点恢复。 尝试连接按 10 到 15 分钟的相同时间间隔进行 10 次。 如果无法在 10 次尝试内连接到计费终结点，容器会停止处理请求。

计费参数

当以下三个选项都提供了有效值时，docker run 命令会启动容器：

有关这些选项的详细信息，请参阅配置容器。

摘要

在本文中，你已学习了下载、安装和运行语言检测容器的相关概念和工作流。 综上所述：

• 语言检测提供适用于 Docker 的 Linux 容器
• 从 Microsoft 容器注册表 (MCR) 下载容器映像。
• 容器映像在 Docker 中运行。
• 必须在实例化容器时指定账单信息。

后续步骤

• 请参阅配置容器了解配置设置。