Встановлення необхідних програм для Rails Girls

Переклад українською - Denys Kurets, @denys281

Редагування та оновлення - Aleksandra Klochko, @aleksacastle та Sofiia Kolisnyk

Для створення додатків на Ruby On Rails необхідно встановити деякі програми на твій комп’ютер.

Обери інструкцію, що підходить для твоєї операційної системи. Не панікуй, якщо виникнуть якісь проблеми: повідом нам, та ми вирішимо їх разом.


Налаштування для OS X

1. Спочатку перевіримо версію твоєї операційної ситеми.

Клікни на меню та вибери About this Mac.

Apple menu

2. У вікні ти побачиш інформацію про версію твоєї ОS.

Якщо номер версії починається з 10.6, 10.7, 10.8, 10.9, 10.10, 10.11 чи 10.12 - ця інструкція для тебе.

About this Mac dialog

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-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.

Якщо ви використовуєте Windows Vista чи старіші версії, ви можете використати інший редактор Sublime Text 2.

3. Онови свій браузер

Відкрий whatbrowser.org та онови свій браузер, якщо у тебе не остання версія.

4. Встановлення Node.js

Перевір версію 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”:

  1. Обери ім’я для проекту (наприклад railsgirls)
  2. У вкладці “Select stack” знайди Rails та обери його (клікни)
  3. Клікни кнопку “Create”

Після цього запуститься процес створення робочого середовища (може тривати декілька хвилин). Після закінчення робоче середовище автоматично відкриється.

4. Кодінг на твому проекті