ttksm/geminabox

Gem in a Box Docker镜像

概述

https://github.com/geminabox/geminabox 允许您托管自己的gems，并像使用rubygems.org一样向其推送新gems。本Docker镜像基于官方https://hub.docker.com/_/ruby%E8%BF%90%E8%A1%8CGeminabox%E3%80%82

服务器

• v1.4及以上版本：使用Puma
• v1.2及以下版本：使用WEBrick

核心功能和特性

• 托管私有RubyGems仓库，支持gem的推送、安装和删除
• 提供基本认证功能，保护gem的上传和删除操作
• 支持数据持久化，通过挂载卷保存gems数据
• 基于官方Ruby镜像构建，确保运行环境稳定

使用场景和适用范围

适用于需要私有RubyGems仓库的团队或个人，用于管理内部开发的Ruby gems，确保依赖包的安全性和版本可控性，避免依赖公共仓库的不稳定性。

使用方法

快速启动

将本地端口映射到容器的9292端口（Geminabox监听端口）。若要将本地8080端口映射到容器，执行以下命令：

bash
docker run -d -p 8080:9292 ttksm/geminabox:latest

命令执行后，可通过 http://localhost:8080 访问Geminabox界面。

在需要将Geminabox作为gem源的计算机上，执行以下命令添加源：

bash
gem sources -a http://localhost:8080/

之后，可通过Geminabox界面上传或删除gems，或通过命令行安装gems：

bash
gem install GEM

配置选项

基本认证

通过配置两个环境变量启用基本认证（默认未启用）。启用后，上传或删除gems时需要认证。

• BASIC_USER：基本认证的用户名
• BASIC_PASS：基本认证的密码

启用基本认证的Docker运行命令：

bash
docker run -d -p 8080:9292 -e BASIC_USER=username -e BASIC_PASS=password ttksm/geminabox:latest

通过命令行安装gems时，需添加认证信息到源地址：

bash
gem sources -a http://username:password@localhost:8080/

高级配置

Gems数据持久化

Gems存储在容器内的/var/geminabox-data目录。通过挂载主机目录或Docker卷到该路径，可实现gems数据持久化。

例如，挂载当前目录：

bash
docker run -d -p 8080:9292 --mount type=bind,src=$PWD,dst=/var/geminabox-data ttksm/geminabox:latest

Docker Compose配置

以下示例启用基本认证并挂载Docker卷以持久化gems数据：

yaml
version: '3.7'

services:
  geminabox:
    image: ttksm/geminabox:latest
    container_name: geminabox
    environment:
      - BASIC_USER=username
      - BASIC_PASS=password
    ports:
      - "8080:9292"
    restart: always
    volumes:
      - type: volume
        source: geminabox-data
        target: /var/geminabox-data

volumes:
  geminabox-data: