Com instal·lar i configurar Ruby amb Rbenv, Rails, MariaDB, Nginx, SSL i Passenger a Ubuntu 17.04

Ruby on Rails és un marc web popular per a Ruby que es va desenvolupar per augmentar la productivitat d'un programador. Tanmateix, aconseguir que diverses joies i dependències funcionin juntes de vegades pot resultar complicat. Aquesta guia us ajudarà a configurar un entorn de Rails complet preparat per a la producció, que inclou joies i dependències d'ús habitual.

Requisits

• Instància Vultr amb almenys 512 MB de RAM (preferiblement 1024 MB).
• Instància Vultr amb Ubuntu 17.04.

Pila utilitzada en aquesta guia

• Nginx : un servidor web ràpid i potent. (versió 1.10.3)
• Passenger : un servidor d'aplicacions que ajudarà a Nginx a servir la vostra aplicació Ruby. (versió 1.5.1.8)
• Rbenv : un gestor de versions de Ruby. (versió 1.1.1-2)
• Ruby : (versió 2.4.1)
• MariaDB : una branca de codi obert del servidor MySQL (versió 10.2)
• Certificat SSL de Let's Encrypt

Instal·lació

Afegeix un usuari Sudo

Nota : és molt recomanable no instal·lar cap d'aquests serveis com a root, ja que podríeu exposar-vos a un atac. Configurar un deployo appusuari és una convenció comuna:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Actualització i actualització del sistema

Assegureu-vos que esteu executant tots els paquets més recents a la vostra VM Ubuntu:

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

Instal·leu Build System

Per poder compilar Ruby amb rbenv i altres gemmes, cal instal·lar diversos paquets. Depenent de la versió de Ruby que necessiteu, alguns dels paquets poden no ser necessaris.

Compilant

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

Paquets per a suport SSL

Aquestes són necessàries per compilar diverses joies, com ara Passenger:

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

Versioning

La comunitat Ruby utilitza Git com a SCM preferit; però també es poden instal·lar d'altres, com Mercurial o Subversion:

sudo apt-get install -y git git-core

Controladors de base de dades per a MySQL / MariaDB

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

Nokogiri

Necessari per a diverses joies populars que necessiten biblioteques XML natives:

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

Node.js

Afegiu dipòsits oficials de Node amb l'última versió com a repositoris predeterminats d'Ubuntu tendeixen a quedar-se enrere d'algunes de les versions principals:

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

Paquets opcionals

Aquests paquets no són necessaris perquè el sistema funcioni, però és bo tenir-los si necessiteu utilitzar certes joies.

Gràfics i Imatges

Aquestes biblioteques no són necessàries i es poden ometre tret que tingueu previst utilitzar joies de manipulació d'imatges; com Rmagick:

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

Controladors de bases de dades per a SQLite i PostgreSQL

Instal·leu els controladors per a SQLite o PostgreSQL si necessiteu connectar-vos a altres bases de dades o preferiu una base de dades local senzilla:

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

Eines

Utilitats que normalment no vénen preinstal·lades en una instal·lació nova d'Ubuntu. No dubteu a instal·lar l'editor de text que vulgueu:

sudo apt-get install -y iotop htop nano vim

Instal·leu el servidor MariaDB

MariaDB és un potent servidor SQL relacional, totalment compatible amb MySQL. La manera més senzilla d'instal·lar la darrera versió de MariaDB és utilitzar repositoris oficials:

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

Seguiu les instruccions i configureu una contrasenya d'arrel. Després, verifiqueu que podeu accedir a la vostra instal·lació nova:

mysql -V 

Mostrarà una línia semblant a aquesta:

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

Inicieu sessió al shell de MySQL:

mysql -h localhost -u root -p 

Nota : utilitzar \qper sortir.

Instal·leu Rbenv i Ruby

Rbenv

Instal·leu Rbenv amb git. Aquest és el mètode d'instal·lació més senzill i permet actualitzacions fàcils més endavant. També instal·leu ruby-build, s'encarrega de compilar diferents versions de Ruby:

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

Nota : quan necessiteu actualitzar simplement cd ~/.rbenvi git pull.

Feu que Rbenv i Ruby-build estiguin disponibles al shell. Per assegurar-vos que les línies d'exportació s'insereixen al principi del .bashrcfitxer, cosa que és important per a les ordres bash no interactives, utilitzeu aquestes línies:

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

