Ako nainštalovať a nakonfigurovať Ruby s Rbenv, Rails, MariaDB, Nginx, SSL a Passenger na Ubuntu 17.04

Ruby on Rails je populárny webový rámec pre Ruby, ktorý bol vyvinutý na zvýšenie produktivity programátora. Avšak dosiahnuť, aby rôzne drahokamy a závislosti spolupracovali, môže byť niekedy zložité. Táto príručka vám pomôže nastaviť úplné prostredie Rails pripravené na výrobu vrátane bežne používaných drahokamov a závislostí.

Požiadavky

• Inštancia Vultr s aspoň 512 MB RAM (preferuje sa 1024 MB).
• Inštancia Vultr so systémom Ubuntu 17.04.

Zásobník použitý v tejto príručke

• Nginx : rýchly a výkonný webový server. (ver 1.10.3)
• Passenger : aplikačný server, ktorý pomôže spoločnosti Nginx obsluhovať vašu aplikáciu Ruby. (ver 1.5.1.8)
• Rbenv : správca verzií Ruby. (ver 1.1.1-2)
• Ruby : (verzia 2.4.1)
• MariaDB : open source vetva servera MySQL (verzia 10.2)
• SSL certifikát od Let's Encrypt

Inštalácia

Pridať používateľa Sudo

Poznámka : Dôrazne sa odporúča neinštalovať žiadnu z týchto služieb ako root, pretože by ste sa mohli vystaviť útoku. Nastavenie používateľa deployalebo appje bežnou konvenciou:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Aktualizácia a aktualizácia systému

Uistite sa, že máte na svojom Ubuntu VM spustené všetky najnovšie balíčky:

sudo apt-get update && sudo apt-get upgrade -y

Nainštalujte zostavenie systému

Aby bolo možné zostaviť Ruby pomocou rbenv a iných drahokamov, je potrebné nainštalovať rôzne balíčky. V závislosti od verzie Ruby, ktorú budete potrebovať, niektoré balíčky nemusia byť potrebné.

Zostavovanie

sudo apt-get install -y curl zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev
sudo apt-get install -y libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev
sudo apt-get install -y python-software-properties libffi-dev
sudo apt-get install -y build-essential openssl libreadline6 libreadline6-dev libreadline-dev
sudo apt-get install -y automake libtool bison pkg-config bison autoconf libc6-dev ncurses-dev
sudo apt-get install -y libapr1-dev libaprutil1-dev libx11-dev libffi-dev tcl-dev tk-dev

Balíky pre podporu SSL

Tie sú potrebné na zostavenie niekoľkých skvostov, ako napríklad Passenger:

sudo apt-get install -y zlib1g zlib1g-dev libssl-dev libyaml-dev libcurl4-openssl-dev libruby

Verziovanie

Ruby komunita používa Git ako SCM podľa vlastného výberu; ale je možné nainštalovať aj ďalšie, napríklad Mercurial alebo Subversion:

sudo apt-get install -y git git-core

Databázové ovládače pre MySQL / MariaDB

sudo apt-get install -y libmysqld-dev mysql-client libmysqlclient-dev

Nokogiri

Vyžaduje sa pre niekoľko populárnych drahokamov, ktoré potrebujú natívne knižnice XML:

sudo apt-get install -y libxml2-dev libxslt-dev

Node.js

Pridajte oficiálne úložiská z Node s najnovšou verziou, pretože predvolené úložiská Ubuntu majú tendenciu zaostávať za niekoľkými hlavnými verziami:

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs

Voliteľné balíčky

Tieto balíčky nie sú potrebné na spustenie systému, ale je dobré ich mať, ak potrebujete použiť určité skvosty.

Grafy a obrázky

Tieto knižnice nie sú potrebné a možno ich preskočiť, pokiaľ neplánujete používať drahokamy na manipuláciu s obrázkami; ako napríklad Rmagick:

sudo apt-get install -y imagemagick libmagickwand-dev libvips-dev

Databázové ovládače pre SQLite a PostgreSQL

