So installieren und konfigurieren Sie Ruby mit Rbenv, Rails, MariaDB, Nginx, SSL und Passenger unter Ubuntu 17.04

• Bedarf
• In diesem Handbuch verwendeter Stapel
• Installation
• Optionale Pakete
• Installieren Sie den MariaDB-Server
• Installieren Sie Rbenv und Ruby

Ruby on Rails ist ein beliebtes Webframework für Ruby, das entwickelt wurde, um die Produktivität eines Programmierers zu steigern. Es kann jedoch manchmal schwierig werden, verschiedene Edelsteine ​​und Abhängigkeiten zusammenzubringen. Dieses Handbuch hilft Ihnen beim Einrichten einer vollständigen produktionsbereiten Rails-Umgebung, einschließlich häufig verwendeter Edelsteine ​​und Abhängigkeiten.

Bedarf

• Vultr-Instanz mit mindestens 512 MB RAM (1024 MB bevorzugt).
• Vultr-Instanz mit Ubuntu 17.04.

In diesem Handbuch verwendeter Stapel

• Nginx : ein schneller und leistungsstarker Webserver. (Version 1.10.3)
• Passagier : Ein App-Server, mit dem Nginx Ihre Ruby-App bedienen kann. (Version 1.5.1.8)
• Rbenv : ein Ruby-Versionsmanager. (Version 1.1.1-2)
• Ruby : (Version 2.4.1)
• MariaDB : ein Open Source-Zweig des MySQL-Servers (Version 10.2)
• SSL- Zertifikat von Let's Encrypt

Installation

Sudo-Benutzer hinzufügen

Hinweis : Es wird dringend empfohlen, keinen dieser Dienste als Root zu installieren, da Sie sich möglicherweise einem Angriff aussetzen können. Das Einrichten eines deployoder eines appBenutzers ist eine gängige Konvention:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

System aktualisieren und aktualisieren

Stellen Sie sicher, dass Sie die neuesten Pakete auf Ihrer Ubuntu-VM ausführen:

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

Installieren Sie das Build-System

Um Ruby mit rbenv und anderen Edelsteinen kompilieren zu können , müssen verschiedene Pakete installiert werden. Abhängig von der Version von Ruby, die Sie benötigen, werden einige der Pakete möglicherweise nicht benötigt.

Kompilieren

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

Pakete für die SSL-Unterstützung

Diese sind erforderlich, um mehrere Edelsteine ​​zusammenzustellen, z. B. Passagier:

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

Versionierung

Die Ruby-Community verwendet Git als SCM der Wahl. Es können aber auch weitere wie Mercurial oder Subversion installiert werden:

sudo apt-get install -y git git-core

Datenbanktreiber für MySQL / MariaDB

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

Nokogiri

Erforderlich für mehrere beliebte Edelsteine, die native XML-Bibliotheken benötigen:

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

Node.js

Fügen Sie offizielle Repositorys von Node mit der neuesten Version hinzu, da die Standard-Ubuntu-Repositorys in der Regel hinter einigen Hauptversionen zurückbleiben:

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

Optionale Pakete

Diese Pakete sind nicht erforderlich, damit das System ausgeführt werden kann, aber sie sind gut zu haben, wenn Sie bestimmte Edelsteine ​​verwenden müssen.

Grafiken und Bilder

Diese Bibliotheken sind nicht erforderlich und können übersprungen werden, es sei denn, Sie möchten Bildmanipulationsedelsteine ​​verwenden. wie Rmagick:

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

Datenbanktreiber für SQLite und PostgreSQL

Installieren Sie Treiber für SQLite oder PostgreSQL, wenn Sie eine Verbindung zu anderen Datenbanken herstellen oder eine einfache, lokale Datenbank bevorzugen:

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

Werkzeuge

Dienstprogramme, die normalerweise bei einer neuen Ubuntu-Installation nicht vorinstalliert sind. Fühlen Sie sich frei, Ihren Texteditor Ihrer Wahl zu installieren:

sudo apt-get install -y iotop htop nano vim

Installieren Sie den MariaDB-Server

MariaDB ist ein leistungsstarker relationaler SQL Server, der vollständig mit MySQL kompatibel ist. Der einfachste Weg, die neueste Version von MariaDB zu installieren, ist die Verwendung offizieller Repositorys:

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

Befolgen Sie die Anweisungen und richten Sie ein Root-Passwort ein. Stellen Sie anschließend sicher, dass Sie auf Ihre Neuinstallation zugreifen können:

mysql -V 

Es wird eine ähnliche Zeile angezeigt:

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

Melden Sie sich bei der MySQL-Shell an:

mysql -h localhost -u root -p 

Hinweis : \qZum Beenden verwenden.

Installieren Sie Rbenv und Ruby

Rbenv

Installieren Sie Rbenv mit git. Dies ist die einfachste Installationsmethode und ermöglicht spätere einfache Updates. Außerdem ruby-buildist es für die eigentliche Kompilierung verschiedener Ruby-Versionen verantwortlich:

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

Hinweis : Wenn Sie einfach cd ~/.rbenvund aktualisieren müssen git pull.

Stellen Sie Rbenv und Ruby-Build in der Shell zur Verfügung. Verwenden Sie die folgenden Zeilen, um sicherzustellen, dass die Exportzeilen am Anfang der .bashrcDatei eingefügt werden, was für nicht interaktive Bash-Befehle wichtig ist:

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