Comproveu si Rbenv i Ruby-build estan instal·lats i estan disponibles al shell:

rbenv install --list

Si rbenvno es reconeix, tanqueu la sessió i torneu a iniciar sessió al shell.

Creeu un ~/.bash_profilefitxer i apunteu-lo a l'origen del vostre ~/.bashrcfitxer. Si necessiteu executar ordres de l'intèrpret d'ordres no interactius des de la vostra aplicació Rails, com ara les tasques cron configurades per la whenevergemma, utilitzarà la mateixa versió de Ruby que la vostra intèrpret d'ordres interactiu. Això pot ajudar a prevenir errors estranys. Afegiu aquesta línia al ~/.bash_profilefitxer:

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

Rubí

Instal·leu Ruby 2.4.1:

rbenv install 2.4.1

Nota : aquest procés pot trigar entre 5 i 15 minuts, depenent dels recursos de la vostra màquina virtual, i no hi ha cap barra de progrés.

Feu que Rbenv estigui disponible a tot arreu.

rbenv global 2.4.1

Passatger i Nginx

Afegiu la clau PGP i el suport HTTPS per a 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

Afegiu el repositori de passatgers:

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

Instal·leu els mòduls Passenger + Nginx:

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

Visiteu la vostra instància Vultr utilitzant el seu nom de domini o IP per provar-los en aquest moment. Si funcionen, la vostra pàgina mostrarà la pàgina de benvinguda predeterminada de Nginx.

Configura Rails, l'aplicació i configura Passenger

Instal·leu Bundler i Rails:

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

La convenció d'Ubuntu/Debian és configurar la vostra aplicació a /var/www. Per defecte només es pot escriure per root. Perquè la configuració funcioni, doneu la propietat a l'usuari sudo deploy:

sudo chown deploy:deploy /var/www -R

Genereu l'aplicació rails a /var/www/. Si ja teniu una aplicació que voleu implementar, feu git clone-la aquí i executeu-la bundle:

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

Configura Passenger perquè apunti a l'aplicació.

1. Prepareu Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Canvia l'usuari a deploy.

   user deploy;
   

3. A la httpsecció de la configuració, hi hauria d'haver una línia que indiqui a Nginx que carregui mòduls, inclosos els passatgers. Si falta, podeu afegir-lo just després del Virtual Host Configstítol, però abans de sites-enabled.

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

4. Edita/crea el passenger.conffitxer.

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

5. Digueu al passatger que utilitzi la nostra configuració Rbenv. Pot contenir una línia que indiqui la versió de Ruby inclosa amb Passenger, només cal esborrar-la o comentar-la.

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

6. Configura l'amfitrió virtual per apuntar a l'aplicació en /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. Reinicieu Nginx.

   sudo service nginx restart
   

En aquest moment, la vostra aplicació està preparada per utilitzar-la en mode de desenvolupament. Per canviar al mode de producció, heu de tornar a la configuració de Nginx i canviar la rails_envconfiguració a production.

Abans de canviar a la manera de producció, encara haurà de configurar la seva base de dades de producció example_production, database.ymli la clau secreta. Consulteu una eina com Capistrano o Mina per accelerar el procés de desplegament de l'aplicació. És una bona pràctica utilitzar variables ENV amb una joia com dotenv, i no comprometre les vostres contrasenyes, claus secretes i altres al vostre repositori git.

Configura SSL

Hi ha diversos serveis que ofereixen certificats SSL per al vostre domini, molts són de pagament i un parell són gratuïts. Configureu SSL independentment del servei que utilitzeu. Let's Encrypt és molt fàcil i gratuït d'utilitzar. Let's Encrypt és una organització sense ànim de lucre recolzada per molts gegants tecnològics.

Instal·lació

Executeu les ordres següents i seguiu les indicacions.

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

Si aneu a la vostra instància Vultr ara amb HTTPS, veureu un lloc web segur.

Renovació

El vostre certificat recentment emès caducarà i s'haurà de renovar periòdicament. La manera més senzilla de fer-ho és configurar un treball cron.

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

Com a pas final, però opcional, reinicieu la vostra màquina virtual i assegureu-vos que tots els serveis es reinicien com s'esperava.