Cách cài đặt Ruby on Rails trên Ubuntu 24.04

[theanh]

Ruby on Rails hay RoR hoặc Rails là một nền tảng ứng dụng web Ruby với kiến trúc MVC (Model-View-Controller), cũng như các triết lý thiết kế như Don't Repeat Yourself (DRY), Convention over Configuration (CoC) và mô hình bản ghi hoạt động. Đây là một khuôn khổ web đầy đủ để xây dựng các ứng dụng web cấp doanh nghiệp.

Trong hướng dẫn này, chúng tôi sẽ hướng dẫn bạn quy trình cài đặt Ruby on Rails trên Ubuntu 24.04, tạo dự án Rails đầu tiên, cấu hình PostgreSQL làm cơ sở dữ liệu cho dự án Rails của bạn và tạo một khung với lệnh 'rails'.

Điều kiện tiên quyết​

Trước khi bắt đầu, hãy đảm bảo rằng bạn có những điều sau:

• Máy chủ Ubuntu 24.04.
• Người dùng không phải root có quyền quản trị viên sudo.

Cài đặt các phụ thuộc​

Để cài đặt Ruby on Rails trên hệ thống Ubuntu của bạn, bạn phải cài đặt các phụ thuộc như Ruby, Node.js, PostgreSQL (tùy chọn cho cơ sở dữ liệu), Git và các gói phát triển bổ sung. Các gói đó có sẵn trên kho lưu trữ Ubuntu mặc định và bạn có thể cài đặt chúng bằng APT.

Để bắt đầu, hãy cập nhật kho lưu trữ Ubuntu của bạn bằng lệnh sau:

sudo apt update

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22704%22%20height=%22193%22%3E%3C/svg%3E


Bây giờ hãy cài đặt các phần phụ thuộc cho Ruby on Rails bằng lệnh bên dưới. Với điều này, bạn sẽ cài đặt Ruby, PostgreSQL, Node.js, git và một số gói dành cho nhà phát triển.

sudo apt install ruby ruby-dev postgresql libpq-dev nodejs yarnpkg git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev libffi-dev

Nhập Y để tiến hành cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%2283%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, hãy kiểm tra phiên bản Ruby và Node.js bằng sau:

ruby -v
node -v

Bạn có thể thấy bên dưới Ruby 3.2 và Node.js 18.19 đã được cài đặt.

Tiếp theo, chạy lệnh bên dưới để thiết lập Yarn làm trình quản lý gói Node.js bằng lệnh bên dưới. Lệnh này sẽ tạo ra một lệnh mới 'yarn' và bạn sẽ thấy phiên bản của Yarn.

sudo ln -s /usr/bin/yarnpkg /usr/bin/yarn
yarnpkg -v

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22653%22%20height=%22231%22%3E%3C/svg%3E


Cuối cùng, hãy kiểm tra trạng thái dịch vụ PostgreSQL bằng sau:

sudo systemctl is-enabled postgresql
sudo systemctl status postgresql

Máy chủ PostgreSQL sẽ khởi động khi khởi động và trạng thái PostgreSQL là 'hoạt động (đã thoát)'.

Tạo người dùng PostgreSQL​

Sau khi cài đặt các phụ thuộc, bạn sẽ tạo người dùng PostgreSQL mới cho dự án Rails của mình. Người dùng này phải có thể đăng nhập và tạo cơ sở dữ liệu mới trên PostgreSQL.

Đăng nhập vào máy chủ PostgreSQL bằng lệnh bên dưới.

sudo -u postgres psql

Chạy các truy vấn sau để tạo người dùng PostgreSQL mới 'appuser' với mật khẩu 'AppuserPassword'. Người dùng này sẽ có thể tạo cơ sở dữ liệu và vai trò trong PostgreSQL.

CREATE USER appuser WITH PASSWORD 'AppuserPassword';
ALTER USER appuser CREATEDB CREATEROLE;

