Kako namestiti in konfigurirati Ruby z Rbenv, Rails, MariaDB, Nginx, SSL in Passenger na Ubuntu 17.04

Ruby on Rails je priljubljen spletni okvir za Ruby, ki je bil razvit za povečanje produktivnosti programerja. Vendar pa je včasih težko doseči, da bi različni dragulji in odvisnosti delovali skupaj. Ta vodnik vam bo pomagal nastaviti okolje Rails, ki je v celoti pripravljeno za proizvodnjo, vključno s pogosto uporabljenimi dragulji in odvisnostmi.

Zahteve

• Primerek Vultr z najmanj 512 MB RAM-a (zaželeno 1024 MB).
• Primerek Vultr, ki izvaja Ubuntu 17.04.

Sklad, uporabljen v tem priročniku

• Nginx : hiter in zmogljiv spletni strežnik. (različica 1.10.3)
• Passenger : strežnik aplikacij, ki bo Nginxu pomagal služiti vašo aplikacijo Ruby. (različica 1.5.1.8)
• Rbenv : upravitelj različic Ruby. (različica 1.1.1-2)
• Ruby : (različica 2.4.1)
• MariaDB : odprtokodna veja strežnika MySQL (ver 10.2)
• SSL certifikat podjetja Let's Encrypt

Namestitev

Dodajte uporabnika Sudo

Opomba : Zelo priporočljivo je, da nobene od teh storitev ne namestite kot root, saj se lahko izpostavite napadu. Nastavitev uporabnika deployali appuporabnika je običajen dogovor:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Posodobite in nadgradite sistem

Prepričajte se, da uporabljate vse najnovejše pakete na vašem Ubuntu VM:

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

Namestite Build System

Da bi lahko prevedli Ruby z uporabo rbenv in drugih draguljev, je treba namestiti različne pakete. Odvisno od različice Rubyja, ki jo boste potrebovali, nekateri paketi morda ne bodo potrebni.

Sestavljanje

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

Paketi za podporo SSL

Ti so potrebni za sestavljanje več draguljev, kot je Passenger:

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

Različice

Skupnost Ruby uporablja Git kot izbrani SCM; vendar je mogoče namestiti tudi dodatne, kot sta Mercurial ali Subversion:

sudo apt-get install -y git git-core

Gonilniki za bazo podatkov za MySQL / MariaDB

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

Nokogiri

Zahtevan za več priljubljenih draguljev, ki potrebujejo izvorne knjižnice XML:

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

Node.js

Dodajte uradna skladišča iz Node z najnovejšo različico, saj privzeta skladišča Ubuntu običajno zaostajajo za nekaj večjimi različicami:

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

Izbirni paketi

Ti paketi niso potrebni za delovanje sistema, vendar jih je dobro imeti, če morate uporabiti določene dragulje.

Grafi in slike

Te knjižnice niso potrebne in jih je mogoče preskočiti, razen če nameravate uporabiti dragulje za obdelavo slik; kot je Rmagick:

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

Gonilniki za bazo podatkov za SQLite in PostgreSQL

Namestite gonilnike za SQLite ali PostgreSQL, če se želite povezati z drugimi bazami podatkov ali raje preprosto, lokalno DB:

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

Orodja

Pripomočki, ki običajno niso vnaprej nameščeni pri novi namestitvi Ubuntuja. Namestite svoj urejevalnik besedil po izbiri:

sudo apt-get install -y iotop htop nano vim

Namestite strežnik MariaDB

MariaDB je močan relacijski strežnik SQL, ki je popolnoma združljiv z MySQL. Najlažji način za namestitev najnovejše različice MariaDB je uporaba uradnih repozitorijev:

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

Sledite navodilom in nastavite root geslo. Nato preverite, ali lahko dostopate do svoje sveže namestitve:

mysql -V 

Prikaže se vrstica, podobna tej:

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

Prijavite se v lupino MySQL:

mysql -h localhost -u root -p 

Opomba : uporabite \qza izhod.

Namestite Rbenv in Ruby

Rbenv

Namestite Rbenv s pomočjo git. To je najpreprostejši način namestitve, ki omogoča lažje kasnejše posodobitve. Prav tako install ruby-build, odgovoren je za dejansko prevajanje različnih različic Rubyja:

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

Opomba : Ko morate posodobiti preprosto cd ~/.rbenvin git pull.

