overops/agent-sidecar

OverOps Agent

镜像概述和主要用途

OverOps Agent实时分析应用程序，在QA、Staging和Production环境中提供代码级洞察。它专注于监控应用本身而非日志，帮助用户深入了解应用运行状态。更多信息请访问overops.com。

支持的标签及对应Dockerfile链接

• https://github.com/takipi-field/kubernetes/blob/master/agent/sidecar/Dockerfile
• https://github.com/takipi-field/kubernetes/blob/master/agent/sidecar/alpine.dockerfile
• https://github.com/takipi-field/kubernetes/blob/master/agent/sidecar/debug.dockerfile

Agent Sidecar

该镜像旨在用作Kubernetes Sidecar。将此镜像作为Init Container添加到Pod中，与需要监控的容器一起部署。在容器中挂载/takipi共享卷。当Pod启动时，Agent将从Sidecar复制到共享文件夹中。

⚠️ 使用前须知：必须先在环境中部署https://hub.docker.com/r/overops/collector%E3%80%82

使用方法

1. 按照https://github.com/takipi-field/kubernetes/blob/master/agent/sidecar/sidecar.yaml%EF%BC%8C%E5%B0%86Sidecar%E6%B7%BB%E5%8A%A0%E4%B8%BAInit Container。

   yaml
   apiVersion: v1
   kind: Pod
   metadata:
     name: example-sidecar-pod
   spec:
     volumes:
     - name: overops-agent
       emptyDir: {}
     initContainers:
       - name: overops-agent
         securityContext:
           runAsUser: 1000
           runAsGroup: 1000
           fsGroup: 1000 
         image: overops/agent-sidecar:latest
         imagePullPolicy: Always
         volumeMounts:
         - name: overops-agent
           mountPath: /takipi
     containers:
         #
         # 在此处添加您的容器
         #
         env:
         - name: TAKIPI_COLLECTOR_HOST
          # 示例 - 设置为您的Collector主机名
           value: "overops-collector-service"
         - name: TAKIPI_COLLECTOR_PORT
           value: "6060"
         - name: JAVA_TOOL_OPTIONS
           # 示例 - 为您的应用更新application.name和deployment.name
           value: "-agentpath:/takipi/lib/libTakipiAgent.so=takipi.application.name=<您的应用名称>,takipi.deployment.name=<您的应用版本>"
         volumeMounts:
         - name: overops-agent
           mountPath: /takipi
   

2. 更新环境变量：

   1. 将TAKIPI_COLLECTOR_HOST设置为您的Collector主机名。
   2. 将JAVA_TOOL_OPTIONS设置为-agentpath:/takipi/lib/libTakipiAgent.so。
   3. （可选）您还可以在JAVA_TOOL_OPTIONS中设置应用名称和部署名称，格式如下：-agentpath:/takipi/lib/libTakipiAgent.so=takipi.application.name=<您的应用名称>,takipi.deployment.name=<您的应用版本>。

3. 在浏览器中访问[***]

⚠️ 提示：此容器在将Agent复制到/takipi目录后会停止运行。它仅用于Kubernetes中的Init Container Sidecar。

关于安全上下文的说明

从4.56.0版本开始，所有发布到Docker Hub的镜像均为“rootless”。镜像现在使用基础镜像openjdk:8-jre-slim，并以用户ID 1000和组ID 1000运行，而非root用户。这一点已反映在Kubernetes部署的安全上下文中。

对于agent-sidecar，请确保为init容器应用正确的安全上下文，以避免权限问题。注意，应用Pod可以以不同用户运行，因为卷挂载的权限允许此操作。