Rails 애플리케이션 운영 환경 배포 가이드

SECRET_KEY_BASE 환경변수 설정

운영 환경에서 안전한 세션 관리를 위해 비밀 키를 생성합니다.

bin/rails secret

생성된 키를 시스템 환경변수에 등록합니다.

# /etc/profile 또는 ~/.bashrc
export SECRET_KEY_BASE=생성된_키_값

# 적용
source /etc/profile

Puma 서버 구성

소켓 기반 통신을 사용하는 Puma 설정 예시입니다.

# config/puma.rb
max_threads = ENV.fetch("RAILS_MAX_THREADS", 5)
threads max_threads, max_threads

rack_env = ENV.fetch("RACK_ENV", "production")
environment rack_env

# 데몬 모드 및 프로세스 설정
daemonize true
pidfile "/var/run/puma.pid"
state_path "/var/run/puma.state"

# 워 설정
workers Integer(ENV.fetch("WEB_CONCURRENCY", 2))
worker_timeout 30

# 소켓 및 로그 경로
app_dir = "/var/www/myapp"
bind "unix://#{app_dir}/tmp/sockets/puma.sock"
activate_control_app "unix://#{app_dir}/tmp/sockets/pumactl.sock"

stdout_redirect "#{app_dir}/log/puma.stdout.log", 
                "#{app_dir}/log/puma.stderr.log", true

preload_app!

설정 후 Puma를 기동합니다.

bundle exec puma -C config/puma.rb -e production

기동 실패 시 daemonize를 주석 처리하면 터미널에 에러 메시지가 표시됩니다.

Nginx 리버스 프록시 설정

정적 파일 처리와 부하 분산을 담당하는 Nginx 설정입니다.

# /etc/nginx/sites-available/myapp
upstream puma_backend {
    server unix:/var/www/myapp/tmp/sockets/puma.sock fail_timeout=0;
}

server {
    listen 80;
    server_name example.com;

    root /var/www/myapp/public;
    try_files $uri @rails_app;

    location @rails_app {
        proxy_pass http://puma_backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_redirect off;
        proxy_read_timeout 30s;
    }

    location ~ ^/(assets|packs)/ {
        expires max;
        add_header Cache-Control public;
        gzip_static on;
    }

    error_page 500 502 503 504 /500.html;
    client_max_body_size 50M;
    keepalive_timeout 65;
}

설정 적용 및 재시작:

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Systemd 서비스 등록 (선택)

서버 재부팅 시 자동 기동을 위한 서비스 파일입니다.

# /etc/systemd/system/puma.service
[Unit]
Description=Puma HTTP Server
After=network.target

[Service]
Type=simple
User=deploy
WorkingDirectory=/var/www/myapp
ExecStart=/usr/local/bin/bundle exec puma -C config/puma.rb
ExecStop=/usr/local/bin/bundle exec pumactl -S /var/run/puma.state stop
Restart=always

[Install]
WantedBy=multi-user.target
sudo systemctl enable puma
sudo systemctl start puma

태그: rails Puma nginx Reverse Proxy systemd

10월 16일 15:39에 게시됨