如何配置 APM 集成和 CA 证书

您所在的位置：网站首页 › azure查看额度使用状况 › 如何配置 APM 集成和 CA 证书

如何配置 APM 集成和 CA 证书

2023-06-11 13:51| 来源: 网络整理| 查看: 265

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

如何配置 APM 集成和 CA 证书项目 06/09/2023

注意

Azure Spring Apps 是 Azure Spring Cloud 服务的新名称。虽然该服务有新名称，但一些地方仍会使用旧名称，我们仍在更新屏幕截图、视频和图形等资产。

本文适用于：❌ 基本版/标准版 ✔️ 企业版

本文介绍如何在 Azure Spring Apps Enterprise 计划中配置应用程序性能监视器 (APM) 集成和证书颁发机构 (CA) 证书。

可以在 Azure Spring Apps Enterprise 计划实例上启用或禁用 Tanzu 生成服务。有关详细信息，请参阅使用 Tanzu生成服务的按需生成服务部分。

先决条件已预配的 Azure Spring Apps Enterprise 计划实例。有关详细信息，请参阅快速入门：使用企业计划生成应用并将其部署到 Azure Spring Apps。 Azure CLI 版本 2.45.0 或更高版本。使用以下命令安装 Azure Spring Apps 扩展：az extension add --name spring 支持的方案 - APM 和 CA 证书集成

Tanzu 生成服务默认在 Azure Spring Apps Enterprise 中启用。如果选择禁用生成服务，则可以部署应用程序，但只能使用自定义容器映像。本部分提供启用和禁用方案的指南。

已启用生成服务生成服务已禁用

Tanzu 生成服务使用 buildpack 绑定与 Tanzu Partner Buildpacks 和其他云原生生成包（例如 GitHub 上的 ca-certificates buildpack）集成。

目前，Azure Spring Apps 支持以下 APM 类型和 CA 证书：

ApplicationInsights Dynatrace AppDynamics New Relic ElasticAPM

Azure Spring Apps 支持所有语言系列生成包的 CA 证书，但并非所有受支持的 APM。下表显示了 Tanzu 语言系列 buildpack 支持的绑定类型。

Buildpack ApplicationInsights New Relic AppDynamics Dynatrace ElasticAPM Java ✔ ✔ ✔ ✔ ✔ Dotnet ✔ Go ✔ Python NodeJS ✔ ✔ ✔ ✔ Web 服务器 ✔

有关使用 Web 服务器的信息，请参阅部署 Web 静态文件。

启用生成服务时，APM 和 CA 证书与生成器集成，如在 Azure Spring Apps 中管理 APM 集成和 CA 证书部分所述。

当生成服务使用 Azure Spring Apps 托管容器注册表时，可以将应用程序生成到映像，然后将其部署，但只能在当前 Azure Spring Apps 服务实例中部署。

使用以下命令将 APM 和 CA 证书集成到部署中：

az spring app deploy \ --resource-group \ --service \ --name \ --builder \ --artifact-path

如果提供自己的容器注册表以用于生成服务，则可以将应用程序生成到容器映像中，并将该映像部署到当前或其他 Azure Spring Apps 企业服务实例。

提供自己的容器注册表可将生成与部署分开。可以使用 build 命令通过生成器创建或更新生成，然后使用 deploy 命令将容器映像部署到服务。在此方案中，需要在部署时指定 APM 所需的环境变量。

使用以下命令生成映像：

az spring build-service build \ --resource-group \ --service \ --name \ --builder \ --artifact-path

使用以下命令通过容器映像进行部署，并使用 --env 参数配置运行时环境：

az spring app deploy \ --resource-group \ --service \ --name \ --container-image \ --container-registry \ --registry-password \ --registry-username \ --env NEW_RELIC_APP_NAME= \ NEW_RELIC_LICENSE_KEY= 启用了生成服务的受支持 APM 资源

本部分列出了可用于集成的 APM 支持的语言和所需环境变量。

Application Insights

支持的语言：

Java

buildpack 绑定所需的环境变量：

connection-string

使用自定义映像部署应用所需的环境变量：

