Cách cài đặt Ruby on Rails với rbenv trên macOS

Ruby on Rails là một ứng dụng phổ biến dành cho các nhà phát triển muốn tạo các trang web và ứng dụng web. Ngôn ngữ lập trình Ruby , kết hợp với khung phát triển Rails, giúp phát triển ứng dụng nhanh chóng và hiệu quả.

---

Một cách để cài đặt Ruby và Rails là sử dụng công cụ dòng lệnh rbenv . Sử dụng rbenv sẽ cung cấp cho bạn một môi trường được kiểm soát tốt và mạnh mẽ để phát triển các ứng dụng Ruby on Rails của bạn, cho phép bạn dễ dàng chuyển đổi version Ruby cho toàn bộ group của bạn khi cần thiết.

rbenv cung cấp hỗ trợ để chỉ định các version Ruby dành riêng cho ứng dụng, cho phép bạn thay đổi Ruby chung cho từng user và cho phép bạn sử dụng một biến môi trường để overrides version Ruby.

Trong hướng dẫn này, bạn sẽ sử dụng rbenv để cài đặt và cài đặt Ruby on Rails trên máy macOS local của bạn .

Yêu cầu

Để làm theo hướng dẫn này, bạn cần :

• Một máy tính hoặc máy ảo được cài đặt macOS, có quyền truy cập quản trị vào máy đó và kết nối Internet. Hướng dẫn này đã được thử nghiệm trên macOS 10.14 Mojave .
• Node.js được cài đặt trên máy macOS của bạn, như được giải thích trong Cách cài đặt Node.js và Tạo Môi trường Phát triển Cục bộ trên macOS . Một vài tính năng của Rails, chẳng hạn như Asset Pipeline , phụ thuộc vào JavaScript Runtime. Node.js cung cấp chức năng này.

Bước 1 - Cài đặt rbenv

Trong bước này, bạn sẽ cài đặt rbenv và đảm bảo nó tự động khởi động khi server khởi động . Để thực hiện việc này trên macOS, hướng dẫn này sẽ sử dụng trình quản lý gói Homebrew .

Để download gói rbenv với Homebrew, hãy chạy lệnh sau:

brew install rbenv 

Thao tác này sẽ cài đặt rbenv và plugin ruby-build . Plugin này thêm lệnh rbenv install , giúp hợp lý hóa quá trình cài đặt cho các version Ruby mới.

Tiếp theo, bạn sẽ thêm lệnh eval "$(rbenv init -)" vào file ~/.bash_profile mình để làm cho rbenv tự động tải khi bạn mở Terminal. Để thực hiện việc này, hãy mở .bash_profile của bạn trong editor yêu thích của bạn:

nano .bash_profile 

Thêm dòng sau vào file :

eval "$(rbenv init -)" 

Lưu và thoát khỏi file .

Tiếp theo, áp dụng các thay đổi bạn đã thực hiện đối với file ~/.bash_profile cho phiên shell hiện tại của bạn:

source ~/.bash_profile 

Để xác minh rbenv được cài đặt đúng cách, hãy sử dụng lệnh type , lệnh này sẽ hiển thị thêm thông tin về lệnh rbenv :

type rbenv 

Cửa sổ terminal của bạn sẽ hiển thị như sau:

Output
rbenv is a function rbenv () {     local command;     command="${1:-}";     if [ "$#" -gt 0 ]; then         shift;     fi;     case "$command" in         rehash | shell)             eval "$(rbenv "sh-$command" "$@")"         ;;         *)             command rbenv "$command" "$@"         ;;     esac } 

Đến đây, bạn đã cài đặt cả rbenv và ruby-build trên máy của bạn . Điều này sẽ cho phép bạn cài đặt Ruby từ dòng lệnh trong bước tiếp theo.

Bước 2 - Cài đặt Ruby

Với plugin ruby-build hiện đã được cài đặt, bạn có thể cài đặt bất kỳ version nào của Ruby mà bạn có thể cần thông qua một lệnh duy nhất. Trong bước này, bạn sẽ chọn một version Ruby, cài đặt nó vào máy của bạn, sau đó xác minh cài đặt.

Đầu tiên, sử dụng cờ -l để liệt kê tất cả các version có sẵn của Ruby:

rbenv install -l 

Đầu ra của lệnh đó sẽ là một danh sách dài các version mà bạn có thể chọn để cài đặt.

