How to get started

Installation von Docker Desktop

Als allererstes müssen Sie sich Docker Desktop für ihr Betriebssystem herunterladen. Am besten gehen Sie dazu auf die offizielle Website von Docker. Anschliessend klicken Sie die Installation durch und warten anschliessend, bis diese fertig ist.

Installation von Git

Als Nächstes müssen Sie sich Git installieren, um danach das Github Repository zu clonen und um später auf Github commiten & pushen zu können. Dazu können Sie auf die offizielle Website von Git gehen und sich die Version für Ihren Computer herunterladen. Hier klicken Sie erneut die Installation durch und warten erneut, bis diese fertig ist.

Github Repo mit DevContainer clonen

Im nächsten Schritt können Sie sich das Github Repository von Github holen. Das machen Sie, indem Sie als Erstes im Explorer in den Ordner wechseln, in dem Sie das Repository haben möchten. Anschliessen können sie in diesem Ordner die Commandline öffnen (Windows -> CMD / Linux -> Terminal / MacOS -> Terminal) und dort den folgenden Befehl eingeben:

git clone https://github.com/Yanni8/M347-DevContainer.git


Erste Schritte mit Docker

Docker Container Starten

Um den Devcontainer starten zu können, müssen Sie sich zuerst noch eine Extension in VSC herunterladen. Dazu gehen Sie in VSC in die Extensions, suchen dort “Dev Container” und laden sich diese Extension herunter.
Man darf umbedingt auch nicht vergessen das .env file mit allen nötigen Variablen zu füllen. Diese sind auffindbar im .env.example.local Sobald Sie das erledigt haben, können Sie in VSC auf File -> Open Folder -> Ordner mit dem Devcontainer auswählen und anschliessend das Main-File öffnen. Sobald Sie das gemacht haben, können Sie in VSC unten links auf das grüne Rechteck klicken und dann auf Reopen in container
Jetzt können Sie in VSC unter Terminal ein neues Terminal-Fenster öffnen und mit dem Docker Container arbeiten.

image

© 2023 Yannick Mueller, Ewan Joseph Waldmann, Levin Schaller