HowtoForge

So installierst du Jekyll unter Ubuntu

von ·

Jekyll ist ein kostenloser, quelloffener und sehr beliebter Generator für statische Websites, der zum Bloggen oder Teilen von Inhalten verwendet werden kann. Er ist einfach, leichtgewichtig und benötigt keine Datenbanken. Es benötigt wenig Speicherplatz und ist eine gute Alternative zu WordPress. Mit Jekyll kannst du deine Unternehmenswebseiten in wenigen Minuten erstellen, indem du Markup-Seiten und Inhalte erstellst. Jekyll ist die beste Wahl für dich, wenn du offline arbeiten möchtest und eine Versionskontrolle nutzen willst, um Änderungen an deiner Website zu verfolgen.

In diesem Tutorial erklären wir dir, wie du Jekyll auf Ubuntu 18.04 installierst.

Voraussetzungen

  • Ein Server, auf dem Ubuntu 18.04 läuft.
  • Ein Root-Passwort ist auf deinem Server eingerichtet.

Erste Schritte

Bevor du beginnst, musst du dein System mit der neuesten Version aktualisieren. Das kannst du tun, indem du den folgenden Befehl ausführst:

apt-get update -y
apt-get upgrade -y

Sobald dein Server aktualisiert ist, starte ihn neu, damit die Änderungen übernommen werden.

Erforderliche Abhängigkeiten installieren

Zuerst musst du einige Abhängigkeiten auf deinem System installieren. Installiere zunächst Ruby und die erforderlichen Build-Tools, indem du den folgenden Befehl ausführst:

apt-get install make build-essential ruby ruby-dev -y

Sobald alle Abhängigkeiten installiert sind, musst du die Umgebungsvariable Ruby in der Datei ~/.bashrc hinzufügen.

nano ~/.bashrc

Füge die folgenden Zeilen hinzu:

export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

Speichere und schließe die Datei, wenn du fertig bist. Aktiviere dann die Umgebungsvariable mit dem folgenden Befehl:

source ~/.bashrc

Wenn du das getan hast, kannst du mit dem nächsten Schritt fortfahren.

Jekyll installieren

Zuerst musst du Bundler installieren, um die Gem-Abhängigkeiten zu verwalten. Du kannst ihn installieren, indem du einfach den folgenden Befehl ausführst:

gem install bundler

Sobald die Installation abgeschlossen ist, solltest du die folgende Ausgabe erhalten:

Fetching: bundler-2.0.2.gem (100%)
Successfully installed bundler-2.0.2
Parsing documentation for bundler-2.0.2
Installing ri documentation for bundler-2.0.2
Done installing documentation for bundler after 2 seconds
1 gem installed

Als Nächstes installierst du Jekyll mit dem folgenden Befehl:

gem install jekyll

Nach der Installation solltest du die folgende Ausgabe erhalten:

Installing ri documentation for jekyll-4.0.0
Done installing documentation for public_suffix, addressable, colorator, http_parser.rb, eventmachine, em-websocket, concurrent-ruby, i18n, ffi, sassc, jekyll-sass-converter, ruby_dep, rb-inotify, rb-fsevent, listen, jekyll-watch, kramdown, kramdown-parser-gfm, liquid, mercenary, forwardable-extended, pathutil, rouge, safe_yaml, unicode-display_width, terminal-table, jekyll after 25 seconds
27 gems installed

Wenn du damit fertig bist, kannst du mit dem nächsten Schritt fortfahren.

Eine Website mit Jekyll erstellen

Jekyll ist nun installiert und bereit. Du kannst jetzt deine eigene Website mit Jekyll erstellen.

Lass uns eine Website mit dem Namen test.example.com erstellen, wie unten gezeigt:

jekyll new test.example.com

Sobald die Website erstellt ist, solltest du die folgende Ausgabe sehen:

Bundler: Fetching minima 2.5.1
Bundler: Installing minima 2.5.1
Bundler: Bundle complete! 6 Gemfile dependencies, 31 gems now installed.
Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.Don't run Bundler as root. Bundler can ask for sudo if it is needed, and installing your bundle as root will break this application for all
  Bundler: non-root users on this machine.
New jekyll site installed in /root/test.example.com.

Wechsle nun mit folgendem Befehl das Verzeichnis zu deiner Website:

cd test.example.com

Starte nun deinen Jekyll-Webserver, indem du die IP-Adresse deines Servers angibst (siehe unten):

jekyll serve --host=136.243.240.39

Sobald der Jekyll-Webserver gestartet ist, solltest du die folgende Ausgabe sehen:

Configuration file: /root/test.example.com/_config.yml
            Source: /root/test.example.com
       Destination: /root/test.example.com/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.168 seconds.
 Auto-regeneration: enabled for '/root/test.example.com'
    Server address: http://136.243.240.39:4000/
  Server running... press ctrl-c to stop.

Du kannst deinen Jekyll-Server jederzeit mit der Tastenkombination STRG+C stoppen.

Zugriff auf die Jekyll-Weboberfläche

Der Jekyll-Webserver ist nun gestartet und lauscht standardmäßig auf Port 4000. Öffne nun deinen Webbrowser und gib die URL http://136.243.240.39:4000 ein. Du wirst auf das Jekyll-Dashboard weitergeleitet, wie unten dargestellt:

Jekyll achtet ständig auf neue Änderungen im Verzeichnis test.example.com und baut die statische Website automatisch neu auf, wenn eine Änderung an einem Beitrag oder einer Seite gespeichert wird. Standardmäßig legt Jekyll alle Beiträge der Website im Verzeichnis _posts ab.

Nginx als Reverse Proxy für Jekyll konfigurieren

Standardmäßig läuft Jekyll auf Port 4000. Daher ist es eine gute Idee, Nginx als Reverse Proxy zu konfigurieren, um Anfragen von Port 80 auf 4000 weiterzuleiten.

Installiere zunächst Nginx mit dem folgenden Befehl:

apt-get install nginx -y

Nach der Installation von Nginx erstellst du eine neue Konfigurationsdatei für den virtuellen Host mit dem folgenden Befehl:

nano /etc/nginx/sites-available/jekyll.conf

Füge die folgenden Zeilen hinzu:

upstream jekyll {
  server 127.0.0.1:4000 weight=100 max_fails=5 fail_timeout=5;
}

server {
  listen          80;
  server_name     136.243.240.39;

  location / {
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://jekyll/;
  }
}

Speichere und schließe die Datei. Aktiviere dann die Nginx-Konfigurationsdatei mit folgendem Befehl:

ln -s /etc/nginx/sites-available/jekyll.conf /etc/nginx/sites-enabled/

Starte schließlich den Nginx-Dienst neu, um die Konfiguration zu übernehmen:

systemctl restart nginx

Jetzt kannst du auf deinen Jekyll-Server zugreifen, ohne den Port 4000 mit IP-Adresse anzugeben.

Das war’s. Du hast Jekyll erfolgreich auf dem Ubuntu 18.04 Server installiert und konfiguriert. Ich hoffe, du hast jetzt genug Wissen, um deine eigene Website mit Jekyll zu erstellen. Wenn du noch Fragen hast, kannst du mich gerne fragen.

Das könnte dich auch interessieren …