Đối với hướng dẫn này, hãy cài đặt Ruby 2.6.3 :

rbenv install 2.6.3 

Cài đặt Ruby có thể là một quá trình kéo dài, vì vậy hãy chuẩn bị cho quá trình cài đặt mất một chút thời gian để hoàn thành.

Một khi hoàn thành công việc lắp đặt, cài đặt nó như là version mặc định của bạn của Ruby với global phụ lệnh:

rbenv global 2.6.3 

Xác minh Ruby đã được cài đặt đúng cách bằng cách kiểm tra số version của nó:

ruby -v 

Đầu ra của bạn sẽ giống như sau:

Output
ruby 2.6.3p62 (2019-04-16 revision 67580) [x86_64-darwin18] 

Để cài đặt và sử dụng version Ruby khác, hãy chạy lệnh rbenv với số version khác, chẳng hạn như rbenv install 2.3.0 và rbenv global 2.3.0 .

Đến đây bạn đã cài đặt một version Ruby và đã đặt version Ruby mặc định của bạn . Tiếp theo, bạn sẽ tự cài đặt để làm việc với các gói và thư viện Ruby, hoặc đá quý , sau đó sẽ cho phép bạn cài đặt Rails.

Bước 3 - Làm việc với Đá quý

Đá quý là các gói thư viện và chương trình Ruby có thể được phân phối trong toàn bộ hệ sinh thái Ruby. Bạn sử dụng lệnh gem để quản lý các gem này. Trong bước này, bạn sẽ cấu hình lệnh gem để chuẩn bị cho quá trình cài đặt Rails.

Khi bạn cài đặt một gem, quá trình cài đặt sẽ tạo ra tài liệu local . Điều này có thể làm tăng thêm một lượng thời gian đáng kể cho quá trình cài đặt của mỗi gem, vì vậy hãy tắt tính năng tạo tài liệu local bằng cách tạo một file có tên ~/.gemrc chứa cài đặt cấu hình để tắt tính năng này:

echo "gem: --no-document" > ~/.gemrc 

Sau khi hoàn tất, hãy sử dụng lệnh gem để cài đặt Bundler , một công cụ quản lý dependencies vào gem cho các dự án. Điều này là cần thiết để Rails hoạt động chính xác:

gem install bundler 

Bạn sẽ thấy kết quả như thế này:

Output
Fetching: bundler-2.0.2.gem Successfully installed bundler-2.0.2 1 gem installed 

Bạn có thể sử dụng lệnh gem env để tìm hiểu thêm về môi trường và cấu hình của đá quý. Để xem vị trí của các viên ngọc đã cài đặt, hãy sử dụng đối số home , như sau:

gem env home 

Bạn sẽ thấy kết quả tương tự như sau:

/Users/sammy/.rbenv/versions/2.6.3/lib/ruby/gems/2.6.0 

Đến đây bạn đã cài đặt và khám phá quy trình làm việc gem của bạn , bạn có thể tự do cài đặt Rails.

Bước 4 - Cài đặt Rails

Để cài đặt Rails, hãy sử dụng lệnh gem install cùng với cờ -v để chỉ định version . Đối với hướng dẫn này, ta sẽ sử dụng version 5.2.3 :

gem install rails -v 5.2.3 

Lệnh gem cài đặt đá quý mà bạn chỉ định, cũng như mọi phụ thuộc. Rails là một khung phát triển web phức tạp và có nhiều phụ thuộc, vì vậy quá trình này sẽ mất một khoảng thời gian để hoàn thành. Cuối cùng, bạn sẽ thấy một thông báo cho biết Rails đã được cài đặt, cùng với các phụ thuộc của nó:

Output
... Successfully installed rails-5.2.3 38 gems installed 

Lưu ý : Nếu bạn muốn cài đặt một version Rails khác, bạn có thể liệt kê các version Rails hợp lệ bằng cách thực hiện tìm kiếm, thao tác này sẽ xuất ra một danh sách dài các version có thể có. Sau đó, ta có thể cài đặt một version cụ thể, chẳng hạn như 4.2.7 :

gem search '^rails$' --all 
gem install rails -v 4.2.7 

Nếu bạn muốn cài đặt version Rails mới nhất, hãy chạy lệnh mà không có version được chỉ định:

gem install rails 