APPLICATIONINSIGHTS_CONNECTION_STRING

注意

允许使用大写键，可以将下划线 (_) 替换为连字符 (-) 。

有关其他受支持的环境变量，请参阅 Application Insights 概述。

DynaTrace

支持的语言：

Java .NET Go Node.js WebServers

buildpack 绑定所需的环境变量：

api-url 或在 environment-id 生成步骤) 中使用的 ( api-token 生成步骤) 中使用的 ( TENANT TENANTTOKEN CONNECTION_POINT

使用自定义映像部署应用所需的环境变量：

DT_TENANT DT_TENANTTOKEN DT_CONNECTION_POINT

有关其他受支持的环境变量，请参阅 Dynatrace

New Relic

支持的语言：

Java Node.js

buildpack 绑定所需的环境变量：

license_key app_name

使用自定义映像部署应用所需的环境变量：

NEW_RELIC_LICENSE_KEY NEW_RELIC_APP_NAME

有关其他受支持的环境变量，请参阅 New Relic

Elastic

支持的语言：

Java Node.js

buildpack 绑定所需的环境变量：

service_name application_packages server_url

使用自定义映像部署应用所需的环境变量：

ELASTIC_APM_SERVICE_NAME ELASTIC_APM_APPLICATION_PACKAGES ELASTIC_APM_SERVER_URL

有关其他受支持的环境变量，请参阅 Elastic

AppDynamics

支持的语言：

Java Node.js

buildpack 绑定所需的环境变量：

agent_application_name agent_tier_name agent_node_name agent_account_name agent_account_access_key controller_host_name controller_ssl_enabled controller_port

使用自定义映像部署应用所需的环境变量：

APPDYNAMICS_AGENT_APPLICATION_NAME APPDYNAMICS_AGENT_TIER_NAME APPDYNAMICS_AGENT_NODE_NAME APPDYNAMICS_AGENT_ACCOUNT_NAME APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY APPDYNAMICS_CONTROLLER_HOST_NAME APPDYNAMICS_CONTROLLER_SSL_ENABLED APPDYNAMICS_CONTROLLER_PORT

有关其他受支持的环境变量，请参阅 AppDynamics

使用 CA 证书

CA 证书使用 ca 证书生成包来支持在生成和运行时向系统信任存储提供 CA 证书。

在 Azure Spring Apps 企业计划中，CA 证书使用Azure 门户的 TLS/SSL 设置页上的“公钥证书”选项卡，如以下屏幕截图所示：

可以在 “编辑绑定 ”页上配置 CA 证书。证书 succeeded 显示在 CA 证书列表中。

如果禁用生成服务，则只能使用容器映像部署应用程序。有关详细信息，请参阅使用自定义容器映像部署应用程序。

可以使用 Azure Spring Apps Enterprise 的多个实例，其中一些实例生成和部署映像，而其他实例仅部署映像。假设出现了下面这种情景：

例如，使用用户容器注册表启用生成服务。然后，使用 APM 或 CA 证书从项目文件或源代码生成到容器映像中，并部署到当前的 Azure Spring Apps 实例或其他服务实例。有关详细信息，请参阅如何在 Azure Spring Apps Enterprise 中部署多语言应用部分的生成和部署多语言应用程序。

在另一个禁用生成服务的情况下，使用注册表中的容器映像部署应用程序，并使用 APM 和 CA 证书。

由于部署仅支持自定义容器映像，因此必须使用 --env 参数来配置用于部署的运行时环境。以下命令提供了一个示例：

az spring app deploy \ --resource-group \ --service \ --name \ --container-image \ --container-registry \ --registry-password \ --registry-username \ --env NEW_RELIC_APP_NAME= NEW_RELIC_LICENSE_KEY= 在禁用生成服务的情况下支持的 APM 资源

本部分列出了可用于集成的 APM 支持的语言和所需环境变量。

Application Insights

支持的语言：

Java

所需的运行时环境变量：

APPLICATIONINSIGHTS_CONNECTION_STRING

有关其他支持的环境变量，请参阅 Application Insights 概述

Dynatrace

支持的语言：

Java .NET Go Node.js WebServers

所需的运行时环境变量：

DT_TENANT DT_TENANTTOKEN DT_CONNECTION_POINT

有关其他受支持的环境变量，请参阅 Dynatrace

New Relic

支持的语言：

Java Node.js

所需的运行时环境变量：

NEW_RELIC_LICENSE_KEY NEW_RELIC_APP_NAME

有关其他受支持的环境变量，请参阅 New Relic

ElasticAPM

支持的语言：

Java Node.js

所需的运行时环境变量：

ELASTIC_APM_SERVICE_NAME ELASTIC_APM_APPLICATION_PACKAGES ELASTIC_APM_SERVER_URL

有关其他受支持的环境变量，请参阅 Elastic

AppDynamics

支持的语言：

Java Node.js

所需的运行时环境变量：

有关其他受支持的环境变量，请参阅 AppDynamics

在 Azure Spring Apps 中管理 APM 集成和 CA 证书

本部分仅适用于启用了生成服务的 Azure Spring Apps Enterprise 服务实例。启用生成服务后，一个 buildpack 绑定表示针对一个 APM 类型的凭据配置或针对 CA 证书类型的 CA 证书配置。对于 APM 集成，请按照前面的说明为 APM 配置必要的环境变量或机密。

注意

为 APM 绑定配置环境变量时，请使用不带前缀的键名称。例如，不要对 Dynatrace 绑定或 APPLICATIONINSIGHTS_ Application Insights 使用DT_前缀。 Tanzu APM 生成包会将键名称转换为带有前缀的原始环境变量名称。

可以通过 Azure 门户或 Azure CLI 管理 buildpack 绑定。

Azure 门户 Azure CLI

使用以下步骤查看 buildpack 绑定：

在Azure 门户，转到 Azure Spring Apps Enterprise 服务实例。

在导航窗格中，选择“ 生成服务”。

选择“绑定”列下的“编辑”，查看为生成器配置的绑定。

在 “编辑默认生成器的绑定” 页上查看绑定。

创建生成包绑定

若要创建 buildpack 绑定，请在“编辑绑定”页上选择“取消绑定”，指定绑定属性，然后选择“保存”。

取消绑定 buildpack 绑定

可以使用“取消绑定 ”命令或编辑绑定属性来取消绑定 buildpack 绑定。

要使用“取消绑定绑定”命令，请选择“已绑定”超链接，然后选择“取消绑定绑定”。

要通过编辑绑定属性来取消绑定生成包绑定，请选择“编辑绑定”，然后选择“取消绑定”。

当取消绑定某个绑定时，绑定状态会从“已绑定”变为“未绑定”。

使用 Azure CLI 查看 buildpack 绑定

使用以下命令查看当前的 buildpack 绑定：

az spring build-service builder buildpack-binding list \ --resource-group \ --service \ --builder-name 创建绑定

使用此命令可将绑定从“未绑定”更改为“已绑定”状态：

az spring build-service builder buildpack-binding create \ --resource-group \ --service \ --name \ --builder-name \ --type \ --properties a=b c=d \ --secrets e=f g=h

有关 buildpack 的 properties 和 secrets 参数的信息，请参阅支持的方案 - APM 和 CA 证书集成部分。

显示特定绑定的详细信息

可以使用以下命令查看特定绑定的详细信息：

az spring build-service builder buildpack-binding show \ --resource-group \ --service \ --name \ --builder-name 编辑绑定的属性

可以使用以下命令更改绑定的属性：

az spring build-service builder buildpack-binding set \ --resource-group \ --service \ --name \ --builder-name \ --type \ --properties a=b c=d \ --secrets e=f2 g=h

有关 buildpack 的 properties 和 secrets 参数的详细信息，请参阅支持的方案 - APM 和 CA 证书集成部分。

删除绑定

使用以下命令将绑定状态从“已绑定”更改为“未绑定”。

az spring build-service builder buildpack-binding delete \ --resource-group \ --service \ --name \ --builder-name 后续步骤如何在 Azure Spring Apps Enterprise 中部署多语言应用

【本文地址】

公司简介

联系我们

今日新闻

推荐新闻

专题文章