Naj bosta Rbenv in Ruby-build na voljo v lupini. Da bi zagotovili, da se izvozne linije vstavi na začetku tega .bashrcspisa, ki je pomembna za ne-interaktivne ukaze bash, uporabite te vrstice:

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

Preverite, ali sta Rbenv in Ruby-build nameščena in sta na voljo v lupini:

rbenv install --list

Če rbenvni prepoznan, se odjavite in se znova prijavite v lupino.

Ustvarite ~/.bash_profiledatoteko in jo usmerite na izvor ~/.bashrcdatoteke. Če morate zagnati kakršne koli neinteraktivne ukaze lupine iz aplikacije Rails, kot je nastavitev delovnih mest cron z whenevergemom, bo ta uporabljal isto različico Rubyja kot vaša interaktivna lupina. To lahko pomaga preprečiti nenavadne napake. Dodajte to vrstico v ~/.bash_profiledatoteko:

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

Ruby

Namesti Ruby 2.4.1:

rbenv install 2.4.1

Opomba : ta postopek lahko traja 5-15 minut, odvisno od virov na vašem VM, in ni vrstice napredka.

Naj bo Rbenv na voljo povsod.

rbenv global 2.4.1

Passenger in Nginx

Dodajte ključ PGP in podporo HTTPS za 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

Dodajte skladišče Passenger:

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

Namestite module Passenger + Nginx:

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

Obiščite svoj primerek Vultr z uporabo njegovega imena domene ali IP-ja, da jih preizkusite na tej točki. Če delujejo, bo vaša stran prikazala privzeto pozdravno stran Nginx.

Setup Rails, App in Configure Passenger

Namesti Bundler in Rails:

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

Konvencija Ubuntu/Debian je, da svojo aplikacijo nastavite v /var/www. Privzeto je nanj mogoče zapisovati samo root. Da bo nastavitev delovala, dajte lastništvo uporabniku sudo deploy:

sudo chown deploy:deploy /var/www -R

Ustvarite aplikacijo rails v /var/www/. Če že imate aplikacijo, ki jo želite uvesti, git clonejo tukaj in nato zaženite bundle:

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

Konfigurirajte Passenger tako, da kaže na aplikacijo.

1. Pripravite Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Spremeni uporabnika v deploy.

   user deploy;
   

3. V httprazdelku konfiguracije mora biti vrstica, ki pove Nginxu, naj naloži module, vključno s potniki. Če manjka, ga lahko dodate takoj za Virtual Host Configsnaslovom, vendar pred sites-enabled.

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

4. Uredite/ustvarite passenger.confdatoteko.

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

5. Povejte potniku, naj uporabi našo nastavitev Rbenv. Lahko vsebuje vrstico, ki kaže na različico Ruby, ki je vključena v Passenger, samo jo izbrišite ali komentirajte.

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

6. Nastavite navideznega gostitelja, da kaže na aplikacijo 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. Znova zaženite Nginx.

   sudo service nginx restart
   

Na tej točki je vaša aplikacija pripravljena za uporabo v razvojnem načinu. Če želite preklopiti v produkcijski način, se morate vrniti na konfiguracijo Nginx in spremeniti rails_envnastavitev v production.

Preden se preklopi v način proizvodnje, boste še vedno morali setup svoje proizvodne baze podatkov example_production, database.ymlin skrivni ključ. Preverite orodje, kot sta Capistrano ali Mina, da pospešite postopek uvajanja aplikacije. Dobra praksa je, da uporabite spremenljivke ENV z draguljem, kot je dotenv, in ne objavljate svojih gesel, skrivnih ključev in podobnega v svoje skladišče git.

Nastavitev SSL

Obstaja več storitev, ki ponujajo SSL certifikate za vašo domeno, veliko jih je plačanih, nekaj pa brezplačnih. Nastavite SSL ne glede na to, katero storitev uporabljate. Let's Encrypt je zelo enostaven in brezplačen za uporabo. Let's Encrypt je neprofitna organizacija, ki jo podpirajo številni tehnološki velikani.

Namestitev

Zaženite naslednje ukaze in sledite pozivom.

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

Če zdaj obiščete svoj primerek Vultr z uporabo HTTPS, boste videli varno spletno mesto.

Obnova

Vaše novo izdano potrdilo bo poteklo in ga bo treba občasno obnavljati. Najlažji način za to je, da nastavite opravilo cron.

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

Kot zadnji, a neobvezen korak, znova zaženite svoj VM in se prepričajte, da se vse storitve znova zaženejo, kot je pričakovano.