replicated/support-bundle

Replicated Support Bundle 镜像文档

概述

Replicated Support Bundle镜像是Replicated Troubleshoot工具的容器化分发版本，公开托管于https://hub.docker.com/r/replicated/support-bundle%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E4%BB%A5%E6%94%B6%E9%9B%86%E7%B3%BB%E7%BB%9F%E4%BF%A1%E6%81%AF%EF%BC%8C%E7%94%9F%E6%88%90%E7%94%A8%E4%BA%8E%E6%95%85%E9%9A%9C%E6%8E%92%E6%9F%A5%E7%9A%84%E6%94%AF%E6%8C%81%E5%8C%85%EF%BC%88support 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进行专业分析。

标签说明

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