在AlmaLinux系统上轻松部署Ruby on Rails应用环境从零开始搭建开发平台详细教程指南

引言
Ruby on Rails(简称Rails)是一个使用Ruby语言编写的开源Web应用框架,它遵循MVC(模型-视图-控制器)架构模式,旨在使Web应用开发变得更加简单和高效。AlmaLinux是一个免费的、开源的、企业级的Linux发行版,它是CentOS的替代品,提供了稳定性和安全性,非常适合作为服务器操作系统。
本教程将详细介绍如何在AlmaLinux系统上从零开始搭建Ruby on Rails应用环境,包括系统准备、Ruby安装、Rails安装、数据库配置、Web服务器配置以及应用部署等全过程。无论您是Rails开发新手还是有经验的开发者,本教程都将帮助您在AlmaLinux上建立一个完整的Rails开发平台。
系统准备
在开始安装Ruby on Rails之前,我们需要确保AlmaLinux系统是最新的,并安装一些必要的工具和依赖项。
更新系统
首先,让我们更新系统到最新状态:
sudo dnf update -y
安装EPEL仓库
EPEL(Extra Packages for Enterprise Linux)是一个由Fedora特别兴趣小组创建和维护的仓库,提供了许多不在标准仓库中的额外软件包:
sudo dnf install epel-release -y
安装开发工具
Rails应用需要一些开发工具和库来编译和运行。让我们安装这些工具:
sudo dnf groupinstall “Development Tools” -y
安装其他必要的依赖
安装一些Ruby和Rails可能需要的其他依赖:
sudo dnf install -y git-core zlib zlib-devel gcc-c++ patch readline readline-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison curl sqlite-devel libxml2-devel libxslt-devel libcurl-devel nodejs yarn
安装Ruby
有几种方法可以在AlmaLinux上安装Ruby。我们将介绍两种最常用的方法:使用RVM(Ruby Version Manager)和使用rbenv。这两种工具都允许您轻松管理和切换多个Ruby版本。
使用RVM安装Ruby
RVM是一个命令行工具,可以让您轻松安装、管理和使用多个Ruby环境。
安装RVM
首先,我们需要安装RVM的GPG密钥:
gpg –keyserver hkp://keys.gnupg.net –recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
然后,安装RVM:
curl -sSL https://get.rvm.io | bash -s stable
安装完成后,加载RVM环境:
source ~/.rvm/scripts/rvm
安装Ruby
使用RVM安装最新的稳定版Ruby:
rvm install ruby –latest
安装完成后,设置为默认版本:
rvm use ruby –default
验证Ruby安装:
ruby -v
您应该看到类似以下的输出:
ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-linux]
使用rbenv安装Ruby
rbenv是另一个流行的Ruby版本管理工具,它允许您轻松切换Ruby版本。
安装rbenv
首先,安装rbenv及其依赖:
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo ‘export PATH=”$HOME/.rbenv/bin:$PATH”‘ >> ~/.bashrc
echo ‘eval “$(rbenv init -)”‘ >> ~/.bashrc
exec $SHELL
安装ruby-build插件
ruby-build插件为rbenv提供了
install
命令:
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo ‘export PATH=”$HOME/.rbenv/plugins/ruby-build/bin:$PATH”‘ >> ~/.bashrc
exec $SHELL
安装Ruby
使用rbenv安装最新的稳定版Ruby:
rbenv install 3.1.2
设置为全局默认版本:
rbenv global 3.1.2
验证Ruby安装:
ruby -v
安装Bundler
Bundler是Ruby的依赖管理工具,它确保您的应用拥有所需的所有gem(Ruby库):
gem install bundler
安装Rails
现在我们已经安装了Ruby,接下来安装Rails框架:
gem install rails
安装完成后,验证Rails安装:
rails -v
您应该看到类似以下的输出:
Rails 7.0.4
配置数据库
Rails应用通常需要一个数据库来存储数据。我们将介绍如何安装和配置两种流行的数据库:MySQL和PostgreSQL。您可以根据需要选择其中一种。
安装和配置MySQL
安装MySQL服务器
sudo dnf install -y mysql-server mysql-devel
启动MySQL服务并设置开机自启
sudo systemctl start mysqld
sudo systemctl enable mysqld
安全配置MySQL
运行MySQL安全安装脚本:
sudo mysql_secure_installation
按照提示设置root密码和其他安全选项。
创建Rails应用数据库
登录MySQL:
mysql -u root -p
创建数据库和用户:
CREATE DATABASE myapp_development;
CREATE DATABASE myapp_test;
CREATE USER ‘railsuser’@’localhost’ IDENTIFIED BY ‘password’;
GRANT ALL PRIVILEGES ON myapp_development.* TO ‘railsuser’@’localhost’;
GRANT ALL PRIVILEGES ON myapp_test.* TO ‘railsuser’@’localhost’;
FLUSH PRIVILEGES;
EXIT;
安装和配置PostgreSQL
安装PostgreSQL服务器
sudo dnf install -y postgresql-server postgresql-contrib postgresql-devel
初始化数据库
sudo postgresql-setup –initdb
启动PostgreSQL服务并设置开机自启
sudo systemctl start postgresql
sudo systemctl enable postgresql
设置PostgreSQL用户密码
sudo -u postgres psql
在PostgreSQL提示符下,设置密码:
\password postgres
输入并确认密码,然后退出:
\q
创建Rails应用数据库
sudo -u postgres createuser –interactive
按照提示创建新用户,例如创建名为”railsuser”的用户:
Enter name of role to add: railsuser
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
创建开发数据库和测试数据库:
sudo -u postgres createdb myapp_development -O railsuser
sudo -u postgres createdb myapp_test -O railsuser
安装其他必要组件
Rails应用还需要一些其他组件,如Node.js和Yarn,用于处理JavaScript和CSS资源。
安装Node.js和Yarn
虽然我们在之前已经安装了Node.js,但让我们确保安装的是最新的LTS版本:
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash –
sudo dnf install -y nodejs
安装Yarn:
curl –silent –location https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo dnf install -y yarn
验证安装:
node -v
npm -v
yarn -v
创建Rails应用
现在我们已经准备好所有必要的组件,让我们创建一个Rails应用。
创建新应用
使用Rails命令创建新应用。如果您使用MySQL,请运行:
rails new myapp -d mysql
如果您使用PostgreSQL,请运行:
rails new myapp -d postgresql
配置数据库连接
编辑
config/database.yml
文件,根据您之前创建的数据库用户和密码进行配置:
default: &default
adapter: mysql2 # 或 postgresql
encoding: utf8mb4
pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
username: railsuser
password: password
host: localhost

