#1: Betriebssystem vorbereiten
Windows 10:
Programme installieren (DE)
Unter Windows ist es standardmäßig nicht möglich, “einfach“ die Linux Distribution Ubuntu zu installieren. Dazu muss vorab erst das WSL2 aktiviert / installiert werden werden (Punkt 1). Im Anschluss ist eine Installation von Ubuntu (18.04 oder 20.04 oder höher) möglich. Zudem muss Docker installiert werden, in dem dann die Entwicklungsumgebung laufen kann (Punkt 2).
WSL2 unter Windows10 aktivieren und Ubuntu 20.04 installieren:
Aus dem Microsoft-Store: https://aka.ms/wslstorepage (verfügbar seit Nov. 2022)
Manuell unter Installieren von WSL
Docker für Windows installieren: https://docs.docker.com/docker-for-windows/install/
Unter Windows muss in der Hosts-Datei (%windir%\system32\drivers\etc) folgende Eintragung gemacht werden:
Install software (EN)
To install Ubuntu Linux distribution under Windows you first have to activate WSL2 (see item 1). Afterwards a Linux installation of Ubuntu (18.04 or 20.04 or higher) is possible. Additionally docker application needs to be installed (see item 2).
activate WSL2 in Windows10 and install Ubuntu 20.04:
From Microsoft-Store: https://aka.ms/wslstorepage (available since Nov. 2022)
Manually installation see: Install WSL
Install Docker for Windows: https://docs.docker.com/docker-for-windows/install/
Add the following two lines in your Windows “host” file (%windir%\system32\drivers\etc):
127.0.0.1 docker.team-opencaching.de
127.0.0.1 try.docker.team-opencaching.de
Im Anschluss wird Ubuntu gestartet (z.B. im “Such“-Menü nach Ubuntu suchen und anklicken). Beim erstmaligen Starten von Ubuntu müssen ein Benutzername und ein Passwort festgelegt werden.
Im Anschluss den Punkten folgen und ausführen, die im nächsten Schritt “Linux” beschrieben werden.
Start Ubuntu (e.g. by typing “Ubuntu” in start menu and clicking on it). During the first start a username and password need to be defined.
Now follow the steps described below in section “Linux”.
Linux:
Der Linuxartikel wurde erstellt auf Lubuntu 18.04, aktualisiert mit 22.04 und erweitert mit Debian 12
Programme installieren
Folgende Programme sind notwendig und müssen vorab installiert werden:
PHP (aktuell mind. PHP7.4, später PHP8), diverse PHP-Erweiterungen, docker-compose, mariadb-client.
Für die PHP-Erweiterungen ist eventuell ein zusätzliches PPA-Repository notwendig. Dessen Installation erfordert je nach Betriebssystem ein unterschiedliches Vorgehen.
Ubuntu
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
Debian
sudo apt install software-properties-common ca-certificates lsb-release apt-transport-https
curl -sSL https://packages.sury.org/php/README.txt | sudo bash -x
Die Pakete lassen sich mit folgenden Befehlen installieren (Versionsnummer kann abweichen).
Sollten beim Installieren der Pakete Fehlermeldungen kommen, ist es empfehlenswert, die Pakete einzeln zu installieren und auftretende Fehler/Abhängigkeiten einzeln zu lösen.
Nutzer in docker-Gruppe aufnehmen
Der aktuelle Benutzer muss in die Gruppe “docker” aufgenommen werden, sonst kann es passieren, dass dieser keinen Zugriff auf die Dockercontainer bekommt.
Die Änderung wird aber erst nach einem Ab-/Anmelden des Nutzers wirksam.
Überprüft werden kann dies danach mittels
Hier muss die “docker”-Gruppe aufgelistet sein. Beispiel:
Eigenschaften der Docker Socket Datei prüfen
Den folgenden Befehl ausführen, um die Eigenschaften der Datei anzeigen zu lassen:
Die Datei muss dabei ‘docker’ zugewiesen sein:
Ist dies nicht der Fall, muss die Zugehörigkeit geändert werden:
Weiter geht’s mit #2: Git