Hvernig á að setja upp og stilla Ruby með Rbenv, Rails, MariaDB, Nginx, SSL og Passenger á Ubuntu 17.04

Ruby on Rails er vinsæl veframmi fyrir Ruby sem var þróaður til að auka framleiðni forritara. Hins vegar getur stundum verið erfitt að fá ýmsa gimsteina og ósjálfstæði til að vinna saman. Þessi handbók mun hjálpa þér að setja upp fullbúið Rails umhverfi sem er tilbúið til framleiðslu, þar á meðal algengt gimsteina og ósjálfstæði.

Kröfur

• Vultr tilvik með að minnsta kosti 512 MB af vinnsluminni (1024 MB æskilegt).
• Vultr tilvik sem keyrir Ubuntu 17.04.

Stafla notað í þessari handbók

• Nginx : fljótur og öflugur vefþjónn. (útgáfa 1.10.3)
• Passenger : appþjónn sem mun hjálpa Nginx að þjóna Ruby appinu þínu. (útgáfa 1.5.1.8)
• Rbenv : Ruby útgáfustjóri. (ver 1.1.1-2)
• Ruby : (útgáfa 2.4.1)
• MariaDB : opinn uppspretta útibú MySQL netþjóns (ver 10.2)
• SSL vottorð frá Let's Encrypt

Uppsetning

Bæta við Sudo notanda

Athugið : Það er mjög mælt með því að setja ekki upp neina af þessum þjónustum sem rót, þar sem þú gætir orðið fyrir árás. Að setja upp a deployeða appnotanda er algeng venja:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Uppfæra og uppfæra kerfi

Gakktu úr skugga um að þú sért að keyra alla nýjustu pakkana á Ubuntu VM þínum:

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

Settu upp byggingarkerfi

Til þess að geta sett saman Ruby með rbenv og öðrum gimsteinum þarf að setja upp ýmsa pakka. Það fer eftir útgáfunni af Ruby sem þú þarft, suma pakkana gæti verið óþörf.

Samantekt

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

Pakkar fyrir SSL stuðning

Þetta eru nauðsynlegar til að setja saman nokkra gimsteina, eins og farþega:

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

Útgáfa

Ruby samfélagið notar Git sem SCM að eigin vali; en fleiri, eins og Mercurial eða Subversion, er einnig hægt að setja upp:

sudo apt-get install -y git git-core

Gagnagrunnsrekla fyrir MySQL / MariaDB

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

Nokogiri

Nauðsynlegt fyrir nokkra vinsæla gimsteina sem þurfa innfædd XML libs:

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

Node.js

Bættu við opinberum geymslum frá Node með nýjustu útgáfunni þar sem sjálfgefnar Ubuntu geymslur hafa tilhneigingu til að vera á eftir nokkrum helstu útgáfum:

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

Valfrjálsir pakkar

Þessir pakkar eru ekki nauðsynlegir til að kerfið geti keyrt, en gott að hafa ef þú þarft að nota ákveðna gimsteina.

Gröf og myndir

Þessi bókasöfn eru ekki nauðsynleg og hægt er að sleppa þeim nema þú ætlir að nota myndvinnsluperlur; eins og Rmagick:

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

Gagnagrunnsrekla fyrir SQLite og PostgreSQL

Settu upp rekla fyrir SQLite eða PostgreSQL ef þú þarft að tengjast öðrum gagnagrunnum eða vilt frekar einfalda, staðbundna DB:

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

Verkfæri

Tól sem venjulega koma ekki fyrirfram uppsett á nýrri Ubuntu uppsetningu. Ekki hika við að setja upp textaritil að eigin vali:

sudo apt-get install -y iotop htop nano vim

Settu upp MariaDB netþjóninn

MariaDB er öflugur SQL-miðlari, sem er fullkomlega samhæfður MySQL. Auðveldasta leiðin til að setja upp nýjustu útgáfuna af MariaDB er að nota opinberar geymslur:

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

Fylgdu leiðbeiningunum og settu upp rótarlykilorð. Eftir það skaltu ganga úr skugga um að þú hafir aðgang að nýju uppsetningunni þinni:

mysql -V 

Það mun sýna línu svipað þessari:

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

Skráðu þig inn í MySQL skelina:

mysql -h localhost -u root -p 

Athugið : Notaðu \qtil að hætta.

Settu upp Rbenv og Ruby

Rbenv

Settu upp Rbenv með git. Þetta er einfaldasta uppsetningaraðferðin og hún gerir kleift að uppfæra auðveldar síðar. Settu líka upp ruby-build, það er ábyrgt fyrir því að setja saman mismunandi útgáfur af Ruby:

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

Athugið : Þegar þú þarft að uppfæra einfaldlega cd ~/.rbenvog git pull.

