Aby zainstalować i skonfigurować Ruby on Rails na Debianie, postępuj zgodnie z poniższym, rozbudowanym przewodnikiem. Wyjaśniam każdy etap, opisuję najczęstsze narzędzia oraz podaję zalecenia i praktyczne wskazówki.
Wymagania wstępne
- Aktualny Debian (np. 12 Bookworm)
- Uprawnienia do instalowania pakietów (sudo/root)
- Aktywna sieć internetowa
1. Aktualizacja systemu
Przed rozpoczęciem instalacji zalecane jest zaktualizowanie systemu:
sudo apt update sudo apt upgrade 2. Instalacja narzędzi budujących i zależności
Niektóre składniki Ruby wymagają dodatkowych bibliotek:
sudo apt install -y build-essential libssl-dev libreadline-dev zlib1g-dev curl git 3. Instalacja Ruby (zalecane – menedżer wersji)
Zwykle nie korzysta się z systemowego Ruby ze względu na utrudnienia przy aktualizacji i zmianie wersji. Zamiast tego używa się narzędzi takich jak RVM lub rbenv, ale w Debianie 12 szeroko wykorzystywany jest również Mise.
Instalacja Ruby przez Mise
- Zainstaluj Mise (jeśli nie masz):
curl https://mise.run | bash exec ~/.local/bin/mise - Zainstaluj Ruby:
mise use -g ruby@3 To zainstaluje najnowszą stabilną wersję Ruby 3.
- Sprawdź wersję Ruby:
ruby -v Przykładowy wynik:
ruby 3.3.6 (2024-11-05 revision ...) [x86_64-linux]
4. Instalacja Bundler
Bundler to narzędzie do zarządzania zależnościami w projektach Ruby/Rails:
gem install bundler Bundler zainstaluje się automatycznie, jeśli Ruby był instalowany z Mise.
5. Aktualizacja RubyGems
Zalecane jest zaktualizowanie RubyGems (menedżer pakietów dla Ruby):
gem update --system RubyGems jest domyślnie zawarty w instalacji Ruby przez Mise.
6. Instalacja Rails
Przejdź do instalacji właściwego frameworka:
gem install rails Sprawdź wersję Rails:
rails -v 7. Instalacja bazy danych (np. PostgreSQL/MySQL)
Rails domyślnie korzysta z SQLite3, ale do produkcji zaleca się PostgreSQL lub MySQL.
Przykład instalacji PostgreSQL:
sudo apt install postgresql libpq-dev Jeśli chcesz używać MySQL:
sudo apt install mysql-server libmysqlclient-dev 8. Instalacja Node.js i Yarn (do asset pipeline)
Rails wymaga Node.js jako silnika JS oraz Yarn do zarządzania plikami frontendowymi:
sudo apt install nodejs yarnpkg W nowszych wersjach Debian Yarn może być dostępny jako yarnpkg.
9. Tworzenie aplikacji Ruby on Rails
Po zainstalowaniu wszystkich składników możesz utworzyć nową aplikację Rails:
rails new moja_aplikacja cd moja_aplikacja Aby uruchomić serwer:
rails server Serwer będzie dostępny domyślnie pod adresem: [http://localhost:3000].
Uwaga – wersje i menedżery
- Alternatywą dla Mise jest RVM lub rbenv. Jeśli preferujesz je (na przykład do testowania różnych wersji Ruby), najpierw zainstaluj i skonfiguruj wybrane narzędzie zgodnie z dokumentacją.
- Korzystanie z menedżera wersji znacznie ułatwia aktualizacje Ruby oraz pracę na wielu projektach jednocześnie (izolacja środowisk).
Przydatne zasoby
- Oficjalna dokumentacja Rails (https://guides.rubyonrails.org/)
- RubyPolsku – praktyczne porady dla początkujących i programistów (https://www.rubypopolsku.pl/zanim_zaczniesz/)
- Filmy instruktażowe: Instalacja Ruby, tworzenie aplikacji Rails.
Podsumowanie kroków instalacji (schemat dla Debian 12)
- Aktualizuj system
- Zainstaluj zależności
- Zainstaluj Ruby wybranym menedżerem wersji
- Zainstaluj Bundler i Rails
- Zainstaluj bazę danych
- Zainstaluj Node.js i Yarn
- Utwórz projekt Rails i uruchom serwer
Skonfigurowany Debian jest teraz gotowy do pracy z projektami Ruby on Rails, zarówno lokalnie, jak i produkcyjnie.
Wyjaśnienia techniczne –
- RVM/rbenv/Mise – Narzędzia do zarządzania wersjami Ruby — pozwalają łatwo testować różne wersje oraz unikać konfliktów z systemową wersją Ruby.
- RubyGems/Bundler – Menedżery dependency — umożliwiają zarządzanie bibliotekami i zależnościami projektu Rails.
- Node.js/Yarn – Wymagane do obsługi nowoczesnych assetów JavaScript/CSS (Webpacker/Sprockets).
Jeżeli napotkasz problem podczas instalacji, zawsze warto sprawdzić komunikaty błędów oraz oficjalną dokumentację.