Nainštalujte ovládače pre SQLite alebo PostgreSQL, ak sa potrebujete pripojiť k iným databázam alebo uprednostňujete jednoduchú lokálnu DB:

sudo apt-get install -y libsqlite3-dev sqlite3  libpq-dev postgresql postgresql-contrib

Nástroje

Pomôcky, ktoré zvyčajne nie sú predinštalované v novej inštalácii Ubuntu. Neváhajte a nainštalujte si textový editor podľa vlastného výberu:

sudo apt-get install -y iotop htop nano vim

Nainštalujte server MariaDB

MariaDB je výkonný relačný SQL server, ktorý je plne kompatibilný s MySQL. Najjednoduchší spôsob inštalácie najnovšej verzie MariaDB je pomocou oficiálnych úložísk:

sudo apt-get install software-properties-common
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386] http://ftp.utexas.edu/mariadb/repo/10.2/ubuntu zesty main'
sudo apt update
sudo apt install -y mariadb-server

Postupujte podľa pokynov a nastavte heslo používateľa root. Potom skontrolujte, či máte prístup k svojej čerstvej inštalácii:

mysql -V 

Zobrazí sa riadok podobný tomuto:

mysql  Ver 15.1 Distrib 10.2.8-MariaDB, for debian-linux-gnu (x86_64) using readline 5

Prihláste sa do shellu MySQL:

mysql -h localhost -u root -p 

Poznámka : použite \qna ukončenie.

Nainštalujte Rbenv a Ruby

Rbenv

Nainštalujte Rbenv pomocou git. Toto je najjednoduchší spôsob inštalácie a umožňuje neskoršie jednoduché aktualizácie. Nainštalujte si tiež ruby-build, je zodpovedný za skutočnú kompiláciu rôznych verzií Ruby:

cd
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

Poznámka : Keď potrebujete aktualizovať jednoducho cd ~/.rbenva git pull.

Sprístupnite Rbenv a Ruby-build v shelli. Aby bolo zaistené, že vývozné linky dostať vložená na začiatku tohto .bashrcsúboru, ktorý je dôležitý pre Neinteraktívne príkazov bash, použite tieto riadky:

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.temp_bashrc
echo 'eval "$(rbenv init -)"' >> ~/.temp_bashrc
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.temp_bashrc

cat ~/.temp_bashrc ~/.bashrc > ~/.combined_bashrc && mv ~/.combined_bashrc ~/.bashrc && rm ~/.temp_bashrc

exec $SHELL

Skontrolujte, či sú Rbenv a Ruby-build nainštalované a či sú dostupné v prostredí shell:

rbenv install --list

Ak rbenvnie je rozpoznaný, odhláste sa a prihláste sa späť do shellu.

Vytvorte ~/.bash_profilesúbor a nasmerujte ho na zdroj vášho ~/.bashrcsúboru. Ak potrebujete spustiť akékoľvek neinteraktívne príkazy shellu z vašej aplikácie Rails, ako napríklad úlohy cron nastavené wheneverdrahokamom, použije rovnakú verziu Ruby ako váš interaktívny shell. To môže pomôcť zabrániť zvláštnym chybám. Pridajte tento riadok do ~/.bash_profilesúboru:

if [ -f $HOME/.bashrc ]; then
        source $HOME/.bashrc
fi

Ruby

Nainštalujte Ruby 2.4.1:

rbenv install 2.4.1

Note: This process may take 5-15 minutes depending on the resources on your VM, and there is no progress bar.

Make Rbenv available everywhere.

rbenv global 2.4.1

Passenger and Nginx

Add the PGP key and HTTPS support for apt:

sudo apt-get install -y dirmngr gnupg
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 561F9B9CAC40B2F7
sudo apt-get install -y apt-transport-https ca-certificates

Add the Passenger repository:

sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger zesty main > /etc/apt/sources.list.d/passenger.list'
sudo apt-get update

Install the Passenger + Nginx modules:

