Replicated Support Bundle 镜像文档

概述

Replicated Support Bundle镜像是Replicated Troubleshoot工具的容器化分发版本，公开托管于hub.docker.com/r/replicated/support-bundle。该镜像提供便捷的方式运行容器以收集系统信息，生成用于故障排查的支持包（support bundle），帮助用户快速诊断和解决系统问题。

核心功能与特性

• 收集器配置：支持通过YAML文件定义自定义收集器，指定需收集的系统信息；未指定时自动应用完整默认收集器集
• 环境适应性：可传递HTTP_PROXY、HTTPS_PROXY、NO_PROXY环境变量，适配代理网络环境
• 系统级访问：通过挂载Docker套接字（/var/run/docker.sock）及使用主机网络/PID模式（--net host --pid host），确保全面收集系统与容器信息
• 输出管理：生成的支持包自动保存为supportbundle.tar.gz文件，存储于挂载的本地目录
• 版本控制：提供多版本标签（latest/alpha/MAJOR等），满足不同稳定性需求，其中MAJOR.MINOR.PATCH标签为唯一不可变版本

使用场景

适用于系统故障排查场景，当需要收集详细诊断信息（如容器状态、日志、配置文件等）时，通过该镜像快速生成标准化支持包，上传至vendor.replicated.com获取专业分析支持。

使用方法

基本运行命令

通过以下命令运行容器，生成默认配置的支持包：

shell
docker run -it --rm \
    --volume $PWD:/out \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --net host --pid host \
    -e HTTP_PROXY -e HTTPS_PROXY -e NO_PROXY \
    replicated/support-bundle generate

参数说明

• --volume $PWD:/out：将当前工作目录挂载至容器内/out目录，用于输出生成的支持包文件
• --volume /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程套接字，使工具能访问Docker引擎信息
• --net host --pid host：使用主机网络命名空间和PID命名空间，确保收集完整的网络连接与进程信息
• -e HTTP_PROXY -e HTTPS_PROXY -e NO_PROXY：传递主机环境的代理变量，保障工具在代理网络中正常运行
• generate：执行支持包生成命令

生成结果

命令执行完成后，当前工作目录将生成supportbundle.tar.gz文件。该文件包含收集的系统诊断信息，可上传至vendor.replicated.com进行专业分析。

标签说明

镜像发布多个标签以区分版本，具体说明如下：