Hur man installerar och konfigurerar Ruby med Rbenv, Rails, MariaDB, Nginx, SSL och Passenger på Ubuntu 17.04

Ruby on Rails är ett populärt webbramverk för Ruby som utvecklades för att öka en programmerares produktivitet. Men att få olika ädelstenar och beroenden att fungera tillsammans kan ibland bli svårt. Den här guiden hjälper dig att sätta upp en komplett produktionsklar Rails-miljö inklusive vanliga ädelstenar och beroenden.

Krav

• Vultr-instans med minst 512 MB RAM (1024 MB föredras).
• Vultr-instans som kör Ubuntu 17.04.

Stack som används i denna guide

• Nginx : en snabb och kraftfull webbserver. (ver 1.10.3)
• Passenger : en appserver som hjälper Nginx att servera din Ruby-app. (ver 1.5.1.8)
• Rbenv : en Ruby-versionshanterare. (ver 1.1.1-2)
• Ruby : (ver 2.4.1)
• MariaDB : en öppen källkodsgren av MySQL-servern (ver 10.2)
• SSL- certifikat från Let's Encrypt

Installation

Lägg till Sudo-användare

Obs : Det rekommenderas starkt att inte installera någon av dessa tjänster som root, eftersom du kan utsätta dig själv för en attack. Att konfigurera en deployeller appanvändare är en vanlig konvention:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Uppdatera och uppgradera systemet

Se till att du kör alla de senaste paketen på din Ubuntu VM:

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

Installera Build System

För att kunna kompilera Ruby med rbenv och andra ädelstenar måste olika paket installeras. Beroende på vilken version av Ruby du behöver, kanske vissa av paketen inte behövs.

Sammanställning

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

Paket för SSL-stöd

Dessa är nödvändiga för att sammanställa flera ädelstenar, såsom Passenger:

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

Versionering

Ruby-communityt använder Git som en valfri SCM; men ytterligare sådana, som Mercurial eller Subversion, kan också installeras:

sudo apt-get install -y git git-core

Databasdrivrutiner för MySQL / MariaDB

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

Nokogiri

Krävs för flera populära ädelstenar som behöver inbyggda XML-libs:

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

Node.js

Lägg till officiella arkiv från Node med den senaste versionen som standard Ubuntu-arkiv tenderar att släpa efter några större versioner:

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

Valfria paket

Dessa paket krävs inte för att systemet ska fungera, men är bra att ha om du behöver använda vissa ädelstenar.

Grafer och bilder

Dessa bibliotek är inte nödvändiga och kan hoppas över om du inte planerar att använda ädelstenar för bildmanipulering; som Rmagick:

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

Databasdrivrutiner för SQLite och PostgreSQL

Installera drivrutiner för SQLite eller PostgreSQL om du behöver ansluta till andra databaser eller föredrar en enkel, lokal DB:

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

Verktyg

Verktyg som normalt inte kommer förinstallerade på en ny Ubuntu-installation. Installera gärna din textredigerare:

sudo apt-get install -y iotop htop nano vim

Installera MariaDB-servern

MariaDB är en kraftfull relationell SQL-server, som är helt kompatibel med MySQL. Det enklaste sättet att installera den senaste versionen av MariaDB är att använda officiella arkiv:

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

Följ anvisningarna och ställ in ett root-lösenord. Kontrollera sedan att du kan komma åt din nya installation:

mysql -V 

Det kommer att visa en rad som liknar denna:

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

Logga in i MySQL-skalet:

mysql -h localhost -u root -p 

Obs : använd för \qatt avsluta.

Installera Rbenv och Ruby

Rbenv

Installera Rbenv med git. Detta är den enklaste installationsmetoden, och den möjliggör enkla uppdateringar senare. Installera också ruby-build, det är ansvarigt för att faktiskt kompilera olika versioner av Ruby:

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

Obs : När du behöver uppdatera enkelt cd ~/.rbenvoch git pull.

