newrelic/newrelic-ruby-init

New Relic Ruby Agent Init Container

镜像概述和主要用途

本镜像包含New Relic https://github.com/newrelic/newrelic-ruby-agent%EF%BC%8C%E5%B9%B6%E4%BB%A5Kubernetes Init Container形式分发，用于配合New Relic https://github.com/newrelic/k8s-agents-operator/%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E9%80%94%E6%98%AF%E5%9C%A8Kubernetes%E9%9B%86%E7%BE%A4%E4%B8%AD%E4%B8%BARuby%E5%BA%94%E7%94%A8%E6%8F%90%E4%BE%9BNew Relic监控代理的初始化环境，确保应用部署时完成代理的必要配置与准备工作。

核心功能与特性

• Kubernetes初始化容器集成：作为Kubernetes Init Container，在应用容器启动前完成Ruby Agent的前置环境配置
• 版本精确控制：支持精细化的镜像标签策略，可根据需求选择特定版本的Ruby Agent
• 与K8s操作器兼容：无缝配合New Relic Kubernetes Agents Operator，简化在Kubernetes集群中的监控部署流程

使用场景和适用范围

适用范围

适用于Kubernetes集群中部署的Ruby应用，需集成New Relic APM（应用性能监控）进行性能数据采集与分析的场景。

使用场景

• 新部署Ruby应用时，通过Init Container预配置New Relic监控环境
• 现有Ruby应用迁移至Kubernetes集群，需集成New Relic监控的场景
• 需要严格控制Ruby Agent版本，确保不同环境（开发、测试、生产）监控配置一致性的场景

具体使用示例可参考Kubernetes Agents Operator的https://github.com/newrelic/k8s-agents-operator/#installation%E3%80%82

镜像标签约定

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

说明：标签9.11.0.0发布后将永久保留。若需重新构建Agent版本9.11.0的容器，将以9.11.0.1（递增初始化容器构建号）形式发布。

使用方法与配置说明

Kubernetes部署示例

在Kubernetes Pod配置中，通过initContainers字段引用本镜像，示例如下：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: ruby-app-with-newrelic
spec:
  initContainers:
  - name: newrelic-ruby-agent-init
    image: newrelic/ruby-agent-init-container:9.11.0  # 根据需求选择镜像标签
    # 挂载卷（根据实际需求配置，用于传递Agent配置文件或数据）
    volumeMounts:
    - name: newrelic-agent-volume
      mountPath: /newrelic
  containers:
  - name: ruby-app
    image: your-ruby-app-image:latest
    volumeMounts:
    - name: newrelic-agent-volume
      mountPath: /newrelic-agent
  volumes:
  - name: newrelic-agent-volume
    emptyDir: {}

配置说明

• 镜像标签选择：根据"镜像标签约定"选择合适的标签，确保Agent版本与应用兼容性
• 卷挂载：通常需挂载共享卷（如emptyDir），使Init Container准备的Agent文件可被后续应用容器访问
• 版本兼容性：需确保选择的Ruby Agent版本与应用使用的Ruby runtime版本兼容（参考Ruby Agent官方文档）

支持

New Relic运营并维护在线论坛，您可在此与New Relic员工及其他用户交流获取帮助、分享最佳实践。本项目相关的社区讨论话题可访问：
[***]

贡献

我们欢迎您为改进New Relic Kubernetes Agent Operator Init Container贡献代码！提交Pull Request时，需通过CLA-Assistant签署贡献者许可协议（CLA）。每个项目仅需签署一次CLA。

若有疑问，或需签署企业CLA（代表公司贡献时需提供），请发送邮件至***。

安全漏洞说明

如https://github.com/newrelic/newrelic-agent-init-container/security/policy%E6%89%80%E8%BF%B0%EF%BC%8CNew Relic致力于保护客户数据隐私与安全。我们鼓励安全研究人员通过漏洞赏金计划报告潜在安全问题。

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

许可证

New Relic Kubernetes Agent Operator Init Container采用Apache 2.0许可证。
本项目还使用了第三方库的源代码，相关库及其许可条款详见第三方通知文档。