newrelic/newrelic-dotnet-init

New Relic .NET Agent 初始化容器

!https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Project.png

镜像概述和主要用途

本镜像包含 New Relic https://github.com/newrelic/newrelic-dotnet-agent%EF%BC%8C%E5%B9%B6%E4%BB%A5 Kubernetes 初始化容器 形式分发，用于配合 New Relic https://github.com/newrelic/k8s-agents-operator/ 使用。有关示例用例，请参见 https://github.com/newrelic/k8s-agents-operator/#installation 部分。

核心功能和特性

• 初始化容器分发：将 New Relic .NET Agent 打包为 Kubernetes 初始化容器，支持在应用容器启动前完成 Agent 的部署与配置。
• 版本兼容：遵循严格的镜像标签约定，确保与 .NET Agent 版本精确匹配。
• Operator 集成：专为 New Relic Kubernetes Agents Operator 设计，简化在 Kubernetes 环境中集成 .NET Agent 的流程。

使用场景和适用范围

适用于在 Kubernetes 环境中运行的 .NET 应用，需集成 New Relic 监控的场景。通过初始化容器机制，可在应用容器启动前完成 .NET Agent 的部署、配置文件生成及环境变量注入，确保应用启动时即可接入 New Relic 监控系统。

镜像标签约定

New Relic .NET Agent 版本遵循 语义化版本（如 1.2.3）或包含额外构建号（如 1.2.3.99）。下表展示不同镜像标签对应的 .NET Agent 版本：

注：标签 10.25.1.0 发布后不会被替换。若需重新构建 Agent 版本 v10.25.1 的容器，将使用新标签 10.25.1.1（递增初始化容器构建号）。

使用方法和配置说明

前置条件

• 已部署 https://github.com/newrelic/k8s-agents-operator/%E3%80%82
• Kubernetes 集群版本 ≥ 1.19。

部署示例（Kubernetes Pod 配置）

以下为使用该初始化容器的 Kubernetes Pod 配置示例，通过挂载卷将 Agent 文件共享至应用容器：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: dotnet-app-with-newrelic
spec:
  initContainers:
  - name: newrelic-dotnet-agent
    image: newrelic/dotnet-agent-init-container:latest  # 使用指定标签（如10.25.1）以固定版本
    volumeMounts:
    - name: agent-volume
      mountPath: /newrelic-agent  # 初始化容器将Agent文件写入此路径
  containers:
  - name: dotnet-app
    image: your-dotnet-app-image:latest  # 你的.NET应用镜像
    volumeMounts:
    - name: agent-volume
      mountPath: /opt/newrelic  # 应用容器从该路径加载Agent
    env:
    - name: CORECLR_ENABLE_PROFILING
      value: "1"  # 启用CLR分析器
    - name: CORECLR_PROFILER
      value: "{36032161-FFC0-4B61-B559-F6C5D41BAE5A}"  # New Relic Profiler GUID
    - name: CORECLR_PROFILER_PATH
      value: /opt/newrelic/libNewRelicProfiler.so  # Profiler库路径（需与挂载路径一致）
    - name: NEW_RELIC_LICENSE_KEY
      valueFrom:
        secretKeyRef:
          name: newrelic-credentials
          key: license-key  # 从Secret获取New Relic许可证密钥
  volumes:
  - name: agent-volume
    emptyDir: {}  # 临时卷用于共享Agent文件

关键配置说明

• 卷挂载：初始化容器通过 agent-volume 将 Agent 文件写入 /newrelic-agent，应用容器从 /opt/newrelic 读取，需确保路径一致。
• 环境变量：应用容器需配置 New Relic 必要环境变量（如许可证密钥、Profiler路径等），具体可参考 .NET Agent 配置文档。
• 版本固定：生产环境建议使用具体标签（如 10.25.1）而非 latest，避免版本变更风险。

支持

New Relic 提供在线论坛，可与 New Relic 员工及其他用户交流获取帮助和最佳实践。该项目相关的社区主题位于：
[***]

贡献

欢迎贡献以改进 New Relic Kubernetes Agent Operator 初始化容器！提交 Pull Request 时，需通过 CLA-Assistant 签署贡献者许可协议（CLA）。个人贡献者仅需签署一次，企业贡献者需联系 opensource@newrelic.com 签署企业 CLA。

安全漏洞报告

如发现安全漏洞，可通过 New Relic 漏洞赏金计划 报告。详细安全政策见 https://github.com/newrelic/newrelic-agent-init-container/security/policy%E3%80%82

贡献指南详见 https://github.com/newrelic/newrelic-agent-init-container/blob/main/CONTRIBUTING.md%E3%80%82

许可

New Relic Kubernetes Agent Operator 初始化容器基于 Apache 2.0 许可证 开源。第三方库的使用及许可信息详见第三方声明文档。