rbenv hoạt động bằng cách tạo một folder chứa các miếng chêm hoặc thư viện chặn các cuộc gọi và thay đổi hoặc chuyển hướng chúng. Trong trường hợp này, shims trỏ các lệnh của Ruby tới các file được sử dụng bởi version Ruby hiện đang được kích hoạt. Thông qua lệnh con rehash , rbenv duy trì các miếng chêm trong folder đó để trùng với mọi lệnh Ruby trên mọi version Ruby đã cài đặt trên server của bạn. Khi nào bạn cài đặt một version Ruby mới hoặc một viên đá quý cung cấp các lệnh, chẳng hạn như Rails, bạn nên sử dụng rehash .

Để chia sẻ lại folder shims, hãy chạy lệnh sau:

rbenv rehash 

Xác minh cài đặt Rails của bạn bằng cách in version của nó với lệnh sau:

rails -v 

Bạn sẽ thấy version Rails đã được cài đặt:

Output
Rails 5.2.3 

Với Rails được cài đặt thành công, bạn có thể bắt đầu kiểm tra cài đặt Ruby on Rails của bạn và bắt đầu phát triển các ứng dụng web. Trong bước tiếp theo, bạn sẽ học cách cập nhật và gỡ cài đặt rbenv và Ruby.

Bước 5 - Cập nhật và gỡ cài đặt rbenv và Ruby

Khi bảo trì các dự án, sẽ rất hữu ích nếu bạn biết cách cập nhật và gỡ cài đặt khi có nhu cầu. Trong bước này, bạn sẽ nâng cấp rbenv, sau đó gỡ cài đặt Ruby và rbenv khỏi máy của bạn.

Bạn có thể nâng cấp rbenv và ruby-build bằng Homebrew bằng cách chạy lệnh sau:

brew upgrade rbenv ruby-build 

Nếu cần cập nhật rbenv hoặc ruby-build, Homebrew sẽ tự động làm việc đó cho bạn. Nếu cài đặt của bạn đã được cập nhật, bạn sẽ nhận được kết quả tương tự như sau:

Output
Error: rbenv 1.1.2 already installed Error: ruby-build 20190615 already installed 

Điều này sẽ đảm bảo ta đang sử dụng version rbenv cập nhật nhất hiện có.

Khi bạn download các version bổ sung của Ruby, bạn có thể tích lũy nhiều version hơn bạn muốn trong folder ~/.rbenv/versions . Sử dụng lệnh con uninstall của plugin ruby-build, bạn có thể xóa các version trước đó.

Ví dụ: chạy phần sau để gỡ cài đặt version Ruby 2.1.3 :

rbenv uninstall 2.1.3 

Với lệnh rbenv uninstall bạn có thể dọn dẹp các version cũ của Ruby để không cài đặt nhiều hơn những gì bạn đang sử dụng.

Nếu bạn đã không còn cần sử dụng rbenv nữa, bạn có thể xóa nó khỏi hệ thống của bạn .

Để thực hiện việc này, trước tiên hãy mở file ~/.bash_profile trong editor :

nano ~/.bash_profile 

Tìm và xóa dòng sau khỏi file để ngăn rbenv khởi động khi bạn mở Terminal:

... eval "$(rbenv init -)" 

Khi bạn đã xóa dòng này, hãy lưu file và thoát khỏi editor .

Chạy lệnh sau để áp dụng các thay đổi cho shell của bạn:

source ~/.bash_profile 

Tiếp theo, xóa rbenv và tất cả các version Ruby đã cài đặt bằng lệnh này:

rm -rf `rbenv root` 

Cuối cùng, xóa chính gói rbenv bằng Homebrew:

brew uninstall rbenv 

Kiểm tra version rbenv đảm bảo rằng nó đã được gỡ cài đặt:

rbenv -v 

Bạn sẽ nhận được kết quả sau:

Output
-bash: /usr/local/bin/rbenv: No such file or directory 

Điều này nghĩa là bạn đã xóa thành công rbenv khỏi máy của bạn .

Kết luận

Trong hướng dẫn này, bạn đã cài đặt Ruby on Rails với rbenv trên macOS. Từ đây, bạn có thể tìm hiểu thêm về cách viết mã trong Ruby với loạt bài Cách viết mã trong Ruby của ta . Bạn cũng có thể khám phá cách sử dụng Ruby on Rails với PostgreSQL thay vì database sqlite3 mặc định của nó, cung cấp khả năng mở rộng, tập trung và ổn định hơn cho các ứng dụng của bạn.

---

---

Các tin liên quan