Dieses Repository behandelt die Installation eines Multi-VM-Umgebung mit Vagrant und Virtual Box.
Die nachstehende Dokumentation wurde von Michael Blickenstorfer im Rahmen des Moduls M300 (Plattformübergreifende Dienste in ein Netzwerk integrieren) erarbeitet und zeigt alle Schritte auf, die es zur Einrichtung einer vollständig funktionsfähigen Toolumgebung benötigt.
Wichtig:
Für die Durchführung der nachfolgenden Aufgaben, muss zuerst die Dokumentation M300_Toolumgebung konsultiert worden sein. Diese liefert uns die Grundlage für die Erstellung von virtuellen Maschinen.
| Datum | Änderungen | Kürzel |
|---|---|---|
| 25.09.2018 | Dokumentation erstellt & hochgeladen | MBL |
| 30.10.2018 | Grafiken eingefügt, kleine Verbesserungen gemacht | MBL |
| ... | ... | ... |
- macOS High Sierra (Version 10.13.6)
- VirtualBox (Version 5.2.18)
- Vagrant (Version 2.1.4)
- Text-Editor (z.B. Visual Studio Code)
- 01 - Vorbereitungen
- 02 - Box hinzufügen
- 03 - VMs konfigurieren
- 04 - Provisionierung
- 05 - Ordner-Synchronisation
- 06 - Port-Weiterleitunng
- 07 - Quellenverzeichnis
Für die Erstellung einer Multi-Maschinen-Umgebung mit Vagrant muss zuallererst das sogenannte Vagrantfile erstellt werden. Dies ist eine Datei, welche alle notwendigen Konfigurationselemente beherrbergt, die zur Erstellung der einzelnen VMs benötigt werden.
Die Datei erfüllt folgende Zwecke:
- Das Vagrantfile legt fest, wo sich das Projekt befindet. Dieses "Root-Directory" ist für viele Konfigurationseinstellungen unabdingbar.
- Mit dem Vagrantfile werden Anzahl Maschinen und Ressourcen (inkl. Software) definiert, die für den Betrieb benötigt werden.
- Terminal starten
- Projektordner erstellen, wo das Projekt liegen soll:
$ mkdir MeinVagrantProjekt $ cd MeinVagrantProjekt - Vagrantfile erstellen:
$ vagrant init
Mit dem letzten Befehl wird das Vagrantfile im aktuellen Verzeichnis MeinVagrantProjekt erstellt.
Als nächstes benötigen wir eine Vagrant Box, die uns eine Art "System-Image" (Abbild) liefert, auf welchem wir unsere eigene Konfiguration mit den Services aufbauen können.
Unter https://app.vagrantup.com/boxes/search findet man alle öffentlich verfügbaren Boxen, die frei verwendbar sind. In unserem Fall nutzen wir die bento/ubuntu-16.04 Box, die hier näher beschrieben ist.
Vagrant Boxen lassen sich nicht einfach so per Maus-Klick herunterladen. Sie werden direkt im Terminal dem lokalen "Repository" hinzugefügt. Dazu müssen folgende Schritte durchgeführt werden:
- Terminal starten
- Vagrant Box hinzufügen:
$ vagrant box add bento/ubuntu-16.04
Der letzte Befehl lädt die Box herunter und fügt sie Vagrant hinzu. Sobald wir nun im Vagrantfile diese Box mitgeben, wird die Anwendung eine VM mit diesem "Image" verwendet.
Wichtig:
Falls die Box noch nicht mit den Befehlvagrant box addhinzugefügt wurde, ist dies nicht weiter schlimm. Vagrant sucht automatisch im Katalog nach der entsprechenden Box.
Die VM könnte nun fast ohne weitere Probleme gestartet werden. Jedoch müssen wir im Vagrantfile noch angeben, welche hinzugefügte Box verwendet werden soll. Dazu müssen folgende Schritte umgesetzt werden:
- Terminal öffnen
- In das Projekt-Verzeichnis wechseln
- Das Vagrantfile mit einem GUI-Editor öffnen (z.B. Visual Studio Code)
- Folgenden Inhalt einfügen:
Vagrant.configure("2") do |config| config.vm.provision :shell, inline: "echo A" config.vm.define :apache do |web| web.vm.box = "bento/ubuntu-16.04" web.vm.provision :shell, path: "bootstrap.sh" web.vm.network :forwarded_port, guest: 80, host: 4567 end config.vm.define :database do |db| db.vm.box = "bento/ubuntu-16.04" end end
Dies ist eine ganz schöne Menge an Code. Aber keine Sorge, der Code ist leicht zu verstehen!
Vagrant.configure("2") do |config|
Ist der Header des Vagrantfiles. Er legt die grundsätzliche Konfiguration fest und ist über die Variable config ansprechbar.
config.vm.provision :shell, inline: "echo A"
Dient uns lediglich zum Verständnis. Bei der anschliessenden Erstellung der VM wird im Output der Konsole nämlich "A" ausgegeben.
config.vm.define :apache do |web|
Definiert die erste Virtuelle Maschine (VM), die apache heisst und über die Variable web anzusprechen ist.
web.vm.(...)
Hier wird die VM konfiguriert. So wird beispielsweise mit web.vm.box = ""bento/ubuntu-16.04" definiert, welche Vagrant Box verwendet werden soll.
config.vm.define :database do |db|
Dieser Code-Abschnitt definiert die zweite VM und ist im Prinzip gleich wie die Defintion der 1. VM.
Jetzt aber weiter mit dem Start! Denn auf alle anderen Punkte wird in den nachfolgenden Abschnitten genauer eingegangen.
Soweit ist alles start-bereit und die beiden VMs könnten gestartet werden. In der Config ist uns aber folgender Punkt bei der Konfiguration der Web-VM (apache) aufgefallen:
web.vm.provision :shell, path: "bootstrap.sh"Diese Konfiguration zeigt auf ein Skript (bootstrap.sh), dass in der Shell ausgeführt werden soll. Genau hier kommt die Provisionierung ins Spiel. Den das bootstrap.sh Script macht nichts anderes, als den Apache-Webserver zu installieren und eine kleine Ordnerumleitung einzurichten. Wie das geht, erfährst du nachfolgend.
- Terminal öffnen
- In das Projekt-Verzeichnis wechseln
- Mit Text-Editor die Datei
bootstrap.sherstellen und folgenden Inhalt einfügen:
#!/usr/bin/env bash
apt-get update
apt-get install -y apache2
if ! [ -L /var/www ]; then
rm -rf /var/www
ln -fs /vagrant /var/www
fi- Das Script bzw. die Datei speichern & schliessen
Nun haben wir alle Vorbereitungen getroffen und das Environment bzw. die VMs können gestartet werden:
- Bei geöffnetem Terminal die VM Provisionierung starten:
$ vagrant up- Nach erfolgreichem Start mit SSH auf eine der beiden VMs verbinden:
$ vagrant ssh [apache|databse]- In der VM können nun bei bedarf weitere Konfigurationen vorgenommen werden. Nun aber mit
CTRL + Ddie Verbindung wieder schliessen.
Ob der Webserver mit Apache auch wirklich läuft, werden wir jetzt prüfen. Dazu müssen folgende Schritte gemacht werden: 1. Im Projekt-Verzeichnis einen Ordner mit dem Namen "html" erstellen 2. In diesem Ordner eine HTML-Datei ablegen (oder direkt von https://html5up.net/ eine kleine Vorlage holen) 3. Folgende Adresse aufrufen: http://127.0.0.1:4567 und das Ergebnis betrachten
Nun ist soweit alles eingerichtet. Aber aufgepasst: In den zwei letzten Abschnitten werden die beiden letzten Geheimnisse um die Konfiguration gelüftet!
Interessant zu sehen war, dass wir die HTML-Dateien für die Webseite lokal in unserem Projektordner abgelegt haben. Doch wie konnte VM auf diese Daten zugreifen? Lösung: Ordner-Synchronisation
Vagrant richtet voll-automatisch einen Shared-Folder ein, welcher über den Projektordner aufgerufen werden kann.
Im bootstrap.sh Script haben wir zudem auf VM-Ebene eine Umleitung zu /vagrant gemacht. /vagrant entspricht dabei dem Projektordner selbst. Das heisst, dass alle Dateien, die lokal in diesem Ordner abgelegt werden, in der VM unter /vagrant erscheinen. Also auch das Script und die HTML-Dateien.
Auf /vagrant kann man direkt zugreifen, sobald man sich per SSH verbindet. Ausgangsverzeichnis ist dabei /home/vagrant und mit cd /vagrant wechselt man anschliessend in das Shared-Folder Verzeichnis.
Das letzte Geheminis ist die Portweiterleitung.
Als wir die Webseite mit http://127.0.0.1:4567 aufgerufen haben, kam ein anderer Port zum Einsatz, als der Standard-Port 80 für HTTP-Webseiten.
Der Grund dafür liegt im Vagrantfile. Dort haben wir beim Apache-Webserver die Zeile web.vm.network :forwarded_port, guest: 80, host: 4567 eingetragen. Die Zeile richtet eine sogenannte Port-Weiterleitung ein. Das heisst, alle Anfragen auf Port 4567 an die VM werden auf den Port 80 umgeleitet. Dies ist vor allem dann nützlich, wenn Sicherheitsaspekte bei der Entwicklung von Web-Applikationen berücksichtigt werden müssen.
Alles klar soweit? Ich hoffe schon!
In diesem Abschnitt möchte ich zur Hilfe verwendete Quellen transparent offen legen.
Für das Setup der VMs habe ich mich nach der offiziellen Dokumentation von den Vagrant-Entwicklern orientiert:
https://www.vagrantup.com/intro/getting-started/index.html
Bei der Erstellung einer Multi-Maschinen-Umgebung, nahm ich zudem folgende Dokumentation zur Hilfe:
https://www.vagrantup.com/docs/multi-machine/
Als ich mit der HTML-Anzeige Probleme hatte, half mir folgender Forum-Post weiter:
https://stackoverflow.com/questions/30960478/trouble-with-vagrant-404-not-found
Weitere Unterstützung durch: