目的

privateなgemサーバーを構築したい。
geminaboxやgemirroがよく使われているらしい。

ここではgeminaboxを使う。

構築環境

CentOS 7.2（vagrant bento）
geminabox
puma
nginx（yum package）

設置手順

rubyが設置されてない場合はyumやrbenvで設置する。この説明は割愛する。

bundlerの設置

gem install bundler

アプリケーションのディレクトリを生成する。

mkdir gembox
cd gembox
bundle init

アプリケーションサーバーとしてpumaを使う。
bundle initで生成されたGemfileを下記のように編集する。

# frozen_string_literal: true
source "https://rubygems.org"

# gem "rails"
gem "geminabox"
gem "puma"

別にglobalのruby環境やsystemのruby環境で設置しても構わない。
共通的なものだけglobalのruby環境に設置するのが自己ルールであるだけだ。

bundle install --path vendor/bundle

config.ruを生成する。

require "rubygems"
require "geminabox"

Geminabox.data = "./data" # ... or wherever
run Geminabox::Server

data、config、tmpディレクトリを生成する。
dataはgemファイルの保管箱である。
unixソケットを使うので、socketsディレクトリも作ろう。

mkdir data
mkdir config
mkdir -p tmp/pids
mkdir tmp/sockets

puma.rbを生成する。

mkdir config
vi config/puma.rb

app_root = "#{File.expand_path("../..", __FILE__)}"
pidfile "#{app_root}/tmp/pids/puma.pid"
state_path "#{app_root}/tmp/pids/puma.state"
bind "unix://#{app_root}/tmp/sockets/puma.sock"
directory app_root
threads 5,5
workers 2
environment 'production'
daemonize true

daemon化したいと思い、daemonize trueにしたがこのせいでsystemdで動けなくなり、とても苦労した。
あとで説明する。今は必要なので、そのままおいて。

bundle execは面倒だからpumaコマンドは生成しておく。

bundle binstubs puma

binディレクトリが生成されpumaやpumactlコマンドが生成されているはずだ。

ここまでするとプロジェクトの中身はこうなる。

.
├── Gemfile
├── Gemfile.lock
├── bin
│   ├── puma
│   ├── pumactl
│   └── rackup
├── config
│   └── puma.rb
├── config.ru
├── data
├── tmp
│   ├── pids
│   └── sockets
└── vendor
    └── bundle

pumaの起動・終了

bin/pumactl -F config/puma.rb start
bin/pumactl -F config/puma.rb stop

nginxの設置
epelが設置されていない場合は先に設置する。
yumリポジトリを登録ではなくyumパッケージで設置する。

sudo yum install epel-release -y
sudo yum install nginx -y

nginx.confファイルを下記のように編集する。

sudo vi /etc/nginx/nginx.conf

# For more information on configuration, see:
#   * Official English Documentation: http://nginx.org/en/docs/
#   * Official Russian Documentation: http://nginx.org/ru/docs/

user vagrant;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