sudo apt-get install -y nginx
sudo apt-get install -y libnginx-mod-http-passenger

Visit your Vultr instance using it's domain name or IP to test these at this point. If they're working, your page will show the default Nginx welcome page.

Setup Rails, the App, and Configure Passenger

Install Bundler and Rails:

gem install bundler rails --no-ri --no-rdoc

Ubuntu/Debian convention is to setup your app in /var/www. By default it is only writable by root. For the setup to work, give ownership to the sudo user deploy:

sudo chown deploy:deploy /var/www -R

Generate the rails app in /var/www/ . If you already have an app you want to deploy, git clone it here and then run bundle:

cd /var/www
rails new example --database=mysql

Nakonfigurujte Passenger tak, aby ukazoval na aplikáciu.

1. Príprava Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Zmeniť používateľa na deploy.

   user deploy;
   

3. V httpsekcii konfigurácie by mal byť riadok, ktorý povie Nginxu, aby načítal moduly vrátane pasažierov. Ak chýba, môžete ho pridať hneď za Virtual Host Configsnadpis, ale pred sites-enabled.

   include /etc/nginx/conf.d/*.conf;
   

4. Upravte/vytvorte passenger.confsúbor.

   sudo nano /etc/nginx/conf.d/mod-http-passenger.conf
   

5. Povedzte cestujúcemu, aby použil naše nastavenie Rbenv. Môže obsahovať riadok ukazujúci na verziu Ruby, ktorá je súčasťou aplikácie Passenger, stačí ju vymazať alebo komentovať.

   passenger_ruby /home/deploy/.rbenv/shims/ruby;
   passenger_root /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini;
   

6. Nastavte virtuálneho hostiteľa tak, aby ukazoval na aplikáciu v /var/www/example/.

   sudo nano /etc/nginx/sites-enabled/example.conf
   
   
   server {
     listen 80;
     server_name example.com www.example.com;
     root /var/www/example/public;
     passenger_enabled on;
   
     # When you are ready to switch to production mode - change this to `production`
     passenger_app_env development; # <-- !important      
   }
   

7. Reštartujte Nginx.

   sudo service nginx restart
   

V tomto bode je vaša aplikácia pripravená na použitie vo vývojovom režime. Ak chcete prejsť do výrobného režimu, musíte sa vrátiť do konfigurácie Nginx a zmeniť rails_envnastavenie na production.

Predtým, než sa prepnete do režimu výroby, stále budete musieť nastaviť svoj produkčnej databázy example_production, database.ymla tajný kľúč. Vyskúšajte nástroj ako Capistrano alebo Mina na urýchlenie procesu nasadzovania aplikácií. Je dobrým zvykom používať premenné ENV s drahokamom ako dotenv, a neodovzdávať svoje heslá, tajné kľúče a podobne do svojho úložiska git.

Nastavte SSL

Existuje viacero služieb, ktoré ponúkajú certifikáty SSL pre vašu doménu, mnohé z nich sú platené a niektoré sú zadarmo. Nastavte SSL bez ohľadu na to, akú službu používate. Let's Encrypt je veľmi jednoduché a bezplatné použitie. Let's Encrypt je nezisková organizácia podporovaná mnohými technologickými gigantmi.

Inštalácia

Spustite nasledujúce príkazy a postupujte podľa pokynov.

sudo apt-get update
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:certbot/certbot
sudo apt-get update
sudo apt-get install python-certbot-nginx
sudo certbot --nginx
sudo certbot renew --dry-run

Ak teraz prejdete do svojej inštancie Vultr pomocou HTTPS, uvidíte zabezpečenú webovú stránku.

Obnova

Platnosť vášho novo vydaného certifikátu vyprší a bude potrebné ho pravidelne obnovovať. Najjednoduchší spôsob, ako to urobiť, je nastaviť úlohu cron.

sudo crontab -e 
30 2 * * 1 /usr/bin/certbot renew 

Ako posledný, ale voliteľný krok, reštartujte svoj VM a uistite sa, že sa všetky služby reštartujú podľa očakávania.