Sådan installeres og konfigureres Ruby med Rbenv, Rails, MariaDB, Nginx, SSL og Passenger på Ubuntu 17.04

Ruby on Rails er en populær webramme for Ruby, der blev udviklet for at øge en programmørs produktivitet. Det kan dog nogle gange blive svært at få forskellige ædelstene og afhængigheder til at fungere sammen. Denne vejledning hjælper dig med at opsætte et komplet produktionsklart Rails-miljø inklusive almindeligt brugte ædelstene og afhængigheder.

Krav

• Vultr-instans med mindst 512 MB RAM (1024 MB foretrækkes).
• Vultr-instans, der kører Ubuntu 17.04.

Stak brugt i denne vejledning

• Nginx : en hurtig og kraftfuld webserver. (ver 1.10.3)
• Passenger : en app-server, der hjælper Nginx med at betjene din Ruby-app. (ver 1.5.1.8)
• Rbenv : en Ruby version manager. (ver 1.1.1-2)
• Ruby : (ver 2.4.1)
• MariaDB : en open source-gren af ​​MySQL-serveren (ver 10.2)
• SSL- certifikat fra Let's Encrypt

Installation

Tilføj Sudo-bruger

Bemærk : Det anbefales stærkt ikke at installere nogen af ​​disse tjenester som root, da du kan udsætte dig selv for et angreb. Opsætning af en deployeller appbruger er en almindelig konvention:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Opdater og opgrader systemet

Sørg for, at du kører alle de nyeste pakker på din Ubuntu VM:

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

Installer Build System

For at kunne kompilere Ruby ved hjælp af rbenv og andre ædelstene, skal forskellige pakker installeres. Afhængigt af hvilken version af Ruby du skal bruge, er nogle af pakkerne muligvis ikke nødvendige.

Kompilere

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

Pakker til SSL-understøttelse

Disse er nødvendige for at kompilere flere ædelstene, såsom Passager:

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

Versionering

Ruby-fællesskabet bruger Git som en valgfri SCM; men yderligere, som Mercurial eller Subversion, kan også installeres:

sudo apt-get install -y git git-core

Databasedrivere til MySQL / MariaDB

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

Nokogiri

Påkrævet for flere populære ædelstene, der har brug for native XML-libs:

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

Node.js

Tilføj officielle depoter fra Node med den seneste version som standard Ubuntu-depoter har en tendens til at halte bagud et par større versioner:

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

Valgfri pakker

Disse pakker er ikke nødvendige for at systemet kan køre, men er gode at have, hvis du skal bruge bestemte ædelstene.

Grafer og billeder

Disse biblioteker er ikke nødvendige og kan springes over, medmindre du planlægger at bruge ædelstene til billedmanipulation; såsom Rmagick:

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

Databasedrivere til SQLite og PostgreSQL

Installer drivere til SQLite eller PostgreSQL, hvis du har brug for at oprette forbindelse til andre databaser eller foretrækker en simpel, lokal DB:

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

Værktøjer

Hjælpeprogrammer, der normalt ikke kommer forudinstalleret på en ny Ubuntu-installation. Du er velkommen til at installere din foretrukne teksteditor:

sudo apt-get install -y iotop htop nano vim

Installer MariaDB-serveren

MariaDB er en kraftfuld relationel SQL-server, der er fuldt kompatibel med MySQL. Den nemmeste måde at installere den seneste version af MariaDB på er at bruge officielle depoter:

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ølg vejledningen og opsæt en root-adgangskode. Bekræft derefter, at du kan få adgang til din nye installation:

mysql -V 

Det vil vise en linje, der ligner denne:

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

Log ind på MySQL-skallen:

mysql -h localhost -u root -p 

Bemærk : Brug \qtil at afslutte.

Installer Rbenv og Ruby

Rbenv

Installer Rbenv ved hjælp af git. Dette er den enkleste installationsmetode, og den giver mulighed for nemme opdateringer senere. Installer også ruby-build, det er ansvarligt for faktisk at kompilere forskellige versioner 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

Bemærk : Når du skal opdatere simpelthen cd ~/.rbenvog git pull.