# Load dynamic modules. See /usr/share/nginx/README.dynamic.
include /usr/share/nginx/modules/*.conf;

events {
    worker_connections 1024;
}

http {
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;
    types_hash_max_size 2048;

    include             /etc/nginx/mime.types;
    default_type        application/octet-stream;

    # Load modular configuration files from the /etc/nginx/conf.d directory.
    # See http://nginx.org/en/docs/ngx_core_module.html#include
    # for more information.
    include /etc/nginx/conf.d/*.conf;

    server {
        listen       80;
        listen       [::]:80;
        server_name  gembox;
        client_max_body_size 100M;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;
    }
}

vagrantユーザでpumaが実行されるので、nginxのworkerプロセスもvagrantで実行される必要がある。
そうしないと502 Bad Gatewayエラーが発生する。
そのときのエラーログはこうだ。

cat /var/log/nginx/error.log

...
2017/04/07 01:43:53 [crit] 13203#0: *1 connect() to unix:/home/vagrant/gembox/tmp/sockets/puma.sock failed (13: Permission denied) while connecting to upstream, client: 192.168.33.1, server: _, request: "GET / HTTP/1.1", upstream: "http://unix:/home/vagrant/gembox/tmp/sockets/puma.sock:/", host: "gembox"
...

serverの設定
- include /etc/nginx/conf.d/gembox_server.conf

upstream gembox {
  server unix:/home/vagrant/gembox/tmp/sockets/puma.sock;
}

locationの設定
- include /etc/nginx/default.d/gembox_server.conf

location / {
  proxy_pass http://gembox;
  proxy_set_header Host $http_host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

nginxの起動・終了・状態・リロード

sudo systemctl start nginx.service
sudo systemctl stop nginx.service
sudo systemctl status nginx.service
sudo systemctl reload nginx.service

おまけにsystemdについて

ここまでするとちゃんとgeminaboxのページが表示されるはずだが、もし表示されなかった場合は80ポートLISTENされているのか、確認する。
firewalld含めて確認する必要がある。

geminaboxページが表示されたら、gemファイルを１個選んでアップロードしてみよう。
必ずアップロードするんだ。アップロードするとgem保管箱の仕組みが作られるみたい。
空いていたdataディレクトリにファイルやディレクトリが生成される。

data
├── _cache
├── _temp
├── gems
├── latest_specs.4.8
├── latest_specs.4.8.gz
├── prerelease_specs.4.8
├── prerelease_specs.4.8.gz
├── quick
├── specs.4.8
└── specs.4.8.gz

gemファイル１個だけアップロードする場合はこれでも悪くないが、複数のgemをアップロードするにはコマンドが便利。

mac（ホスト） - vagrant（ゲスト、geminaboxサーバー）

vi /private/etc/hosts
192.168.33.10 gembox

ホストからゲストへ複数のgemファイルをアップロードしてみよう。

gem inabox *.gem -g http://gembox

500エラーが発生した。

Pushing yard-0.9.8.gem to http://gembox/...
ERROR:  Error (500 received)

<html>
<head><title>500 Internal Server Error</title></head>
<body bgcolor="white">
<center><h1>500 Internal Server Error</h1></center>
<hr><center>nginx/1.10.2</center>
</body>
</html>

nginxのworkerプロセスはvagrantなので、「/var/lib/nginx」をownerがvagrantではないとgemファイルのアップロードができない。
そのときのエラーログはこうだ。

2017/04/07 10:58:21 [crit] 4488#0: *15 open() "/var/lib/nginx/tmp/client_body/0000000001" failed (13: Permission denied), client: 192.168.33.1, server: gembox, request: "POST /upload HTTP/1.1", host: "gembox"

ownerをvagrantに変更する。（vagrant、ゲスト側）

sudo chown -R vagrant /var/lib/nginx

もう一度やってみる。
アップロードファイルのサイズが大きい場合はエラーが発生する。

Pushing nokogiri-1.7.0.1.gem to http://gembox/...
ERROR:  Error (413 received)

<html>
<head><title>413 Request Entity Too Large</title></head>
<body bgcolor="white">
<center><h1>413 Request Entity Too Large</h1></center>
<hr><center>nginx/1.10.2</center>
</body>
</html>

そのときのエラーログはこうだ。（vagrant、ゲスト側）

2017/04/07 11:50:52 [error] 4488#0: *70 client intended to send too large body: 9148319 bytes, client: 192.168.33.1, server: gembox, request: "POST /upload HTTP/1.1", host: "gembox"

このようなときは、nginx.confファイルの中でclient_max_body_sizeを適当に大きいサイズで変更しよう。

もう一度やってみる。
アップロードしたgemファイルが表示されるはずだ。

http://gembox

これでおわり！
ではない。

pumaをsystemdのサービスに登録して使う。

sudo vi /etc/systemd/system/puma.service

[Unit]
Description=Puma HTTP Server
After=network.target

[Service]
Type=simple
User=vagrant
Group=vagrant
PIDFile=/home/vagrant/gembox/tmp/pids/puma.pid
WorkingDirectory=/home/vagrant/gembox
ExecStart=/usr/bin/bash -lc 'bin/pumactl -F config/puma.rb start'
ExecReload=/bin/kill -s USR1 $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
TimeoutSec=300
Restart=always

[Install]
WantedBy=multi-user.target

systemdの詳細は割愛する。
Software Design 2015年2月号のLinux systemd入門を参考

おまけにpuma関連signal

https://github.com/puma/puma/blob/master/docs/signals.md

ExecStartがサービスをstartするとき実行されるコマンドだが、「/usr/bin/bash -lc 'puma起動コマンド'」で実行しないといけない。
そうしないとvagrantではないrootユーザーのログインシェルで実行される。

puma.rbファイルからdaemonize trueの設定を消す！
systemdのサービスがdaemon化してくれることだから要らないし、むしろこれのせいでサービスがずっとfailedになってしまう。

おしまい。