tianon/gosu

gosu 预构建镜像文档

镜像概述

本镜像为包含tianon/gosu官方发布二进制文件的预构建镜像，主要用于在Dockerfile中通过COPY --from=指令便捷地引用和集成gosu工具，避免手动下载、验证及安装步骤，简化Docker镜像构建流程。

核心功能与特性

• 官方二进制集成：包含来自https://github.com/tianon/gosu%E7%9A%84%E5%AE%98%E6%96%B9%E5%8F%91%E5%B8%83%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%B7%A5%E5%85%B7%E7%9A%84%E5%AE%8C%E6%95%B4%E6%80%A7%E5%92%8C%E5%8F%AF%E9%9D%A0%E6%80%A7%E3%80%82
• 便捷引用方式：支持通过Docker的COPY --from=指令直接从本镜像复制gosu二进制文件到目标镜像，无需额外配置。

使用场景

• Dockerfile构建集成：在构建其他Docker镜像时，需要使用gosu工具（用于以非root用户执行命令，解决Docker中用户权限问题）时，可通过本镜像快速集成。
• 简化依赖管理：替代手动下载、解压、验证gosu二进制文件的过程，减少Dockerfile中的构建步骤和潜在错误。

使用方法

基本使用（Dockerfile中引用）

在目标Dockerfile中，通过COPY --from=指令从本镜像复制gosu二进制文件至所需路径，示例如下：

dockerfile
# 从gosu镜像复制二进制文件到目标镜像的/usr/local/bin目录
COPY --from=gosu /usr/local/bin/gosu /usr/local/bin/

# 可选：为gosu设置执行权限（部分基础镜像可能默认无执行权限）
RUN chmod +x /usr/local/bin/gosu

验证集成结果

构建目标镜像后，可通过以下命令验证gosu是否成功集成：

bash
docker run --rm [目标镜像名称] gosu --version

若输出gosu版本信息，则表示集成成功。

镜像源与构建脚本

本镜像的源代码及构建脚本详见：https://github.com/tianon/gosu/tree/HEAD/hub