安装并运行关键短语提取容器

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

通过容器，你可以在自己的环境中运行关键短语提取 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/ 存储库中，名为 keyphrase。 完全限定的容器映像名称为 mcr.microsoft.com/azure-cognitive-services/textanalytics/keyphrase。

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

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

docker pull mcr.microsoft.com/azure-cognitive-services/textanalytics/keyphrase: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/keyphrase \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

此命令：

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

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

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

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

查询容器的预测终结点

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

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

验证容器是否正在运行

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

停止容器

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

故障排除

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

计费

关键短语提取容器使用你的 Azure 帐户上的关键短语提取资源，将计费信息发送到 Azure。

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

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

连接到 Azure

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

计费参数

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

\

总结

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

• 关键短语提取提供适用于 Docker 的 Linux 容器。
• 从 Microsoft 容器注册表 (MCR) 下载容器映像。
• 容器映像在 Docker 中运行。
• 可以使用 REST API 或 SDK 通过指定容器的主机 URI 来调用关键短语提取容器中的操作。
• 必须在实例化容器时指定账单信息。

后续步骤

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