Gør Rbenv og Ruby-build tilgængelige i skallen. For at sikre, at eksportlinjerne bliver indsat i begyndelsen af .bashrcfilen, hvilket er vigtigt for ikke-interaktive bash-kommandoer, skal du bruge disse linjer:

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

Tjek om Rbenv og Ruby-build er installeret og er tilgængelige i shell:

rbenv install --list

Hvis rbenvdet ikke genkendes, skal du logge ud og logge ind i skallen igen.

Opret en ~/.bash_profilefil og peg den til kilden til din ~/.bashrcfil. Hvis du har brug for at køre nogen ikke-interaktive shell-kommandoer fra din Rails-app, såsom cron-job, der er opsat af wheneverperlen, vil den bruge den samme version af Ruby som din interaktive shell. Dette kan hjælpe med at forhindre mærkelige fejl. Tilføj denne linje til ~/.bash_profilefilen:

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

Rubin

Installer Ruby 2.4.1:

rbenv install 2.4.1

Bemærk : Denne proces kan tage 5-15 minutter afhængigt af ressourcerne på din VM, og der er ingen statuslinje.

Gør Rbenv tilgængelig overalt.

rbenv global 2.4.1

Passager og Nginx

Tilføj PGP-nøglen og HTTPS-understøttelse 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

Tilføj passagerlageret:

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

Installer Passenger + Nginx-modulerne:

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

Besøg din Vultr-instans ved at bruge dets domænenavn eller IP for at teste disse på dette tidspunkt. Hvis de virker, vil din side vise standard Nginx velkomstside.

Opsæt skinner, appen og konfigurer passager

Installer Bundler og skinner:

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

Ubuntu/Debian-konventionen er at konfigurere din app i /var/www. Som standard kan den kun skrives med root. For at opsætningen skal fungere, skal du give ejerskab til sudo-brugeren deploy:

sudo chown deploy:deploy /var/www -R

Generer rails-appen i /var/www/. Hvis du allerede har en app, du vil implementere, git clonekører den her og derefter bundle:

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

Konfigurer Passager til at pege på appen.

1. Forbered Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Skift bruger til deploy.

   user deploy;
   

3. I httpsektionen af ​​konfigurationen skal der være en linje, der fortæller Nginx at indlæse moduler inklusive passager. Hvis det mangler, kan du tilføje det lige efter Virtual Host Configstitlen, men før sites-enabled.

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

4. Rediger/opret passenger.conffilen.

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

5. Fortæl Passenger at bruge vores Rbenv-opsætning. Den kan indeholde en linje, der peger på Ruby-versionen, der følger med Passenger, bare slet eller kommenter den.

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

6. Konfigurer virtuel vært til at pege 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. Genstart Nginx.

   sudo service nginx restart
   

På dette tidspunkt er din applikation klar til at blive brugt i udviklingstilstand. For at skifte til produktionstilstand skal du gå tilbage til din Nginx-konfiguration og ændre rails_envindstillingen til production.

Før du skifter til produktion tilstand, vil du stadig nødt til at sætte din produktion database example_production, database.ymlog hemmelig nøgle. Tjek et værktøj som Capistrano eller Mina for at fremskynde din applikationsimplementeringsproces. Det er en god praksis at bruge ENV-variabler med en perle som dotenv, og lad være med at overføre dine adgangskoder, hemmelige nøgler og lignende til dit git-lager.

Opsæt SSL

Der er flere tjenester derude, der tilbyder SSL-certifikater til dit domæne, mange er betalt og et par er gratis. Opsæt SSL uanset hvilken tjeneste du bruger. Let's Encrypt er meget nemt og gratis at bruge. Let's Encrypt er en non-profit organisation støttet af mange teknologigiganter.

Installation

Kør følgende kommandoer, og følg vejledningen.

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

Hvis du går til din Vultr-instans nu ved at bruge HTTPS, vil du se en sikker hjemmeside.

Fornyelse

Dit nyligt udstedte certifikat udløber og skal fornys med jævne mellemrum. Den nemmeste måde at gøre dette på er at oprette et cron-job.

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

Som et sidste, men valgfrit trin, genstart din VM og sørg for, at alle tjenester genstarter som forventet.