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

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

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


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

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

Натисни на меню та вибери About this Mac.

Apple menu

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

Якщо номер версії починається з 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 та запусти, вибираючи опції по замовчуванню (просто жми 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.1.1

Якщо версія Rails менша за 5.1, онови його за допомогою наступної команди:

gem update rails --no-document

Можливі помилки

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. Виконай команду ще раз, якщо попередній раз був неуспішним.

Якщо ти далі продовжуєш мати проблеми, завжди можна завантажити останню версію 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. Встановлення текстового редактора

Для воркшопу ми рекомендуємо текстовий редактор Sublime Text.

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. Кодінг на твому проекті