教程:在 Azure 应用服务中为自定义容器配置挎斗容器(预览版)
在本教程中,你将 OpenTelemetry 收集器作为挎斗容器添加到 Azure 应用服务中的 Linux 自定义容器应用。
在 Azure 应用服务中,可以最多为每个启用挎斗的自定义容器应用添加 4 个挎斗容器。 挎斗容器让你可以将额外的服务和功能部署到容器应用程序,而无需将它们紧密耦合到主应用程序容器。 例如,可以将监视、日志记录、配置和网络服务添加为挎斗容器。 OpenTelemetry 收集器挎斗就是一个类似的监视例子。
注意
在预览期间,必须在创建应用时启用挎斗支持。 目前无法为现有应用启用挎斗支持。
如果没有 Azure 订阅,可在开始前创建一个试用帐户。
1.设置所需的资源
首先创建本教程使用的资源。 它们用于此特定方案,挎斗容器通常不需要它们。
在 Azure CLI 中,运行下列命令:
git clone https://github.com/Azure-Samples/app-service-sidecar-tutorial-prereqs cd app-service-sidecar-tutorial-prereqs azd provision
出现提示时,请提供所需的环境名称、订阅和区域。 例如:
- 环境名称:my-sidecar-env
- 订阅:你的订阅
- 地区:(亚洲)中国北部 2
部署完成后,应会看到以下输出:
APPLICATIONINSIGHTS_CONNECTION_STRING = InstrumentationKey=...;IngestionEndpoint=...;LiveEndpoint=... Open resource group in the portal: https://portal.azure.cn/#@/resource/subscriptions/.../resourceGroups/...
在浏览器选项卡中打开资源组链接。你稍后需要使用该连接字符串。
注意
azd provision
使用包含的模板创建以下 Azure 资源:- 资源组
- 部署了两个映像的容器注册表:
- 具有 OpenTelemetry 模块的 Nginx 映像。
- OpenTelemetry 收集器映像,配置为导出到 Azure Monitor。
- Log Analytics 工作区
- Application Insights 组件
2.创建启用挎斗的应用
在资源组的管理页中,选择“创建”。
搜索“Web 应用”,然后选择“创建”上的向下箭头并选择“Web 应用”。
配置“基本信息”面板,如下所示:
- “名称”:唯一名称
- 发布:容器
- 操作系统:Linux
- 区域:与你对
azd provision
所选区域相同 - Linux 计划:新的应用服务计划
选择“容器”。 配置“容器”面板,如下所示:
- 挎斗支持:启用
- 映像源:Azure 容器注册表
- 注册表:由
azd provision
创建的注册表 - 映像:nginx
- 标记:最新
- 端口:80
注意
这些设置在启用挎斗的应用中以不同的方式进行配置。 有关详细信息,请参阅启用挎斗的应用的差异。
依次选择“查看 + 创建”、“创建”。
部署完成后,请选择“转到资源”。
在新的浏览器选项卡中,导航到
https://<app-name>.chinacloudsites.cn
并查看默认的 Nginx 页面。
3.添加挎斗容器
在本部分中,你将一个挎斗容器添加到你的自定义容器应用。
在应用的管理页的左侧菜单中,选择“部署中心”。
部署中心会显示应用中的所有容器。 现在,它只有主容器。
选择“添加”并配置新容器,如下所示:
- 名称:otel-collector
- 映像源:Azure 容器注册表
- 注册表:由
azd provision
创建的注册表 - 映像:otel-collector
- 标记:最新
- 端口:4317
端口 4317 是示例容器用来接收 OpenTelemetry 数据的默认端口。 可在
localhost:4317
从应用中的任何其他容器访问它。 这正是 Nginx 容器将数据发送到挎斗的方式(请参阅示例 Nginx 映像的 OpenTelemetry 模块配置)。选择“应用”。
现在,你应在部署中心看到两个容器。 主容器标记为“Main”,挎斗容器标记为“Sidecar”。 每个应用必须有一个主容器,但可以有多个挎斗容器。
4.配置环境变量
在示例方案中,otel-collector 挎斗配置为将 OpenTelemetry 数据导出到 Azure Monitor,但它需要连接字符串作为环境变量(请参阅 otel-collector 映像的 OpenTelemetry 配置文件)。
通过配置应用设置来为容器(如任何应用服务应用)配置环境变量。 应用设置可供应用中的所有容器访问。
在应用的管理页的左侧菜单中,选择“配置”。
通过选择“新建应用程序设置”来添加应用设置,并按如下所示对其进行配置:
- 名称: APPLICATIONINSIGHTS_CONNECTION_STRING
- 值:
azd provision
的输出中的连接字符串
选择“保存”,然后选择“继续”。
注意
某些应用设置不适用于启用挎斗的应用。 有关详细信息,请参阅启用挎斗的应用的差异
5.在 Application Insights 中验证
otel-collector 挎斗现在应将数据导出到 Application Insights。
返回到
https://<app-name>.chinacloudsites.cn
的浏览器选项卡,多次刷新页面以生成一些 Web 请求。返回到资源组概览页,选择 Application Insights 资源。 你现在应该会在默认图表中看到一些数据。
注意
在此非常常见的监视方案中,Application Insights 只是你可以使用的 OpenTelemetry 目标之一,例如 Jaeger、Prometheus 和 Zipkin。
清理资源
当你不再需要该环境时,可以删除资源组、应用服务和所有相关资源。 在克隆的存储库中,只需在 CLI 中运行以下命令即可:
azd down
启用挎斗的应用的差异
配置启用挎斗的应用的方式与配置未启用挎斗的应用的方式不同。 具体而言,你不会使用应用设置来配置主容器和挎斗,而是直接在资源属性中配置。 这些应用设置不适用于启用挎斗的应用:
- 注册表身份验证设置:
DOCKER_REGISTRY_SERVER_URL
、DOCKER_REGISTRY_SERVER_USERNAME
、DOCKER_REGISTRY_SERVER_PASSWORD
。 - 容器端口:
WEBSITES_PORT