1---
2date: "2017-08-23T09:00:00+02:00"
3title: "Installation avec Docker"
4slug: "install-with-docker"
5weight: 10
6toc: false
7draft: false
8menu:
9  sidebar:
10    parent: "installation"
11    name: "Docker"
12    weight: 10
13    identifier: "install-with-docker"
14---
15
16# Installation avec Docker
17
18Nous fournissons des images Docker mises à jour automatiquement via le Docker Hub de notre organisation. C'est à vous, lors devotre déploiement, de vous assurez d'utiliser toujours la dernière version stable ou d'utiliser un autre service qui met à jour l'image Docker pour vous.
19
20{{< toc >}}
21
22## Données stockées sur l'hôte
23
24Tout d'abord, vous devez simplement récupérer l'image Docker avec la commande suivante :
25
26```
27docker pull gitea/gitea:latest
28```
29
30Pour garder vos dépôts et certaines autres données persistantes, vous devez créer un répertoire qui contiendra ces données à l'avenir.
31
32```
33sudo mkdir -p /var/lib/gitea
34```
35
36Il est temps de démarrer votre instance Docker, c'est un processus assez simple. Vous avez à définir le mappage des ports et le volume à utiliser pour la persistance de vos données :
37
38```
39docker run -d --name=gitea -p 10022:22 -p 10080:3000 -v /var/lib/gitea:/data gitea/gitea:latest
40```
41
42Vous devriez avoir une instance fonctionnelle de Gitea. Pour accèder à l'interface web, visitez l'adresse http://hostname:10080 avec votre navigateur web préféré. Si vous voulez clôner un dépôt, vous pouvez le faire avec la commande  `git clone ssh://git@hostname:10022/username/repo.git`.
43
44## Named Volumes
45
46Ce guide aboutira à une installation avec les données Gita et PostgreSQL stockées dans des volumes nommés. Cela permet une sauvegarde, une restauration et des mises à niveau en toute simplicité.
47
48### The Database
49
50Création du volume nommé pour la base de données :
51
52```
53$ docker volume create --name gitea-db-data
54```
55
56Une fois votre volume pret, vous pouvez récupérer l'image Docker de PostgreSQL et créer une instance. Tout comme Gitea, c'est également une image Docker basée sur Alpine Linux, Le montage des données se fera sans aucun problème.
57
58```
59$ docker pull postgres:alpine
60$ docker run -d --name gitea-db \
61    -e POSTGRES_PASSWORD=<PASSWORD> \
62    -v gitea-db-data:/var/lib/postgresql/data \
63    -p 5432:5432 \
64    postgres:alpine
65```
66
67Maintenant que la base de données est démarrée, il faut la configurer. N'oubliez pas le mot de passe que vous avez choisi, vous en aurez besoin lors de l'installation de Gitea.
68
69```
70$ docker exec -it gitea-db psql -U postgres
71psql (9.6.1)
72Type "help" for help.
73
74postgres=# CREATE USER gitea WITH PASSWORD '<PASSWORD>';
75CREATE ROLE
76postgres=# CREATE DATABASE gitea OWNER gitea;
77CREATE DATABASE
78postgres=# \q
79$
80```
81
82### Gitea
83
84Premièrement, le volume nommé :
85
86```
87$ docker volume create --name gitea-data
88```
89
90Puis l'instance de Gitea :
91
92```
93$ docker run -d --name gitea \
94	--link gitea-db:gitea-db \
95	--dns 10.12.10.160 \
96	-p 11180:3000 \
97	-p 8322:22 \
98	-v gitea-data:/data \
99	gitea/gitea:latest
100```
101
102Vous devriez maintenant avoir deux conteneurs Docker pour Gitea et PostgreSQL plus deux volumes nommés Docker.
103
104# Personnalisation
105
106Les fichier personnalisés ([voir les instructions](https://docs.gitea.io/en-us/customizing-gitea/)) peuvent être placés dans le répertoire `/data/gitea`.
107
108Le fichier de configuration sera sauvegardé à l'emplacement suivant : `/data/gitea/conf/app.ini`
109
110## Il manque quelque chose ?
111
112Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/Gitea), vous obtiendrez des réponses à toute vos questions assez rapidement.
113