Встановлення необхідних програм для Rails Girls
Переклад українською - Denys Kurets, @denys281
Редагування та оновлення - Aleksandra Klochko, @aleksacastle та Sofiia Kolisnyk
Для створення додатків на Ruby On Rails необхідно встановити деякі програми на твій комп’ютер.
Обери інструкцію, що підходить для твоєї операційної системи. Не панікуй, якщо виникнуть якісь проблеми: повідом нам, та ми вирішимо їх разом.
- Налаштування для OS X
- Налаштування для Windows
- Налаштування для Linux
- Альтернативне налаштування для всіх ОС
- Використання Хмарного Сервісу - Не вимагає встановлення
Налаштування для OS X
1. Спочатку перевіримо версію твоєї операційної ситеми.
Клікни на меню та вибери About this Mac.
2. У вікні ти побачиш інформацію про версію твоєї ОS.
Якщо номер версії починається з 10.6, 10.7, 10.8, 10.9, 10.10, 10.11 чи 10.12 - ця інструкція для тебе.
3a. Для версій OS X 10.9 та вище:
Якщо в тебе версія 10.9, 10.10, 10.11 чи 10.12, тобі необхідно встановити homebrew та rbenv
3a1. Встанови Command line tools:
xcode-select --install
3a2. Встанови Homebrew:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
3a3. Встанови rbenv:
brew update
brew install rbenv
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
source ~/.bash_profile
3a4. Встанови Ruby із rbenv:
Найновішу версію ruby ти можеш знайти за допомогою команди “rbenv install -l”.
rbenv install 2.4.2
Якщо у тебе з’явилась помилка “OpenSSL::SSL::SSLError: … : certificate verify failed” спробуй:
brew install curl-ca-bundle
cp /usr/local/opt/curl-ca-bundle/share/ca-bundle.crt `ruby -ropenssl -e 'puts OpenSSL::X509::DEFAULT_CERT_FILE'`
3a5. Встановка Ruby за замовчуванням
rbenv global 2.4.2
3a6. Встановлюємо Rails:
gem install rails --no-document
3b. Якщо у тебе OS X версії 10.6, 10.7, or 10.8:
Завантаж RailsInstaller для своєї версії OS X:
- RailsInstaller for 10.7 and 10.8 (325MB)
- RailsInstaller for 10.6 (224MB)
Двічі клікни на завантажений файл і він встановиться у поточну директорію. Відкрий розархівований файл RailsInstaller-1.0.4-osx-10.7.app
або RailsInstaller-1.0.4-osx-10.6.app
і слідуй інструкції по встаноленню. Відкриється нове вікно з README файлом з ‘Rails Installer OS X’. Будь ласка, не виконуй інструкції у цьому файлі.
Якщо версія Rails не була найновішою, ти можеш просто оновити її набравши у терміналі:
gem update rails --no-document
4. Встановимо текстовий редактор
Для воркшопу ми рекомендуємо текстовий редактор Atom.
Якщо ти використовуєш Mac OS X 10.7 чи старішу версію, ти можеш використати інший текстовий редактор Sublime Text 2.
5. Оновлення веб оглядача
Відкрий whatbrowser.org та онови свій веб браузер, якщо в тебе не остання версія.
6. Перевірка середовища
Для того, щоб переконатись, що все працює - запустимо команду сторення додатку
rails new myapp
cd myapp
rails server
Відкрий http://localhost:3000
у своєму браузері. Ти повинна побачити сторінку ‘Yay! You’re on Rails!’.
Це все! Тепер в тебе є все необхідне для створення свого першого додатку на Ruby on Rails ;)
Ментори: Рекомендуємо згенерувати scaffold та перевірити чи все працює.
Налаштування для Windows
1. Встановлюємо Rails
Завантаж RailsInstaller та запусти, вибираючи опції по замовчуванню (просто клiкай OK, Next)
1a. Активуємо функцію копіювання та вставки у Windows консолі
Для користувачів Windows 10:
Відкрий Command Prompt with Ruby and Rails
.
Клікни правою кнопкою мишки на рядок заголовку командного рядка та обери “Опції” (“Properties”)
далі перейди до вкладки “Експерименти” (“experimental”) та обери “Активувати нові клавіатурні скорочення Ctrl” (“Enable new Ctrl key shortcuts”)
Для інших версій Windows:
Щоб вставити текст у командний рядок тобі потрібно використати мишку (правий клік у вікні –> вставити)
1b. Встановлюємо Rails
У Командному рядку із Ruby and Rails
, виконай наступні команди:
rails -v
Якщо побачила наступне повідомлення:
the system cannot find the path specified
Це може статись, якщо встановлювач не може коректно встановити шляхи для Rails. Нічого серйозного, ми можемо це вирішити різними способами, але найлегший, це встановити вручну Rails gem за допомогою наступної команди:
gem install rails bundler --no-document
Це встановить Rails правильно. Виконай:
rails -v
Дана команда повинна вивести поточну встановлену версію Rails (твої версії можуть бути різні):
Rails 5.2.2
Якщо версія Rails менша за 5.2, онови його за допомогою наступної команди:
gem update rails --no-document
Можливі помилки
Error loading the ‘sqlite3’
Якщо при запуску rails server
виникає ця помилка:
Puma caught this error: Error loading the 'sqlite3' Active Record adapter. Missing a gem it depends on? can't activate sqlite3 (~> 1.3.6), already activated sqlite3-1.4.0. Make sure all dependencies are added to Gemfile. (LoadError)
В файлі Gemfile змiни gem 'sqlite3'
на gem 'sqlite3', '~> 1.3.6'
та знову запусти bundle install
.
Gem::RemoteFetcher error
Якщо при запуску rails new railsgirls
чи gem update rails
виникає ця помилка:
Gem::RemoteFetcher::FetchError: SSL_connect returned=1 errno=0 state=SSLv3 read
server certificate B: certificate verify failed (https://rubygems.org/gems/i18n-0.6.11.gem)
Це означає, що в тебе старіша версія Rubygems і необхідно вручну оновити її вказуючи версію Rubygems
gem -v
Якщо вона менша за 2.6.5
ти повинна оновити їх вручну:
Спочатку завантаж ruby-gems-update gem. Перемісти
файл до c:\\rubygems-update-2.6.11.gem
а потім виконай:
gem install --local c:\\rubygems-update-2.6.11.gem
update_rubygems --no-document
gem uninstall rubygems-update -x
Перевіримо версію rubygems
gem -v
Переконайнся що вона рівна або більша за 2.6.11
. Виконай команду ще раз, якщо попередній раз
був неуспішним.
Якщо в тебе далi проблеми, завжди можна завантажити останню версію rubygems на rubygems.org. Клікнеш на GEM та отримаєш останню версію.
Протягом bundle install
Gem::RemoteFetcher::FetchError: SSL_connect
також може виникати протягом bundle install
при створенні нового Rails додатку.
Ця помилка згадана тут bit.ly/ruby-ssl. Для Windows користувачів актуальна інструкція this GitHub gist. Вона перевірена та успішно вирішуєш bundle install
помилку.
‘x64_mingw’ is not a valid platform` Помилка
Інколи при запуску rails server
виникає помилка:
'x64_mingw' is not a valid platform
Тоді необхідно трохи відредагувати Gemfile
:
Подивись в кінець файлу. Ти побачиш схожі рядки:
gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw]
. Якщо у тебе є рядок з :x64_mingw
,тоді видали :x64_mingw
Вкінці повиннен бути лише рядок:
'tzinfo-data', platforms: [:mingw, :mswin]
Після змін введи в командному рядку bundle update
.
2. Встановлюємо текстовий редактор
Для цього воркшопу ми рекомендуємо текстовий редактор Atom.
- Download Atom and install it
- Завантажимо архів atom zip для windows та розархівуємо його.
- Скопіюємо директорію у Program Files.
- Запускаємо atom у директорії
Якщо ви використовуєте Windows Vista чи старіші версії, ви можете використати інший редактор Sublime Text 2.
3. Онови свій браузер
Відкрий whatbrowser.org та онови свій браузер, якщо у тебе не остання версія.
4. Встановлення Node.js
- Перейди https://nodejs.org/ та встанови Node.js LTS package
- Перевідкрий свою Rails Command Shell
Перевір версію node
node --version
Впевнись, що вона виводить номер версії.
5. Перевірка середовища
Для того, щоб переконатись, що все працює запустимо команду сторення додатку
rails new myapp
cd myapp
rails server
Відкрий http://localhost:3000
у своєму веб оглядачі. Ти повинна побачити сторінку ‘Yay! You’re on Rails!’.
Це все! Тепер у тебе все необхідне для створення свого першого додатку на Ruby on Rails ;)
Ментори: Рекомендуємо згенерувати scaffold та перевірити чи все працює.
Налаштування для Linux
1. Встановлення Rails
Для того, щоб встановити Ruby on Rails необхідно просто скопіювати команду для твого дистрибутива Linux (Ubuntu чи Fedora), вставити команду у термінал та, набравшись терпіння, спостерігати, як пролітають команди на моніторі.
Для Ubuntu:
sudo apt-get install curl
bash < <(curl -sL https://raw.github.com/railsgirls/installation-scripts/master/rails-install-ubuntu.sh)
Якщо ти будеш використовувати RVM установку з gnome-terminal, то тут ти можеш знайти додаткову інформацію: RVM documentation.
For Fedora:
bash < <(curl -sL https://raw.github.com/railsgirls/installation-scripts/master/rails-install-fedora.sh)
Make sure that all works well by running the application generator command.
rails new myapp
2. Встановлення текстового редактора
Для воркшопу ми рекомендуємо текстовий редактор Atom.
3. Оновлення браузера
Відкрий whatbrowser.org та онови свій браузер, якщо у тебе не остання версія.
4. Перевірка середовища
Для того, щоб переконатись, що все працює запустимо команду сторення додатку
rails new myapp
cd myapp
rails server
Відкрий http://localhost:3000
у своєму веб оглядачі. Ти повинна побачити сторінку ‘Yay! You’re on Rails!’.
Це все! Тепер у тебе все необхідне для створення свого першого додатку на Ruby on Rails ;)
Ментори: Рекомендуємо згенерувати scaffold та перевірити чи все працює.
Віртуальна машина
Замість встановлення всіх програм на свій ноутбук - можна встановити середовище програмування на віртуальній машині. Тут детальніше про налаштування віртуального середовища: Virtual machine.
Використання Хмарного Сервісу
Замість встановлення Ruby on Rails та редактору на свій комп’ютер, ти можеш використати веб-сервіс для розробки. Все, що тобі потрібно - це браузер та інтернет з’єднання. Ця інструкція пояснює як почати роботу із codenvy.io. Якщо ти використовуєш інший сервіс - нічого страшного, загалом процес однаковий.
1. Онови свій браузер
Якщо ти використовуєш Internet Explorer, ми рекомендуємо встановити Firefox чи Google Chrome.
Відкрий whatbrowser.org та онови свій браузер, якщо у тебе не остання версія.
2. Створи аккаунт
Перейди codenvy.io та зареєструйся безкоштовно.
3. Налаштування робочого середовища Ruby on Rails
Робоче середовище для Ruby on Rails має все, що потрібно для воркшопу. Щоб його створити, залогуйся на codenvy.io, перейди на ‘Dashboard’ та клікни на “Create workspace”.
На сторінці “New workspace”:
- Обери ім’я для проекту (наприклад railsgirls)
- У вкладці “Select stack” знайди Rails та обери його (клікни)
- Клікни кнопку “Create”
Після цього запуститься процес створення робочого середовища (може тривати декілька хвилин). Після закінчення робоче середовище автоматично відкриється.
4. Кодінг на твому проекті
- Зліва, ти знайдеш файловий менеджер, за допомогою нього ти зможеш переглядати папки та файли.
- Посередині, ти знайдеш редактор, в якому будеш модифікувати та створювати файли.
- Внизу є термінал, де ти можеш виконувати команди.
- Все, що тобі потрібно - є у вікні твого браузера. Не потрібно запускати редактор чи термінал (командний рядок) деінде.
- Під час роботи над проектом використовуй інструкції для Linux, навіть якщо ти на Windows машині - твоя операційна система у даному випадку немає значення, оскільки всі твої команди виконуються у хмарі, що використовує Linux.
- Якщо посібник просить тебе виконати команду, що містить
rails
чиrake
- додай до нихbundle exec
, тобтоbundle exec rails db:migrate
. Вийняток - командаrails new
, яка не потребує додавання. - Якщо посібник просить тебе запустити rails server із
rails server
чиrails s
, додай-b 0.0.0.0
до цієї команди (bundle exec rails server -b 0.0.0.0
) -
Якщо посібник просить тебе запустити браузер, наприклад
http://localhost:3000
, слідуй наступним інструкціям:- Клікни на вкладку “Commands”
- Клікни два рази на “run”
- У полі “Command Line” введи наступне
cd ${current.project.path} && bundle exec rails s -b 0.0.0.0
- У розділі “Apply to” перемкни вимикач у положення “YES” навпроти назви проекту
- Клікни “save”
- Клікни “run”
- У терміналі відкриється окрема вкладка із заголовком “run”, скопіюй лінку, що йде одразу після preview. Саме по ній буде доступний твій проект у браузері.
5. Перезевантаження робочого середовища
- Якщо ти довго не використовувала робоче середовише, воно може вимкнутися через неактивність. Ти помітиш порожнє коло біля назви робочого середовища.
- У цьому випадку клікни на назву середовища - це запустить процес рестарту середовища (може зайняти деякий час). Після запуску робоче серидовище автоматично відкриється.
- Після перезапуску середовища, тобі знову потрібно виконати команду
bundle
у робочій папці Rails проекту.