development:
<<: *default database: myapp_development test: <<: *default database: myapp_test 创建数据库 在应用目录中运行: cd myapp rails db:create 启动Rails服务器 rails server 现在,您可以在浏览器中访问 http://localhost:3000 ,您应该看到Rails的欢迎页面。 配置Web服务器 在生产环境中,我们通常使用Web服务器(如Nginx或Apache)来处理HTTP请求,并将它们转发到Rails应用服务器。我们将介绍如何配置Nginx。 安装Nginx sudo dnf install -y nginx 启动Nginx并设置开机自启 sudo systemctl start nginx sudo systemctl enable nginx 配置防火墙 如果您的系统启用了防火墙,需要允许HTTP和HTTPS流量: sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --permanent --add-service=https sudo firewall-cmd --reload 创建Nginx配置文件 为您的Rails应用创建Nginx配置文件: sudo nano /etc/nginx/conf.d/myapp.conf 添加以下配置: upstream myapp { server unix:/var/run/puma/myapp.sock; } server { listen 80; server_name your_domain.com; root /home/user/myapp/public; try_files $uri/index.html $uri @myapp; location @myapp { proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header Host $http_host; proxy_redirect off; proxy_pass http://myapp; } location ~ ^/(assets|packs) { gzip_static on; expires max; add_header Cache-Control public; } error_page 500 502 503 504 /500.html; client_max_body_size 4G; keepalive_timeout 10; } 将 your_domain.com 替换为您的实际域名或服务器IP地址。 测试Nginx配置 sudo nginx -t 如果配置正确,您应该看到以下输出: nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful 重新加载Nginx配置 sudo systemctl reload nginx 配置应用服务器 Rails自带了一个名为Puma的应用服务器,它是一个高性能的并发Web服务器。我们将配置Puma与Nginx一起工作。 创建Puma配置文件 在Rails应用的 config 目录中创建 puma.rb 文件: nano config/puma.rb 添加以下配置: # Puma can serve each request in a thread from an internal thread pool. # The `threads` method setting takes two numbers: a minimum and maximum. # Any libraries that use thread pools should be configured to match # the maximum value specified for Puma. Default is set to 5 threads for minimum # and maximum; this matches the default thread size of Active Record. # max_threads_count = ENV.fetch("RAILS_MAX_THREADS") { 5 } min_threads_count = ENV.fetch("RAILS_MIN_THREADS") { max_threads_count } threads min_threads_count, max_threads_count # Specifies the `worker_timeout` threshold that Puma will use to wait before # terminating a worker in development environments. # worker_timeout 3600 if ENV.fetch("RAILS_ENV", "development") == "development" # Specifies the `port` that Puma will listen on to receive requests; default is 3000. # port ENV.fetch("PORT") { 3000 } # Specifies the `environment` that Puma will run in. # environment ENV.fetch("RAILS_ENV") { "development" } # Specifies the `pidfile` that Puma will use. pidfile ENV.fetch("PIDFILE") { "tmp/pids/server.pid" } # Specifies the number of `workers` to boot in clustered mode. # Workers are forked web server processes. If using threads and workers together # the concurrency of the application would be max `threads` * `workers`. # Workers do not work on JRuby or Windows (both of which do not support # processes). # # workers ENV.fetch("WEB_CONCURRENCY") { 2 } # Use the `preload_app!` method when specifying a `workers` number. # This directive tells Puma to first boot the application and load code # before forking the application. This takes advantage of Copy On Write # process behavior so workers use less memory. # # preload_app! # Allow puma to be restarted by `rails restart` command. plugin :tmp_restart 创建Puma systemd服务文件 创建systemd服务文件来管理Puma进程: sudo nano /etc/systemd/system/puma.service 添加以下内容: [Unit] Description=Puma HTTP Server After=network.target [Service] Type=simple User=user WorkingDirectory=/home/user/myapp ExecStart=/bin/bash -lc 'bundle exec puma -C config/puma.rb' ExecReload=/bin/kill -SIGUSR1 $MAINPID Restart=always [Install] WantedBy=multi-user.target 将 User=user 替换为您的实际用户名。 创建Puma socket目录 sudo mkdir -p /var/run/puma sudo chown user:user /var/run/puma 启动Puma服务并设置开机自启 sudo systemctl start puma sudo systemctl enable puma 检查Puma服务状态 sudo systemctl status puma 部署Rails应用 现在我们已经配置好了所有组件,让我们部署Rails应用。 预编译资产 在生产环境中,我们需要预编译Rails应用的静态资产: RAILS_ENV=production bundle exec rake assets:precompile 设置环境变量 Rails应用通常需要一些环境变量,如数据库凭据和密钥。我们可以使用 .env 文件或直接设置环境变量。 创建 .env 文件: nano .env 添加必要的环境变量: RAILS_ENV=production SECRET_KEY_BASE=your_secret_key_base DATABASE_USERNAME=railsuser DATABASE_PASSWORD=password 您可以通过运行以下命令生成密钥: rails secret 迁移数据库 在生产环境中运行数据库迁移: RAILS_ENV=production rails db:migrate 重启Puma服务 sudo systemctl restart puma 检查应用状态 现在,您应该能够通过浏览器访问您的域名或服务器IP地址,看到您的Rails应用正在运行。 常见问题解决 在部署Rails应用的过程中,您可能会遇到一些常见问题。以下是一些解决方案: 问题1: Gem安装失败 如果某些gem安装失败,可能是因为缺少必要的开发库。确保安装了所有必要的依赖: sudo dnf install -y ruby-devel mysql-devel postgresql-devel nodejs yarn 问题2: 资产预编译失败 如果资产预编译失败,可能是因为Node.js或Yarn版本不兼容。尝试更新它们: sudo dnf module reset nodejs sudo dnf module enable nodejs:14 sudo dnf install -y nodejs npm 问题3: 数据库连接错误 如果遇到数据库连接错误,请检查 config/database.yml 文件中的配置是否正确,并确保数据库服务正在运行: sudo systemctl status mysqld # 或 sudo systemctl status postgresql 问题4: 权限问题 如果遇到权限问题,确保您的应用文件和目录具有正确的权限: sudo chown -R user:user /home/user/myapp sudo chmod -R 755 /home/user/myapp 问题5: Puma无法启动 如果Puma无法启动,检查日志以获取更多信息: sudo journalctl -u puma -f 总结 在本教程中,我们详细介绍了如何在AlmaLinux系统上从零开始搭建Ruby on Rails应用环境。我们涵盖了以下内容: 系统准备:更新系统并安装必要的工具和依赖 Ruby安装:使用RVM或rbenv安装Ruby Rails安装:通过gem安装Rails框架 数据库配置:安装和配置MySQL或PostgreSQL 其他必要组件:安装Node.js和Yarn 创建Rails应用:创建并配置基本的Rails应用 Web服务器配置:安装和配置Nginx 应用服务器配置:安装和配置Puma 部署Rails应用:将应用部署到生产环境 常见问题解决:解决部署过程中可能遇到的问题 通过遵循本教程,您现在应该能够在AlmaLinux系统上成功部署Ruby on Rails应用,并开始您的Web开发之旅。无论您是构建个人项目还是企业级应用,Rails和AlmaLinux的组合都能提供一个稳定、高效的开发平台。 祝您在Ruby on Rails开发之旅中取得成功!