@@ -12,11 +12,7 @@ For at udvikle på dette projekt skal du have følgende software installeret og
12
12
13
13
1 . ** Docker** :
14
14
- Docker er nødvendigt for at bygge og køre containerne, der er defineret i compose.yaml-filen.
15
- - Installer Docker ved at følge instruktionerne for dit operativsystem:
16
- - [ Docker til Linux] ( https://docs.docker.com/engine/install/ )
17
- - [ Docker til Windows] ( https://docs.docker.com/docker-for-windows/install/ )
18
- - [ Docker til Mac] ( https://docs.docker.com/docker-for-mac/install/ )
19
- - Bekræft installationen ved at køre:
15
+ - Bekræft installationen er ok, ved at køre:
20
16
``` sh
21
17
docker --version
22
18
```
@@ -31,10 +27,6 @@ For at udvikle på dette projekt skal du have følgende software installeret og
31
27
32
28
3. ** Git** :
33
29
- Git er nødvendigt for versionskontrol og for at klone projektets repository.
34
- - Installer Git ved at følge instruktionerne for dit operativsystem:
35
- - [Git til Linux](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git#Installing-on-Linux)
36
- - [Git til Windows](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git#Installing-on-Windows)
37
- - [Git til Mac](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git#Installing-on-macOS)
38
30
- Bekræft installationen ved at køre:
39
31
` ` ` sh
40
32
git --version
@@ -50,8 +42,7 @@ git clone https://github.com/OS2borgerPC/os2borgerpc-admin-site.git
50
42
51
43
# ## Kørsel af projektet
52
44
53
- Kør projektet ved hjælp af Docker Compose. Naviger til projektmappen og eksekver kommandoen ` docker compose up` :
54
-
45
+ Kør projektet ved hjælp af Docker Compose.
55
46
` ` ` sh
56
47
cd os2borgerpc-admin-site
57
48
docker compose up
@@ -72,23 +63,20 @@ http://localhost:9999
72
63
73
64
Som standard kan du logge ind med brugeren ` admin/admin`
74
65
75
- # ## Start forfra
76
- Noget af det bedste ved at arbejde med Docker og Docker compose er at man meget nemt kan kan slette alle sine ændringer og starte forfra.
77
- Her er nogle gode kommandoer man bør kende:
78
66
79
67
# # I gang med udvikling
80
68
81
69
# ## Vælg udviklingsmiljø (IDE)
82
- Hvilket værktøj skal du programmere i, hvis det ikke skal være Notepad ? Et godt bud der er open source og gratis er
83
- Microsofts populære Visual Studio Code (VS Code). Det kan stærkt anbefales.
70
+ Du skal have en editor at programmere i. Et godt bud, der er open source og gratis, er
71
+ Microsofts populære Visual Studio Code (VS Code). Den har god integration til git, og kan stærkt anbefales.
84
72
85
73
# ## Lær Django
86
74
Rygraden i systemet er open source CMS systemet [Django](https://www.djangoproject.com/).
87
75
88
76
Man kan ikke udvikle til OS2BorgerPC Admin uden at sætte sig ind i hvordan en Django app grundlæggende fungerer.
89
- Der er heldigvis gode tutorials tilgængelige: https://www.djangoproject.com/start/
77
+ Der er heldigvis gode tutorials tilgængelige: [ https://www.djangoproject.com/start/](https://www.djangoproject.com/start/)
90
78
91
- Man kan også spørge AI som f. eks. ChatGPT, hvis man har spørgsmål om Django udvikling.
79
+ Man kan også spørge en AI som f. eks. ChatGPT, hvis man har spørgsmål om Django udvikling.
92
80
Svarene er som regel gode og præcise, fordi er der så meget åben dokumentation tilgængelig på nettet.
93
81
94
82
# ## Versionsstyring med Git
@@ -97,7 +85,7 @@ Du løber ind i problemer, når du vil hente ændringer fra upstream.
97
85
98
86
# ## Docker compose tricks
99
87
100
- Docker compose bygger et image og afvikler koden i admin-site mappen.
88
+ Docker compose bygger et image, starter containere og eksekverer koden i admin-site mappen inde i en container .
101
89
102
90
Nogle gange bliver ændringer i koden ikke straks synlige i webgrænsefladen.
103
91
Andre gange vil du bare gerne starte forfra.
@@ -110,9 +98,10 @@ docker compose up --build
110
98
Bygger image på ny i forbindelse med opstart
111
99
112
100
` ` ` sh
101
+ docker compose stop
113
102
docker compose down -v
114
103
` ` `
115
- Sletter alle containerer og volumes - heruden databasen. Dvs. man starter helt forfra.
104
+ Stopper og sletter alle containerer og volumes - heruden databasen. Dvs. man starter helt forfra.
116
105
117
106
118
107
0 commit comments