Gör Rbenv och Ruby-build tillgängliga i skalet. För att säkerställa att exportraderna infogas i början av .bashrcfilen, vilket är viktigt för icke-interaktiva bash-kommandon, använd dessa rader:

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

Kontrollera om Rbenv och Ruby-build är installerade och finns tillgängliga i skal:

rbenv install --list

Om det rbenvinte känns igen, logga ut och logga in i skalet igen.

Skapa en ~/.bash_profilefil och peka den till din ~/.bashrcfilkälla. Om du behöver köra några icke-interaktiva skalkommandon från din Rails-app, såsom cron-jobb som ställs in av wheneverädelstenen, kommer den att använda samma version av Ruby som ditt interaktiva skal. Detta kan hjälpa till att förhindra konstiga fel. Lägg till denna rad i ~/.bash_profilefilen:

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

Rubin

Installera Ruby 2.4.1:

rbenv install 2.4.1

Obs! Den här processen kan ta 5-15 minuter beroende på resurserna på din virtuella dator, och det finns ingen förloppsindikator.

Gör Rbenv tillgängligt överallt.

rbenv global 2.4.1

Passagerare och Nginx

Lägg till PGP-nyckeln och HTTPS-stöd för 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

Lägg till passagerarförrådet:

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

Installera Passenger + Nginx-modulerna:

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

Besök din Vultr-instans med dess domännamn eller IP för att testa dessa vid denna tidpunkt. Om de fungerar kommer din sida att visa den förinställda Nginx-välkomstsidan.

Ställ in Rails, appen och konfigurera passagerare

Installera Bundler och Rails:

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

Ubuntu/Debian-konventionen är att ställa in din app i /var/www. Som standard är det bara skrivbart med root. För att inställningen ska fungera, ge sudo-användaren äganderätt deploy:

sudo chown deploy:deploy /var/www -R

Generera rails-appen i /var/www/. Om du redan har en app som du vill distribuera, git clonekör den här och sedan bundle:

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

Konfigurera Passenger för att peka på appen.

1. Förbered Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Ändra användare till deploy.

   user deploy;
   

3. I httpavsnittet av konfigurationen bör det finnas en rad som talar om för Nginx att ladda moduler inklusive passagerare. Om det saknas kan du lägga till det direkt efter Virtual Host Configstiteln, men före sites-enabled.

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

4. Redigera/skapa passenger.conffilen.

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

5. Säg till Passenger att använda vår Rbenv-installation. Den kan innehålla en linje som pekar på Ruby-versionen som ingår i Passenger, bara ta bort eller kommentera den.

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

6. Ställ in virtuell värd för att peka på appen i /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. Starta om Nginx.

   sudo service nginx restart
   

Vid det här laget är din applikation redo att användas i utvecklingsläge. För att byta till produktionsläge måste du gå tillbaka till din Nginx-konfiguration och ändra rails_envinställningen till production.

Innan du byter till produktionsläge måste du fortfarande ställa in din produktionsdatabas example_production, database.ymloch hemliga nyckel. Kolla in ett verktyg som Capistrano eller Mina för att påskynda din applikationsdistribution. Det är en god praxis att använda ENV-variabler med en ädelsten som dotenv, och lägg inte dina lösenord, hemliga nycklar och sådant till ditt git-förråd.

Ställ in SSL

Det finns flera tjänster där ute som erbjuder SSL-certifikat för din domän, många är betalda och ett par är gratis. Ställ in SSL oavsett vilken tjänst du använder. Let's Encrypt är väldigt enkelt och gratis att använda. Let's Encrypt är en ideell organisation som backas upp av många teknikjättar.

Installation

Kör följande kommandon och följ anvisningarna.

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

Om du går till din Vultr-instans nu med HTTPS, kommer du att se en säker webbplats.

Förnyelse

Ditt nyligen utfärdade certifikat upphör att gälla och kommer att behöva förnyas med jämna mellanrum. Det enklaste sättet att göra detta är att skapa ett cron-jobb.

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

Som ett sista, men valfritt steg, starta om din virtuella dator och se till att alla tjänster startar om som förväntat.