koehn/diaspora

diaspora-docker 镜像文档

镜像概述和主要用途

diaspora-docker 项目允许在Docker容器集合中快速、轻松地设置Diaspora节点（pod）。它使用户能够以最少的系统管理操作和对Unix、数据库、Web服务器等知识的需求运行Diaspora。

核心功能和特性

• 遵循官方指南：镜像构建过程遵循 Diaspora 官方Wiki的Debian安装指南，确保兼容性和可靠性。
• 完整依赖集成：包含Diaspora代码、RVM、Postgres驱动、系统依赖包、Ruby Gems等所有必要组件。
• 安全运行环境：在镜像中创建并使用diaspora用户运行代码，遵循最小权限原则。
• 简化外部依赖：仅需用户提供数据库和Redis服务器（可通过项目提供的compose目录快速配置）。

使用场景和适用范围

适用于希望部署Diaspora社交网络节点，但不想处理复杂系统配置、数据库管理或Web服务器设置的用户，尤其适合系统管理知识有限的个人或小型组织。

使用方法和配置说明

前提条件

• 安装Docker
• （可选）安装Docker Compose

基本使用步骤

1. 拉取镜像
   拉取基于最新Diaspora源代码预构建的镜像：

   bash
   docker pull koehn/diaspora:latest
   

2. 设置依赖服务
   需要配置数据库、Redis等服务。项目的compose目录提供了简化配置的文件，推荐使用。

3. 配置Diaspora
   配置Diaspora以连接上述数据库和Redis服务。同样，compose目录中的docker-compose配置文件已包含完整配置，可直接使用。

升级

当Diaspora发布新版本时，官方会在https://hub.docker.com/r/koehn/diaspora/%E5%8F%91%E5%B8%83%E6%96%B0%E9%95%9C%E5%83%8F%E3%80%82%E5%8D%87%E7%BA%A7%E6%AD%A5%E9%AA%A4%EF%BC%9A

1. 拉取最新镜像：

   bash
   docker pull koehn/diaspora
   

2. 重启应用：下次启动时将自动使用最新构建版本，并应用最新数据库迁移。

制作和推送自定义镜像

项目包含的build脚本（适用于*nix系统）可用于构建和推送自定义镜像。脚本支持以下参数：

• --git-url url：指定拉取Diaspora代码的仓库URL。
• --diaspora-version version：设置拉取代码的Git标签，并作为镜像标签。
• --ruby-version version：设置RVM安装的Ruby版本（详见下文RUBY_VERSION）。
• --gem-version version：设置安装的Gem版本（详见下文GEM_VERSION）。
• --image-name：指定推送的镜像名称，默认为koehn/diaspora。
• --scanner-token：详见下文SCANNER_TOKEN。

自定义镜像

Dockerfile支持通过构建参数自定义镜像，参数说明如下：

构建示例

使用自定义参数构建镜像：

bash
docker build --build-arg GIT_BRANCH=develop --build-arg RUBY_VERSION=2.5 .

官方镜像制作流程

当Diaspora发布新版本时，官方通过以下流程构建镜像：

1. 使用--diaspora-version参数指定新版本号构建镜像。
2. 不指定版本参数构建master分支代码，标记为latest。
   通过这两步生成对应版本和latest标签的官方镜像。