Jak nainstalovat a nakonfigurovat Ruby s Rbenv, Rails, MariaDB, Nginx, SSL a Passenger na Ubuntu 17.04

Ruby on Rails je populární webový framework pro Ruby, který byl vyvinut za účelem zvýšení produktivity programátorů. Přimět různé drahokamy a závislosti ke spolupráci však může být někdy složité. Tato příručka vám pomůže nastavit plné prostředí Rails připravené na produkci včetně běžně používaných drahokamů a závislostí.

Požadavky

• Instance Vultr s alespoň 512 MB RAM (preferováno 1024 MB).
• Instance Vultr se systémem Ubuntu 17.04.

Zásobník použitý v této příručce

• Nginx : rychlý a výkonný webový server. (verze 1.10.3)
• Passenger : aplikační server, který pomůže Nginx obsluhovat vaši aplikaci Ruby. (verze 1.5.1.8)
• Rbenv : správce verzí Ruby. (verze 1.1.1-2)
• Ruby : (verze 2.4.1)
• MariaDB : open source větev serveru MySQL (verze 10.2)
• SSL certifikát od Let's Encrypt

Instalace

Přidat uživatele Sudo

Poznámka : Důrazně se doporučuje neinstalovat žádnou z těchto služeb jako root, protože byste se mohli vystavit útoku. Nastavení uživatele deploynebo appje běžnou konvencí:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Aktualizace a upgrade systému

Ujistěte se, že na svém virtuálním počítači Ubuntu používáte všechny nejnovější balíčky:

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

Nainstalujte sestavení systému

Aby bylo možné zkompilovat Ruby pomocí rbenv a dalších drahokamů, je třeba nainstalovat různé balíčky. V závislosti na verzi Ruby, kterou budete potřebovat, nemusí být některé balíčky potřeba.

Kompilace

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

Balíčky pro podporu SSL

Ty jsou nezbytné pro sestavení několika drahokamů, jako je Passenger:

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

Verzování

Ruby komunita používá Git jako SCM volby; ale další, jako Mercurial nebo Subversion, lze nainstalovat také:

sudo apt-get install -y git git-core

Ovladače databáze pro MySQL / MariaDB

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

Nokogiri

Vyžadováno pro několik oblíbených drahokamů, které potřebují nativní knihovny XML:

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

Node.js

Přidejte oficiální úložiště z Node s nejnovější verzí, protože výchozí úložiště Ubuntu mají tendenci zaostávat za několika hlavními verzemi:

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

Volitelné balíčky

Tyto balíčky nejsou nutné pro běh systému, ale je dobré je mít, pokud potřebujete použít určité drahokamy.

Grafy a obrázky

Tyto knihovny nejsou nutné a lze je přeskočit, pokud neplánujete používat drahokamy pro manipulaci s obrázky; jako Rmagick:

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

Ovladače databáze pro SQLite a PostgreSQL

Nainstalujte ovladače pro SQLite nebo PostgreSQL, pokud se potřebujete připojit k jiným databázím nebo dáváte přednost jednoduché lokální databázi:

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

Nástroje

Nástroje, které obvykle nejsou předinstalované v nové instalaci Ubuntu. Neváhejte a nainstalujte si textový editor podle vašeho výběru:

sudo apt-get install -y iotop htop nano vim

Nainstalujte server MariaDB

MariaDB je výkonný relační SQL server, který je plně kompatibilní s MySQL. Nejjednodušší způsob, jak nainstalovat nejnovější verzi MariaDB, je pomocí oficiálních úložišť:

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

Postupujte podle pokynů a nastavte heslo uživatele root. Poté ověřte, že máte přístup k nové instalaci:

mysql -V 

Zobrazí řádek podobný tomuto:

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

Přihlaste se do prostředí MySQL:

mysql -h localhost -u root -p 

Poznámka : použijte \qpro ukončení.

Nainstalujte Rbenv a Ruby

Rbenv

Nainstalujte Rbenv pomocí git. Toto je nejjednodušší způsob instalace a umožňuje pozdější snadné aktualizace. Nainstalujte také ruby-build, je zodpovědný za skutečnou kompilaci různých verzí Ruby:

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

Poznámka : Když potřebujete aktualizovat jednoduše cd ~/.rbenva git pull.

Zpřístupněte Rbenv a Ruby-build v shellu. Aby bylo zajištěno, že vývozní linky dostat vložena na začátku tohoto .bashrcsouboru, který je důležitý pro neinteraktivní příkazů bash, použijte tyto řádky:

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

Zkontrolujte, zda jsou Rbenv a Ruby-build nainstalovány a jsou dostupné v shellu:

rbenv install --list

Pokud rbenvnení rozpoznán, odhlaste se a přihlaste se zpět do shellu.

Vytvořte ~/.bash_profilesoubor a nasměrujte jej na zdrojový ~/.bashrcsoubor. Pokud potřebujete spouštět nějaké neinteraktivní příkazy shellu z vaší aplikace Rails, jako jsou úlohy cron nastavené wheneverdrahokamem, použije stejnou verzi Ruby jako váš interaktivní shell. To může pomoci předejít podivným chybám. Přidejte tento řádek do ~/.bash_profilesouboru:

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

Rubín

Nainstalujte Ruby 2.4.1:

rbenv install 2.4.1

Poznámka : Tento proces může trvat 5–15 minut v závislosti na prostředcích na vašem virtuálním počítači a není zde žádný ukazatel průběhu.

Zpřístupněte Rbenv všude.

rbenv global 2.4.1

Cestující a Nginx

Přidejte klíč PGP a podporu HTTPS pro 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

Přidejte úložiště 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

Nainstalujte moduly Passenger + Nginx:

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

Navštivte svou instanci Vultr pomocí názvu domény nebo IP a otestujte je v tomto okamžiku. Pokud fungují, vaše stránka zobrazí výchozí uvítací stránku Nginx.

Nastavení Rails, aplikace a konfigurace cestujícího

Nainstalujte Bundler a Rails:

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

Konvencí Ubuntu/Debianu je nastavení aplikace v /var/www. Ve výchozím nastavení do něj může zapisovat pouze root. Aby nastavení fungovalo, předejte vlastnictví uživateli sudo deploy:

sudo chown deploy:deploy /var/www -R

Vygenerujte aplikaci rails v /var/www/. Pokud již máte aplikaci, kterou chcete nasadit, git clonezde a poté spusťte bundle:

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

Nakonfigurujte Passenger tak, aby ukazoval na aplikaci.

1. Příprava Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Změnit uživatele na deploy.

   user deploy;
   

3. V httpsekci konfigurace by měl být řádek, který říká Nginxu, aby načetl moduly včetně cestujících. Pokud chybí, můžete jej přidat hned za Virtual Host Configsnadpis, ale před sites-enabled.

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

4. Upravte/vytvořte passenger.confsoubor.

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

5. Řekněte cestujícímu, aby použil naše nastavení Rbenv. Může obsahovat řádek ukazující na verzi Ruby, která je součástí aplikace Passenger, stačí ji smazat nebo okomentovat.

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

6. Nastavte virtuálního hostitele tak, aby ukazoval na aplikaci 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. Restartujte Nginx.

   sudo service nginx restart
   

V tomto okamžiku je vaše aplikace připravena k použití ve vývojovém režimu. Chcete-li přepnout do produkčního režimu, musíte se vrátit do konfigurace Nginx a změnit rails_envnastavení na production.

Předtím, než se přepnete do režimu výroby, stále budete muset nastavit svůj produkční databáze example_production, database.ymla tajný klíč. Vyzkoušejte nástroj jako Capistrano nebo Mina, který urychlí proces nasazení aplikací. Je dobrým zvykem používat proměnné ENV s klenotem, jako je dotenv, a neposílat svá hesla, tajné klíče a podobně do svého úložiště git.

Nastavit SSL

Existuje několik služeb, které nabízejí certifikáty SSL pro vaši doménu, mnohé z nich jsou placené a některé jsou zdarma. Nastavte SSL bez ohledu na to, jakou službu používáte. Let's Encrypt je velmi snadné a bezplatné použití. Let's Encrypt je nezisková organizace, za kterou stojí mnoho technologických gigantů.

Instalace

Spusťte následující příkazy a postupujte podle pokynů.

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

Pokud nyní přejdete do své instance Vultr pomocí HTTPS, uvidíte zabezpečený web.

Obnova

Platnost vašeho nově vydaného certifikátu vyprší a bude nutné jej pravidelně obnovovat. Nejjednodušší způsob, jak toho dosáhnout, je nastavit úlohu cron.

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

Jako poslední, ale volitelný krok, restartujte virtuální počítač a ujistěte se, že se všechny služby restartují podle očekávání.