Gerðu Rbenv og Ruby-build aðgengilegar í skelinni. Til að tryggja að útflutningur línurnar fá bætist í upphafi á .bashrcskrá, sem er mikilvægt fyrir utan gagnvirka Bash stjórn, nota þessar línur:

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

Athugaðu hvort Rbenv og Ruby-build séu uppsett og fáanleg í skel:

rbenv install --list

Ef það rbenver ekki þekkt skaltu skrá þig út og aftur inn í skelina.

Búðu til ~/.bash_profileskrá og beindu henni að upprunaskránni þinni ~/.bashrc. Ef þú þarft að keyra einhverjar ógagnvirkar skel skipanir úr Rails appinu þínu, eins og uppsetning cron verka af whenevergemsanum, mun það nota sömu útgáfu af Ruby og gagnvirka skelin þín. Þetta getur komið í veg fyrir undarlegar villur. Bættu þessari línu við ~/.bash_profileskrána:

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

Rúbín

Settu upp Ruby 2.4.1:

rbenv install 2.4.1

Athugið : Þetta ferli getur tekið 5-15 mínútur eftir tilföngum á VM þínum og það er engin framvindustika.

Gerðu Rbenv aðgengilegt alls staðar.

rbenv global 2.4.1

Farþegi og Nginx

Bættu við PGP lyklinum og HTTPS stuðningi fyrir 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

Bættu við farþegageymslunni:

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

Settu upp Passenger + Nginx einingarnar:

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

Heimsæktu Vultr dæmið þitt með því að nota lén eða IP til að prófa þetta á þessum tímapunkti. Ef þeir eru að virka mun síðan þín sýna sjálfgefna Nginx velkomnasíðu.

Settu upp teina, appið og stilltu farþega

Settu upp Bundler og Rails:

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

Ubuntu/Debian venja er að setja upp appið þitt í /var/www. Sjálfgefið er það aðeins hægt að skrifa með rót. Til að uppsetningin virki, gefðu sudo notandanum eignarhald deploy:

sudo chown deploy:deploy /var/www -R

Búðu til rails appið í /var/www/. Ef þú ert nú þegar með app sem þú vilt nota, git cloneþá keyrir það hér og síðan bundle:

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

Stilltu farþega til að benda á appið.

1. Undirbúningur Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Breyta notanda í deploy.

   user deploy;
   

3. Í httphluta stillingarinnar ætti að vera lína sem segir Nginx að hlaða einingar þar á meðal farþega. Ef það vantar geturðu bætt því við rétt á eftir Virtual Host Configstitlinum en á undan sites-enabled.

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

4. Breyta/búa til passenger.confskrána.

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

5. Segðu farþega að nota Rbenv uppsetninguna okkar. Það gæti innihaldið línu sem vísar á Ruby útgáfuna sem fylgir með Passenger, eyddu því bara eða skrifaðu athugasemd.

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

6. Settu upp sýndarhýsil til að benda á appið í /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. Endurræstu Nginx.

   sudo service nginx restart
   

Á þessum tímapunkti er forritið þitt tilbúið til notkunar í þróunarham. Til að skipta yfir í framleiðsluham þarftu að fara aftur í Nginx stillingarnar þínar og breyta rails_envstillingunni í production.

Áður en þú skiptir yfir í framleiðslu háttur, enn þú þarft að setja framleiðslu gagnagrunninn example_production, database.ymlog leyndarmál lykill. Skoðaðu tól eins og Capistrano eða Mina til að flýta fyrir dreifingarferli forrita. Það er góð venja að nota ENV breytur með gimsteini eins og dotenv, og ekki binda lykilorðin þín, leynilykla og slíkt í git geymsluna þína.

Settu upp SSL

Það eru margar þjónustur þarna úti sem bjóða upp á SSL vottorð fyrir lénið þitt, margar eru greiddar og par eru ókeypis. Settu upp SSL, sama hvaða þjónustu þú notar. Let's Encrypt er mjög auðvelt og ókeypis í notkun. Let's Encrypt er sjálfseignarstofnun sem studd er af mörgum tæknirisum.

Uppsetning

Keyrðu eftirfarandi skipanir og fylgdu leiðbeiningunum.

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

Ef þú ferð í Vultr tilvikið þitt með því að nota núna HTTPSmuntu sjá örugga vefsíðu.

Endurnýjun

Nýútgefið vottorð þitt mun renna út og þarf að endurnýja það reglulega. Auðveldasta leiðin til að gera þetta er að setja upp cron starf.

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

Sem lokaskref en valfrjálst skaltu endurræsa VM þinn og ganga úr skugga um að öll þjónusta endurræsist eins og búist var við.