Überprüfen Sie, ob Rbenv und Ruby-build installiert sind und in der Shell verfügbar sind:

rbenv install --list

Wenn dies rbenvnicht erkannt wird, melden Sie sich ab und wieder bei der Shell an.

Erstellen Sie eine ~/.bash_profileDatei und zeigen Sie auf die Quelle Ihrer ~/.bashrcDatei. Wenn Sie nicht interaktive Shell-Befehle über Ihre Rails-App ausführen müssen, z. B. Cron-Jobs, die vom wheneverGem eingerichtet wurden, wird dieselbe Ruby-Version wie für Ihre interaktive Shell verwendet. Dies kann helfen, seltsame Fehler zu vermeiden. Fügen Sie diese Zeile zur ~/.bash_profileDatei hinzu:

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

Rubin

Installieren Sie Ruby 2.4.1:

rbenv install 2.4.1

Hinweis : Dieser Vorgang kann je nach den Ressourcen auf Ihrer VM 5 bis 15 Minuten dauern, und es gibt keinen Fortschrittsbalken.

Stellen Sie Rbenv überall zur Verfügung.

rbenv global 2.4.1

Passagier und Nginx

Fügen Sie den PGP-Schlüssel und die HTTPS-Unterstützung für apt hinzu:

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

Fügen Sie das Passagier-Repository hinzu:

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

Installieren Sie die Passenger + Nginx-Module:

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

Besuchen Sie Ihre Vultr-Instanz mit ihrem Domainnamen oder ihrer IP, um diese an dieser Stelle zu testen. Wenn sie funktionieren, wird auf Ihrer Seite die Standard-Nginx-Begrüßungsseite angezeigt.

Rails einrichten, die App und Passagier konfigurieren

Installieren Sie Bundler und Rails:

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

Ubuntu / Debian-Konvention ist, Ihre App in einzurichten /var/www. Standardmäßig kann es nur von root geschrieben werden. Geben Sie dem sudo-Benutzer das Eigentum, damit das Setup funktioniert deploy:

sudo chown deploy:deploy /var/www -R

Generieren Sie die Rails-App in /var/www/. Wenn Sie bereits eine App haben, die Sie bereitstellen möchten, klicken git cloneSie diese hier und führen Sie sie aus bundle:

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

Konfigurieren Sie den Passagier so, dass er auf die App zeigt.

1. Bereiten Sie Nginx vor.

   sudo nano /etc/nginx/nginx.conf
   

2. Benutzer ändern zu deploy.

   user deploy;
   

3. Im httpAbschnitt der Konfiguration sollte eine Zeile vorhanden sein, die Nginx anweist, Module einschließlich Passagier zu laden. Wenn es fehlt, können Sie es direkt nach dem Virtual Host ConfigsTitel, aber vorher hinzufügen sites-enabled.

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

4. Bearbeiten / erstellen Sie die passenger.confDatei.

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

5. Weisen Sie den Passagier an, unser Rbenv-Setup zu verwenden. Es kann eine Zeile enthalten, die auf die in Passenger enthaltene Ruby-Version verweist. Löschen oder kommentieren Sie sie einfach aus.

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

6. Richten Sie den virtuellen Host so ein, dass er auf die App in verweist /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. Starten Sie Nginx neu.

   sudo service nginx restart
   

Zu diesem Zeitpunkt kann Ihre Anwendung im Entwicklungsmodus verwendet werden. Um in den Produktionsmodus zu wechseln, müssen Sie zu Ihrer Nginx-Konfiguration zurückkehren und die rails_envEinstellung auf ändern production.

Bevor Sie in dem Produktionsmodus wechseln, müssen Sie noch die Einrichtung Ihre Produktionsdatenbank example_production, database.ymlund geheime Schlüssel. Testen Sie ein Tool wie Capistrano oder Mina, um den Anwendungsbereitstellungsprozess zu beschleunigen. Es wird empfohlen, ENV-Variablen mit einem Edelstein wie zu verwenden dotenvund Ihre Kennwörter, geheimen Schlüssel usw. nicht in Ihr Git-Repository zu übertragen.

SSL einrichten

Es gibt mehrere Dienste, die SSL-Zertifikate für Ihre Domain anbieten. Viele werden bezahlt und einige sind kostenlos. Richten Sie SSL ein, unabhängig davon, welchen Dienst Sie verwenden. Let's Encrypt ist sehr einfach und kostenlos zu verwenden. Let's Encrypt ist eine gemeinnützige Organisation, die von vielen Technologiegiganten unterstützt wird.

Installation

Führen Sie die folgenden Befehle aus und befolgen Sie die Anweisungen.

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

Wenn Sie jetzt mit zu Ihrer Vultr-Instanz gehen HTTPS, wird eine sichere Website angezeigt .

Erneuerung

Ihr neu ausgestelltes Zertifikat läuft ab und muss regelmäßig erneuert werden. Der einfachste Weg, dies zu tun, besteht darin, einen Cron-Job einzurichten.

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

Starten Sie als letzten, aber optionalen Schritt Ihre VM neu und stellen Sie sicher, dass alle Dienste wie erwartet neu gestartet werden.