Bây giờ hãy nhập quit hoặc nhấn Ctrl+d để thoát khỏi PostgreSQL.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22746%22%20height=%22418%22%3E%3C/svg%3E


Tiếp theo, hãy chạy lệnh sau để đăng nhập vào PostgreSQL với người dùng 'appuser'. Nhập mật khẩu của bạn khi được nhắc.

su - postgres
psql -U appuser -h 127.0.0.1 -d postgres

Sau khi đăng nhập, hãy kiểm tra trạng thái kết nối PostgreSQL bằng lệnh sau:

\conninfo

Bạn có thể thấy bên dưới người dùng mới 'appuser' có thể kết nối với máy chủ PostgreSQL bằng xác thực mật khẩu thông qua localhost hoặc 127.0.0.1.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22292%22%3E%3C/svg%3E

Cài đặt Ruby on Rails​

Trong phần này, bạn sẽ cài đặt Ruby on Rails mới nhất trên môi trường dành riêng cho người dùng. Vì vậy, bạn cần thiết lập thư mục GEM_HOME mặc định dưới người dùng của mình.

Đầu tiên, hãy đăng nhập vào người dùng của bạn bằng lệnh sau:

su - user

Tạo một thư mục ~/.gem mới và thêm biến môi trường GEM_HOME thông qua tệp ~/.bashrc. Với điều này, tất cả các gem Ruby sẽ được cài đặt trong thư mục ~/.gem.

mkdir -p ~/.gem
echo 'export GEM_HOME=$HOME/.gem' >> $HOME/.bashrc

Bây giờ hãy chạy lệnh bên dưới để tải lại shell hiện tại của bạn và kiểm tra biến môi trường GEM_HOME. Bạn sẽ thấy GEM_HOME được trỏ đến thư mục ~/.gem.

source ~/.bashrc
echo $GEM_HOME

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22689%22%20height=%22171%22%3E%3C/svg%3E


Tiếp theo, chạy lệnh gem bên dưới để cài đặt bundler vào hệ thống.

gem install bundler

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22594%22%20height=%22190%22%3E%3C/svg%3E


Sau đó, cài đặt Ruby on Rails bằng lệnh gem sau. Bạn có thể cài đặt phiên bản Ruby on Rails mới nhất hoặc chọn phiên bản cụ thể bằng tùy chọn -v.

gem install rails
gem install rails -v 7.1.0

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22591%22%20height=%22191%22%3E%3C/svg%3E


Khi quá trình cài đặt hoàn tất, hãy kiểm tra phiên bản Ruby on Rails bằng lệnh bên dưới:

rails --version
rails --help

Như được hiển thị bên dưới, Ruby on Rails 7.1.3 mới nhất đã được cài đặt và bạn cũng có thể thấy cách sử dụng cơ bản của lệnh 'rails'.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22419%22%3E%3C/svg%3E

Tạo dự án với Ruby on Rails và PostgreSQL​

Bây giờ bạn đã cài đặt Ruby on Rails. Trong phần này, bạn sẽ tạo dự án Rails đầu tiên của mình với PostgreSQL làm cơ sở dữ liệu mặc định.

Chạy lệnh 'rails' bên dưới để tạo dự án Rails mới. Trong ví dụ này, bạn sẽ tạo một dự án mới testapp với cơ sở dữ liệu mặc định là PostgreSQL.

rails new testapp -d postgresql

Bạn có thể thấy bên dưới ứng dụng Rails được tạo, bao gồm cả git đã được khởi tạo.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22716%22%20height=%22679%22%3E%3C/svg%3E


Bây giờ hãy chuyển đến thư mục ~/testapp và chỉnh sửa Tệp cấu hình cơ sở dữ liệu 'config/database.yml'.

cd ~/testapp/
nano config/database.yml

Thay đổi thông tin chi tiết cơ sở dữ liệu cho môi trường phát triển, thử nghiệm và sản xuất như sau. Cơ sở dữ liệu cho mỗi môi trường sẽ được tạo tự động trong quá trình di chuyển.

development: