教程：在 Azure 应用服务中为自定义容器配置挎斗容器（预览版）

在本教程中，你将 OpenTelemetry 收集器作为挎斗容器添加到 Azure 应用服务中的 Linux 自定义容器应用。

在 Azure 应用服务中，可以最多为每个启用挎斗的自定义容器应用添加 4 个挎斗容器。 挎斗容器让你可以将额外的服务和功能部署到容器应用程序，而无需将它们紧密耦合到主应用程序容器。 例如，可以将监视、日志记录、配置和网络服务添加为挎斗容器。 OpenTelemetry 收集器挎斗就是一个类似的监视例子。

如果没有 Azure 订阅，可在开始前创建一个试用帐户。

1.设置所需的资源

首先创建本教程使用的资源。 它们用于此特定方案，挎斗容器通常不需要它们。

1. 在 Azure CLI 中，运行下列命令：

   git clone https://github.com/Azure-Samples/app-service-sidecar-tutorial-prereqs
   cd app-service-sidecar-tutorial-prereqs
   azd provision
   

2. 出现提示时，请提供所需的环境名称、订阅和区域。 例如：

   • 环境名称：my-sidecar-env
   • 订阅：你的订阅
   • 地区：（亚洲）中国北部 2

   部署完成后，应会看到以下输出：

    APPLICATIONINSIGHTS_CONNECTION_STRING = InstrumentationKey=...;IngestionEndpoint=...;LiveEndpoint=...
   
    Open resource group in the portal: https://portal.azure.cn/#@/resource/subscriptions/.../resourceGroups/...
    

3. 在浏览器选项卡中打开资源组链接。你稍后需要使用该连接字符串。

   注意

   azd provision 使用包含的模板创建以下 Azure 资源：

   • 资源组
   • 部署了两个映像的容器注册表：
     • 具有 OpenTelemetry 模块的 Nginx 映像。
     • OpenTelemetry 收集器映像，配置为导出到 Azure Monitor。
   • Log Analytics 工作区
   • Application Insights 组件

2.创建启用挎斗的应用

1. 在资源组的管理页中，选择“创建”。

2. 搜索“Web 应用”，然后选择“创建”上的向下箭头并选择“Web 应用”。

   

3. 配置“基本信息”面板，如下所示：

   • “名称”：唯一名称
   • 发布：容器
   • 操作系统：Linux
   • 区域：与你对 azd provision 所选区域相同
   • Linux 计划：新的应用服务计划

   

4. 选择“容器”。 配置“容器”面板，如下所示：

   • 挎斗支持：启用
   • 映像源：Azure 容器注册表
   • 注册表：由 azd provision 创建的注册表
   • 映像：nginx
   • 标记：最新
   • 端口：80

   

   注意

   这些设置在启用挎斗的应用中以不同的方式进行配置。 有关详细信息，请参阅启用挎斗的应用的差异。

5. 依次选择“查看 + 创建”、“创建”。

6. 部署完成后，请选择“转到资源”。

7. 在新的浏览器选项卡中，导航到 https://<app-name>.chinacloudsites.cn 并查看默认的 Nginx 页面。

3.添加挎斗容器

在本部分中，你将一个挎斗容器添加到你的自定义容器应用。

1. 在应用的管理页的左侧菜单中，选择“部署中心”。

   部署中心会显示应用中的所有容器。 现在，它只有主容器。

2. 选择“添加”并配置新容器，如下所示：

   • 名称：otel-collector
   • 映像源：Azure 容器注册表
   • 注册表：由 azd provision 创建的注册表
   • 映像：otel-collector
   • 标记：最新
   • 端口：4317

   端口 4317 是示例容器用来接收 OpenTelemetry 数据的默认端口。 可在 localhost:4317 从应用中的任何其他容器访问它。 这正是 Nginx 容器将数据发送到挎斗的方式（请参阅示例 Nginx 映像的 OpenTelemetry 模块配置）。

3. 选择“应用”。

   

   现在，你应在部署中心看到两个容器。 主容器标记为“Main”，挎斗容器标记为“Sidecar”。 每个应用必须有一个主容器，但可以有多个挎斗容器。

4.配置环境变量

在示例方案中，otel-collector 挎斗配置为将 OpenTelemetry 数据导出到 Azure Monitor，但它需要连接字符串作为环境变量（请参阅 otel-collector 映像的 OpenTelemetry 配置文件）。

通过配置应用设置来为容器（如任何应用服务应用）配置环境变量。 应用设置可供应用中的所有容器访问。

1. 在应用的管理页的左侧菜单中，选择“配置”。

2. 通过选择“新建应用程序设置”来添加应用设置，并按如下所示对其进行配置：

   • 名称: APPLICATIONINSIGHTS_CONNECTION_STRING
   • 值：azd provision 的输出中的连接字符串

3. 选择“保存”，然后选择“继续”。

   

5.在 Application Insights 中验证

otel-collector 挎斗现在应将数据导出到 Application Insights。

1. 返回到 https://<app-name>.chinacloudsites.cn 的浏览器选项卡，多次刷新页面以生成一些 Web 请求。

2. 返回到资源组概览页，选择 Application Insights 资源。 你现在应该会在默认图表中看到一些数据。

   

清理资源

当你不再需要该环境时，可以删除资源组、应用服务和所有相关资源。 在克隆的存储库中，只需在 CLI 中运行以下命令即可：

azd down

启用挎斗的应用的差异

配置启用挎斗的应用的方式与配置未启用挎斗的应用的方式不同。 具体而言，你不会使用应用设置来配置主容器和挎斗，而是直接在资源属性中配置。 这些应用设置不适用于启用挎斗的应用：

• 注册表身份验证设置：DOCKER_REGISTRY_SERVER_URL、DOCKER_REGISTRY_SERVER_USERNAME、DOCKER_REGISTRY_SERVER_PASSWORD。
• 容器端口：WEBSITES_PORT

更多资源

• 配置自定义容器
• 使用 GitHub Actions 部署自定义容器
• OpenTelemetry