|
|
[[_TOC_]]
|
|
[[_TOC_]]
|
|
|
|
|
|
|
|
# Was ist devbox?
|
|
# Was ist devbox?
|
|
|
|
|
|
|
|
*devbox* ist eine virtuelle Maschine, die von der Fakultät 7 bereitgestellt wird.
|
|
_devbox_ ist eine virtuelle Maschine (VM), die von der Fakultät 7 bereitgestellt wird. Die Idee von devbox ist es, Ihnen die aufwendige Installation von Tools für jede einzelne Vorlesung zu ersparen und Ihnen stattdessen ein direkt lauffähiges Linux-Image zur Verfügung zu stellen. In dieses Linux-Image können Sie dann bequem mit der Kommandozeile Kurs für Kurs die notwendigen Tools automatisiert installieren.
|
|
|
Die Idee von devbox ist es, Ihnen die aufwendige Installation von Tools für jede einzelne Vorlesung zu ersparen und Ihnen stattdessen ein direkt lauffähiges Linux-Image zur Verfügung zu stellen.
|
|
|
|
|
In dieses Linux-Image können Sie dann bequem mit der Kommandozeile Kurs für Kurs die notwendigen Tools automatisiert installieren.
|
|
# Varianten der devbox
|
|
|
|
|
|
|
|
# Schritt für Schritt Anleitung
|
|
Die _devbox_ kann in einer VM in unterschiedlichen Umgebungen betrieben werden:
|
|
|
|
|
|
|
|
## 1. VirtualBox installieren
|
|
1. unter VirtualBox auf einem eigenen Gerät
|
|
|
|
|
2. unter VirtualBox auf einem Laborrechner
|
|
|
Um das Image nutzen zu können müssen Sie zunächst VirtualBox auf Ihrem Rechner installieren.
|
|
3. auf dem Proxmox-Cluster der Fakultät
|
|
|
Eine Anleitung hierzu finden Sie unter [https://www.virtualbox.org/](https://www.virtualbox.org/).
|
|
|
|
|
|
|
Diese Seite beschreibt Option 1.
|
|
|
Je nachdem, welche Historie Ihr Rechner und Betriebssystem mit sich bringt, kann es sein, dass Virtualbox bei der Installation nach Microsoft Visual C++ [xx] Redistributable verlangt.
|
|
|
|
|
|
|
ACHTUNG: Für Apple-Nutzer, deren Maschine mit einer M1-, M2-, M3-, M4-basierten CPU ausgestattet ist, empfehlen wir Option 3 und verweisen auf folgende Anleitung [Devbox VM im HM Proxmox Cluster](Devbox%20VM%20im%20HM%20Proxmox%20Cluster).
|
|
|
Suchen Sie z.B. hier nach dem entsprechenden Paket und installieren Sie die Laufzeitumgebung:
|
|
|
|
|
https://learn.microsoft.com/de-de/cpp/windows/latest-supported-vc-redist?view=msvc-170
|
|
# Schritt für Schritt Anleitung
|
|
|
|
|
|
|
|
## 2. Image herunterladen
|
|
## 1. VirtualBox installieren
|
|
|
|
|
|
|
|
Ist VirtualBox installiert müssen Sie noch das devbox Image selbst herunterladen.
|
|
Um das Image nutzen zu können müssen Sie zunächst VirtualBox auf Ihrem Rechner installieren. Eine Anleitung hierzu finden Sie unter https://www.virtualbox.org/.
|
|
|
Wir erstellen zwei verschiende Varianten:
|
|
|
|
|
|
|
Je nachdem, welche Historie Ihr Rechner und Betriebssystem mit sich bringt, kann es sein, dass Virtualbox bei der Installation nach Microsoft Visual C++ \[xx\] Redistributable verlangt.
|
|
|
* *Minimal* (ca. 4GB) enthält erst mal keine Tools Ihrer Vorlesungen, aber alle notwendigen Einstellungen, um diese Tools sehr einfach und automatisiert zu installieren.
|
|
|
|
|
* *Full* (ca. 20GB) enthält Tools für alle Vorlesungen, die devbox verwenden.
|
|
Suchen Sie z.B. hier nach dem entsprechenden Paket und installieren Sie die Laufzeitumgebung: https://learn.microsoft.com/de-de/cpp/windows/latest-supported-vc-redist?view=msvc-170
|
|
|
|
|
|
|
|
Wir empfehlen Ihnen das *Minimal*-Image herunterzuladen und für Ihre Vorlesungen dann jeweils die notwendigen Tools zu installieren.
|
|
## 2. Image herunterladen
|
|
|
|
|
|
|
|
Laden Sie nun von folgender Seite das Release Ihrer Wahl herunter: [Releases](Releases)
|
|
Ist VirtualBox installiert müssen Sie noch das devbox Image selbst herunterladen. Wir erstellen zwei verschiende Varianten:
|
|
|
|
|
|
|
|
## 3. Image in VirtualBox importieren
|
|
* _Minimal_ (ca. 4GB) enthält erst mal keine Tools Ihrer Vorlesungen, aber alle notwendigen Einstellungen, um diese Tools sehr einfach und automatisiert zu installieren.
|
|
|
|
|
* _Full_ (ca. 20GB) enthält Tools für alle Vorlesungen, die devbox verwenden.
|
|
|
Ist VirtualBox installiert und das Image heruntergeladen können Sie nun das Image in VirtualBox importieren.
|
|
|
|
|
Klicken Sie hierfür einfach in VirtualBox auf importieren:
|
|
Wir empfehlen Ihnen das _Minimal_-Image herunterzuladen und für Ihre Vorlesungen dann jeweils die notwendigen Tools zu installieren.
|
|
|
|
|
|
|
|
|
|
Laden Sie nun von folgender Seite das Release Ihrer Wahl herunter: [Releases](Releases)
|
|
|
|
|
|
|
|
Wählen Sie dann das heruntergeladene Image aus.
|
|
## 3. Image in VirtualBox importieren
|
|
|
Im nächsten Schritt können Sie alle Einstellungen auf Default lassen und bestätigen.
|
|
|
|
|
|
|
Ist VirtualBox installiert und das Image heruntergeladen können Sie nun das Image in VirtualBox importieren. Klicken Sie hierfür einfach in VirtualBox auf importieren:
|
|
|
## 4. Login
|
|
|
|
|
|
|
|
|
|
Starten Sie nun die devbox durch einen Doppelklick auf devbox.
|
|
|
|
|
Nach kurzer Zeit sollte der Login-Screen erscheinen:
|
|
Wählen Sie dann das heruntergeladene Image aus. Im nächsten Schritt können Sie alle Einstellungen auf Default lassen und bestätigen.
|
|
|
|
|
|
|
|
|
|
## 4. Login
|
|
|
|
|
|
|
|
Loggen Sie sich mit folgendem, voreingestellten Credentials ein:
|
|
Starten Sie nun die devbox durch einen Doppelklick auf devbox. Nach kurzer Zeit sollte der Login-Screen erscheinen:
|
|
|
|
|
|
|
|
* Benutzername: devbox
|
|
|
|
|
* Passwort: devbox
|
|
|
|
|
|
|
Loggen Sie sich mit folgendem, voreingestellten Credentials ein:
|
|
|
Mit diesen Credentials haben Sie auch volle sudo-Rechte in der devbox.
|
|
|
|
|
|
|
* Benutzername: devbox
|
|
|
Das Passwort kann im Terminal (<kbd>STRG</kbd>+<kbd>ALT</kbd>+<kbd>T</kbd>) wie folgt geändert werden:
|
|
* Passwort: devbox
|
|
|
|
|
|
|
|
```shell
|
|
Mit diesen Credentials haben Sie auch volle sudo-Rechte in der devbox.
|
|
|
passwd
|
|
|
|
|
```
|
|
Das Passwort kann im Terminal (<kbd>STRG</kbd>+<kbd>ALT</kbd>+<kbd>T</kbd>) wie folgt geändert werden:
|
|
|
|
|
|
|
|
## 5. Hardware-Virtualisierung prüfen
|
|
```shell
|
|
|
|
|
passwd
|
|
|
Prüfen Sie unbedingt, ob Hardware-Virtualisierung aktiviert ist.
|
|
```
|
|
|
VirtualBox zeigt Ihnen dies rechts unten an:
|
|
|
|
|
|
|
## 5. Hardware-Virtualisierung prüfen
|
|
|
|
|
|
|
|
|
|
Prüfen Sie unbedingt, ob Hardware-Virtualisierung aktiviert ist. VirtualBox zeigt Ihnen dies rechts unten an:
|
|
|
Sollte es aussehen wie im oberen Bildabschnitt, lesen Sie bitte [hier](hardware-virtualisierung) nach, wie Sie das Problem beheben können.
|
|
|
|
|
|
|
|
|
|
## 6. Tools für Kurs(e) installieren
|
|
|
|
|
|
|
Sollte es aussehen wie im oberen Bildabschnitt, lesen Sie bitte [hier](hardware-virtualisierung) nach, wie Sie das Problem beheben können.
|
|
|
Um nun die Tools für Ihren Kurs zu installieren, öffnen Sie in der virtuellen Maschine mit <kbd>STRG</kbd>+<kbd>ALT</kbd>+<kbd>T</kbd> ein Terminal.
|
|
|
|
|
|
|
## 6. Tools für Kurs(e) installieren
|
|
|
Mit folgendem Befehl können Sie dann in der devbox automatisch alle benötigten Tools für Ihren Kurs installieren:
|
|
|
|
|
|
|
Um nun die Tools für Ihren Kurs zu installieren, öffnen Sie in der virtuellen Maschine mit <kbd>STRG</kbd>+<kbd>ALT</kbd>+<kbd>T</kbd> ein Terminal.
|
|
|
```shell
|
|
|
|
|
~/update.sh <kürzel>
|
|
Mit folgendem Befehl können Sie dann in der devbox automatisch alle benötigten Tools für Ihren Kurs installieren:
|
|
|
```
|
|
|
|
|
|
|
```shell
|
|
|
Das notwendige `<kürzel>` erhalten Sie vom Dozierenden der jeweiligen Veranstaltung.
|
|
~/update.sh <kürzel>
|
|
|
Damit werden alle notwendigen Installationen, Updates und Konfigurationen für den Kurs automatisch durchgeführt.
|
|
```
|
|
|
|
|
|
|
|
## 7. Tools aktualisieren
|
|
Das notwendige `<kürzel>` erhalten Sie vom Dozierenden der jeweiligen Veranstaltung. Damit werden alle notwendigen Installationen, Updates und Konfigurationen für den Kurs automatisch durchgeführt.
|
|
|
|
|
|
|
|
Sollte der Dozierende im Laufe des Semesters für den Kurs Updates veröffentlichen oder neue Tools hinzufügen, können Sie einfach wieder mit dem Befehl
|
|
## 7. Tools aktualisieren
|
|
|
|
|
|
|
|
```
|
|
Sollte der Dozierende im Laufe des Semesters für den Kurs Updates veröffentlichen oder neue Tools hinzufügen, können Sie einfach wieder mit dem Befehl
|
|
|
~/update.sh <kürzel>
|
|
|
|
|
```
|
|
```
|
|
|
|
|
~/update.sh <kürzel>
|
|
|
die neuesten Konfigurationen und Updates für den Kurs einspielen.
|
|
```
|
|
|
|
|
|
|
|
# FAQs
|
|
die neuesten Konfigurationen und Updates für den Kurs einspielen.
|
|
|
|
|
|
|
|
[Hier](FAQ für Studierende) finden Sie noch FAQs zur devbox. |
|
# FAQs
|
|
|
|
|
|
|
|
[Hier](FAQ%20f%C3%BCr%20Studierende) finden Sie noch FAQs zur devbox. |
|
|
|
\ No newline at end of file |
