French translation for docs (#3030)
original PR go-gitea/docs#147 and author @0xbaadf00dtokarchuk/v1.17
techknowlogick
7 years ago
committed by
Lunny Xiao
parent
d517b56682
commit
474dfcc798
@ -0,0 +1,13 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Avancé" |
||||
slug: "advanced" |
||||
weight: 30 |
||||
toc: false |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
name: "Avancé" |
||||
weight: 40 |
||||
identifier: "advanced" |
||||
--- |
||||
@ -0,0 +1,44 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Make" |
||||
slug: "make" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
parent: "advanced" |
||||
name: "Make" |
||||
weight: 30 |
||||
identifier: "make" |
||||
--- |
||||
|
||||
# Make |
||||
|
||||
Gitea fait largement usage de Make pour automatiser les tâches et avoir un développement plus rapide. Ce guide explique comment installer Make. |
||||
|
||||
### Linux |
||||
|
||||
Vous pouvez installer Make avec votre gestionnaire de paquetages |
||||
|
||||
Depuis Ubuntu/Debian: |
||||
|
||||
```bash |
||||
sudo apt-get install build-essential |
||||
``` |
||||
|
||||
Depuis Fedora/RHEL/CentOS: |
||||
|
||||
```bash |
||||
sudo yum install make |
||||
``` |
||||
|
||||
### Windows |
||||
|
||||
Si vous utilisez Windows, vous pouvez télécharger une des versions suivantes de Make: |
||||
|
||||
- [Simple binaire](http://www.equation.com/servlet/equation.cmd?fa=make). Copiez le quelque part et mettez à jour `PATH`. |
||||
- [32-bits version](ftp://ftp.equation.com/make/32/make.exe) |
||||
- [64-bits version](ftp://ftp.equation.com/make/64/make.exe) |
||||
- [MinGW](http://www.mingw.org/) includes a build. The binary is called `mingw32-make.exe` instead of `make.exe`. Add the `bin` folder to your `PATH`. |
||||
- [Chocolatey package](https://chocolatey.org/packages/make). Run `choco install make` |
||||
@ -0,0 +1,13 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Installation" |
||||
slug: "installation" |
||||
weight: 10 |
||||
toc: false |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
name: "Installation" |
||||
weight: 10 |
||||
identifier: "installation" |
||||
--- |
||||
@ -0,0 +1,45 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Installation avec le binaire pré-compilé" |
||||
slug: "install-from-binary" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "Binaire pré-compilé" |
||||
weight: 20 |
||||
identifier: "install-from-binary" |
||||
--- |
||||
|
||||
# Installation avec le binaire pré-compilé |
||||
|
||||
Tous les binaires sont livrés avec le support de SQLite, MySQL et PostgreSQL, et sont construits avec les ressources incorporées. Gardez à l'esprit que cela peut être différent pour les versions antérieures. L'installation basée sur nos binaires est assez simple, il suffit de choisir le fichier correspondant à votre plateforme à partir de la [page de téléchargement](https://dl.gitea.io/gitea). Copiez l'URL et remplacer l'URL dans les commandes suivantes par la nouvelle: |
||||
|
||||
``` |
||||
wget -O gitea https://dl.gitea.io/gitea/1.0.1/gitea-1.0.1-linux-amd64 |
||||
chmod +x gitea |
||||
``` |
||||
|
||||
## Test |
||||
|
||||
Après avoir suivi les étapes ci-dessus, vous aurez un binaire `gitea` dans votre répertoire de travail. En premier lieu, vous pouvez tester si le binaire fonctionne comme prévu et ensuite vous pouvez le copier vers la destination où vous souhaitez le stocker. Lorsque vous lancez Gitea manuellement à partir de votre CLI, vous pouvez toujours le tuer en appuyant sur `Ctrl + C`. |
||||
|
||||
``` |
||||
./gitea web |
||||
``` |
||||
|
||||
## Dépannage |
||||
|
||||
### Anciennes version de glibc |
||||
|
||||
Les anciennes distributions Linux (comme Debian 7 ou CentOS 6) peuvent ne pas être capable d'exécuter le binaire Gitea, résultant généralement une erreur du type ```./gitea: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.14' not found (required by ./gitea)```. Cette erreur est due au driver SQLite que nous intégrons dans le binaire Gitea. Dans le futur, nous fournirons des binaires sans la dépendance pour la bibliothèque glibc. En attendant, vous pouvez mettre à jour votre distribution ou installer Gitea depuis le [code source]({{< relref "from-source.fr-fr.md" >}}). |
||||
|
||||
### Exécuter Gitea avec un autre port |
||||
|
||||
Si vous obtenez l'erreur `702 runWeb()] [E] Failed to start server: listen tcp 0.0.0.0:3000: bind: address already in use`, Gitea à besoin d'utiliser un autre port. Vous pouvez changer le port par défaut en utilisant `./gitea web -p $PORT`. |
||||
|
||||
## Il manque quelque chose ? |
||||
|
||||
Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement. |
||||
@ -0,0 +1,57 @@ |
||||
--- |
||||
date: "2016-12-01T16:00:00+02:00" |
||||
title: "Installation depuis le gestionnaire de paquets" |
||||
slug: "install-from-package" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "Gestionnaire de paquets" |
||||
weight: 20 |
||||
identifier: "install-from-package" |
||||
--- |
||||
|
||||
# Installation depuis le gestionnaire de paquets |
||||
|
||||
## Linux |
||||
|
||||
Nous n'avons pas encore publié de paquet pour Linux, nous allons mettre à jour cette page directement lorsque nous commencerons à publier des paquets pour toutes distributions Linux. En attendant, vous devriez suivre les [instructions d'installation]({{< relref "from-binary.fr-fr.md" >}}) avec le binaire pré-compilé. |
||||
|
||||
## Windows |
||||
|
||||
Nous n'avons pas encore publié de paquet pour Windows, nous allons mettre à jour cette page directement lorsque nous commencerons à publier des paquets sous la forme de fichiers `MSI` ou via [Chocolatey](https://chocolatey.org/). En attendant, vous devriez suivre les [instructions d'installation]({{< relref "from-binary.fr-fr.md" >}}) avec le binaire pré-compilé. |
||||
|
||||
## macOS |
||||
|
||||
Actuellement, nous ne supportons que l'installation via `brew` pour macOS. Si vous n'utilisez pas [Homebrew](http://brew.sh/), vous pouvez suivre les [instructions d'installation]({{< relref "from-binary.fr-fr.md" >}}) avec le binaire pré-compilé. Pour installer Gitea depuis `brew`, utilisez les commandes suivantes : |
||||
|
||||
``` |
||||
brew tap go-gitea/gitea |
||||
brew install gitea |
||||
``` |
||||
|
||||
## FreeBSD |
||||
|
||||
Le portage FreeBSD `www/gitea` est disponible. Vous pouvez également installer le paquet pré-compilé avec la commande suivante: |
||||
|
||||
``` |
||||
pkg install gitea |
||||
``` |
||||
|
||||
Pour une version plus récente, ou pour les instructions de compilations, veuillez consulter la documentation officielle de FreeBSD : [install it from the port](https://www.freebsd.org/doc/handbook/ports-using.html) |
||||
|
||||
``` |
||||
su - |
||||
cd /usr/ports/www/gitea |
||||
make install clean |
||||
``` |
||||
|
||||
Le port utilise la schéma standard du système de fichiers FreeBSD : Les fichiers de configuration sont localisés dans le répertoire `/usr/local/etc/gitea`, les modèles, options, plugins et thèmes sont localisés dans le répertoire `/usr/local/share/gitea`, et le script de démarrage se situe dans `/usr/local/etc/rc.d/gitea`. |
||||
|
||||
Pour exécuter Gitea en tant que service, utilisez la commande `sysrc gitea_enable=YES` et la commande `service gitea start` pour démarrer le service. |
||||
|
||||
## Il manque quelque chose ? |
||||
|
||||
Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement. |
||||
@ -0,0 +1,80 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Installation depuis le code source" |
||||
slug: "install-from-source" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "Code source" |
||||
weight: 30 |
||||
identifier: "install-from-source" |
||||
--- |
||||
|
||||
# Installation depuis le code source |
||||
|
||||
Nous ne couvrirons pas les bases de la configuration de Golang dans ce guide. Si vous ne savez pas comment démarrer un environnement fonctionnel, vous devrez suivre les [instructions d'installation](https://golang.org/doc/install) officielles. |
||||
|
||||
**Attention**: La version 1.7 ou suppérieur de Go est nécessaire |
||||
|
||||
## Téléchargement |
||||
|
||||
Tout d'abord, vous devez récupérer le code source, la manière la plus simple est d'utiliser directement Go. Il suffit d'appeler les commandes suivantes pour récupérer le code source et passer au répertoire de travail. |
||||
|
||||
``` |
||||
go get -d -u code.gitea.io/gitea |
||||
cd $GOPATH/src/code.gitea.io/gitea |
||||
``` |
||||
|
||||
Maintenant, il est temps de décider quelle version de Gitea vous souhaitez compiler et installer. Actuellement, ils existent plusieurs options possibles. Si vous voulez compiler notre branche `master`, vous pouvez directement passer à la [section compilation](#compilation), cette branche représente la dernière version en cours de développement et n'a pas vocation à être utiliser en production. |
||||
|
||||
|
||||
Si vous souhaitez compiler la dernière version stable, utilisez les étiquettes ou les différentes branches disponibles. Vous pouvez voir les branches disponibles et comment utiliser cette branche avec ces commandes: |
||||
|
||||
``` |
||||
git branch -a |
||||
git checkout v1.0 |
||||
``` |
||||
|
||||
Si vous souhaitez valider une demande d'ajout (_Pull request_), vous devez activer cette branche en premier : |
||||
|
||||
``` |
||||
git fetch origin pull/xyz/head:pr-xyz # xyz is PR value |
||||
``` |
||||
|
||||
Enfin, vous pouvez directement utiliser les versions étiquettées (ex : `v1.0.0`). Pour utiliser les étiquettes, vous devez lister les étiquettes disponibles et choisir une étiquette spécifique avec les commandes suivantes : |
||||
|
||||
``` |
||||
git tag -l |
||||
git checkout v1.0.0 |
||||
git checkout pr-xyz |
||||
``` |
||||
|
||||
## Compilation |
||||
|
||||
Comme nous regroupons déjà toutes les bibliothèques requises pour compiler Gitea, vous pouvez continuer avec le processus de compilation lui-même. Nous fournissons diverses [tâches Make](https://github.com/go-gitea/gitea/blob/master/Makefile) pour rendre le processus de construction aussi simple que possible. <a href='{{< relref "doc/advanced/make.fr-fr.md" >}}'>Voyez ici comment obtenir Make</a>. Selon vos besoins, vous pourrez éventuellement ajouter diverses options de compilation, vous pouvez choisir entre ces options : |
||||
|
||||
* `bindata`: Intègre toutes les ressources nécessaires à l'exécution d'une instance de Gitea, ce qui rend un déploiement facile car il n'est pas nécessaire de se préoccuper des fichiers supplémentaires. |
||||
* `sqlite`: Active la prise en charge d'une base de données [SQLite3](https://sqlite.org/), ceci n'est recommandé que pour les petites installations de Gitea. |
||||
* `tidb`: Active la prise en charge d'une base de données [TiDB](https://github.com/pingcap/tidb), c'est une base de données simplet et basée sur des fichiers. Elle est comparable à SQLite. |
||||
* `pam`: Active la prise en charge de PAM (mLinux Pluggable Authentication Modules), très utile si vos utilisateurs doivent être authentifiés avec les comptes du système. |
||||
|
||||
Il est temps de compiler le binaire, nous suggérons d'intégrer les ressources avec l'option de compilation `bindata`. Pour inclure les ressources, vous devrez également exécuter la tâche Make `generate`. Dans le cas échéant, les ressources ne pourront pas être intégrées: |
||||
|
||||
``` |
||||
TAGS="bindata" make generate build |
||||
``` |
||||
|
||||
## Test |
||||
|
||||
Après avoir suivi toutes les étapes, vous devriez avoir le binaire `gitea` dans votre répertoire courant. Dans un premier temps, vous pouvez tester qu'il fonctionne puis, dans un second temps, vous pouvez le copier dans la destination de votre choix. Lorsque vous lancez Gitea manuellement à partir de votre CLI, vous pouvez toujours le tuer en appuyant sur `Ctrl + C`. |
||||
|
||||
``` |
||||
./gitea web |
||||
``` |
||||
|
||||
## Il manque quelque chose ? |
||||
|
||||
Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement. |
||||
@ -0,0 +1,34 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Démarrer en tant que service Windows" |
||||
slug: "windows-service" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "Service Windows" |
||||
weight: 30 |
||||
identifier: "windows-service" |
||||
--- |
||||
|
||||
# Activer un service Windows |
||||
|
||||
Pour activer le service Windows Gitea, ouvrez une `cmd` en tant qu'Administrateur puis utilisez la commande suivante : |
||||
|
||||
``` |
||||
sc create gitea start= auto binPath= ""C:\gitea\gitea.exe" web --config "C:\gitea\custom\conf\app.ini"" |
||||
``` |
||||
|
||||
N'oubliez pas de remplacer `C:\gitea` par le chemin que vous avez utilisez pour votre installation. |
||||
|
||||
Ensuite, ouvrez "Services Windows", puis recherchez le service `gitea`, faites un clique droit et selectionnez "Run". Si tout fonctionne, vous devriez être capable d'accèder à Gitea à l'URL `http://localhost:3000` (ou sur le port configuré si différent de 3000). |
||||
|
||||
## Désactiver un service Windows |
||||
|
||||
Pour désactiver le service Windows Gitea, ouvrez une `cmd` en tant qu'Administrateur puis utilisez la commande suivante : |
||||
|
||||
``` |
||||
sc delete gitea |
||||
``` |
||||
@ -0,0 +1,110 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Installation avec Docker" |
||||
slug: "install-with-docker" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
parent: "installation" |
||||
name: "Docker" |
||||
weight: 10 |
||||
identifier: "install-with-docker" |
||||
--- |
||||
|
||||
# Installation avec Docker |
||||
|
||||
Nous 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. |
||||
|
||||
## Données stockées sur l'hôte |
||||
|
||||
Tout d'abord, vous devez simplement récupérer l'image Docker avec la commande suivante : |
||||
|
||||
``` |
||||
docker pull gitea/gitea:latest |
||||
``` |
||||
|
||||
Pour 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. |
||||
|
||||
``` |
||||
sudo mkdir -p /var/lib/gitea |
||||
``` |
||||
|
||||
Il 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 : |
||||
|
||||
``` |
||||
docker run -d --name=gitea -p 10022:22 -p 10080:3000 -v /var/lib/gitea:/data gitea/gitea:latest |
||||
``` |
||||
|
||||
Vous 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`. |
||||
|
||||
## Named Volumes |
||||
|
||||
Ce 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é. |
||||
|
||||
### The Database |
||||
|
||||
Création du volume nommé pour la base de données : |
||||
|
||||
``` |
||||
$ docker volume create --name gitea-db-data |
||||
``` |
||||
|
||||
Une 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. |
||||
|
||||
``` |
||||
$ docker pull postgres:alpine |
||||
$ docker run -d --name gitea-db \ |
||||
-e POSTGRES_PASSWORD=<PASSWORD> \ |
||||
-v gitea-db-data:/var/lib/postgresql/data \ |
||||
-p 5432:5432 \ |
||||
postgres:alpine |
||||
``` |
||||
|
||||
Maintenant 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. |
||||
|
||||
``` |
||||
$ docker exec -it gitea-db psql -U postgres |
||||
psql (9.6.1) |
||||
Type "help" for help. |
||||
|
||||
postgres=# CREATE USER gitea WITH PASSWORD '<PASSWORD>'; |
||||
CREATE ROLE |
||||
postgres=# CREATE DATABASE gitea OWNER gitea; |
||||
CREATE DATABASE |
||||
postgres=# \q |
||||
$ |
||||
``` |
||||
|
||||
### Gitea |
||||
|
||||
Premièrement, le volume nommé : |
||||
|
||||
``` |
||||
$ docker volume create --name gitea-data |
||||
``` |
||||
|
||||
Puis l'instance de Gitea : |
||||
|
||||
``` |
||||
$ docker run -d --name gitea \ |
||||
--link gitea-db:gitea-db \ |
||||
--dns 10.12.10.160 \ |
||||
-p 11180:3000 \ |
||||
-p 8322:22 \ |
||||
-v gitea-data:/data \ |
||||
gitea/gitea:latest |
||||
``` |
||||
|
||||
Vous devriez maintenant avoir deux conteneurs Docker pour Gitea et PostgreSQL plus deux volumes nommés Docker. |
||||
|
||||
# Personnalisation |
||||
|
||||
Les fichier personnalisés ([voir les instructions](https://docs.gitea.io/en-us/customizing-gitea/)) peuvent être placés dans le répertoire `/data/gitea`. |
||||
|
||||
Le fichier de configuration sera sauvegardé à l'emplacement suivant : `/data/gitea/conf/app.ini` |
||||
|
||||
## Il manque quelque chose ? |
||||
|
||||
Est-ce que nous avons oublié quelque chose sur cette page ? N'hésitez pas à nous contacter sur notre [serveur Discord](https://discord.gg/NsatcWJ), vous obtiendrez des réponses à toute vos questions assez rapidement. |
||||
@ -0,0 +1,13 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Mise à jour" |
||||
slug: "upgrade" |
||||
weight: 10 |
||||
toc: false |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
name: "Mise à jour" |
||||
weight: 20 |
||||
identifier: "upgrade" |
||||
--- |
||||
@ -0,0 +1,80 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Mise à jour depuis Gogs" |
||||
slug: "upgrade-from-gogs" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
menu: |
||||
sidebar: |
||||
parent: "upgrade" |
||||
name: "Depuis Gogs" |
||||
weight: 10 |
||||
identifier: "upgrade-from-gogs" |
||||
--- |
||||
|
||||
# Mise à jour depuis Gogs |
||||
|
||||
À partir de la version 0.9.146 (schéma de la base de données : version 15) de Gogs, Il est possible de migrer vers Gitea simplement et sans encombre. |
||||
|
||||
Veuillez suivre les étapes ci-dessous. Sur Unix, toute les commandes s'exécutent en tant que l'utilisateur utilisé pour votre installation de Gogs : |
||||
|
||||
* Crééer une sauvegarde de Gogs avec la commande `gogs dump`. Le fichier nouvellement créé `gogs-dump-[timestamp].zip` contient toutes les données de votre instance de Gogs. |
||||
* Téléchargez le fichier correspondant à votre plateforme à partir de la [page de téléchargements](https://dl.gitea.io/gitea). |
||||
* Mettez la binaire dans le répertoire d'installation souhaité. |
||||
* Copiez le fichier `gogs/custom/conf/app.ini` vers `gitea/custom/conf/app.ini`. |
||||
* Si vous avez personnalisé les répertoires `templates, public` dans `gogs/custom/`, copiez-les vers `gitea/custom/`. |
||||
* Si vous avez d'autres répertoires personnalisés comme `gitignore, label, license, locale, readme` dans `gogs/custom/conf` copiez-les vers `gitea/custom/options`. |
||||
* Copiez le répertoire `gogs/data/` vers `gitea/data/`. |
||||
* Vérifiez votre installation en exécutant Gitea avec la commande `gitea web`. |
||||
* Connectez vous au panel d'administration de Gitea et exécutez l'action `Rewrite '.ssh/authorized_keys' file`, puis l'action `Rewrite all update hook of repositories` (obligatoire si le chemin menant à votre configuration personnalisée à changé). |
||||
|
||||
### Modifier les informations spécifiques de gogs |
||||
|
||||
* Renommez `gogs-repositories/` vers `gitea-repositories/` |
||||
* Renommez `gogs-data/` to `gitea-data/` |
||||
* Dans votre fichier `gitea/custom/conf/app.ini`, modifiez les éléments suivants: |
||||
|
||||
DE : |
||||
``` |
||||
[database] |
||||
PATH = /home/:USER/gogs/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gogs-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gogs-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gogs/log |
||||
``` |
||||
|
||||
VERS : |
||||
``` |
||||
[database] |
||||
PATH = /home/:USER/gitea/data/:DATABASE.db |
||||
[attachment] |
||||
PATH = /home/:USER/gitea-data/attachments |
||||
[picture] |
||||
AVATAR_UPLOAD_PATH = /home/:USER/gitea-data/avatars |
||||
[log] |
||||
ROOT_PATH = /home/:USER/gitea/log |
||||
``` |
||||
|
||||
* Vérifiez votre installation en exécutant Gitea avec la commande `gitea web`. |
||||
|
||||
### Dépannage |
||||
|
||||
* Si vous rencontrez des erreurs relatives à des modèles personnalisés dans le dossier `gitea/custom/templates`, essayez de déplacer un par un les modèles provoquant les erreurs. Il est possible qu'ils ne soient pas compatibles avec Gitea. |
||||
|
||||
### Démarrer automatiquement Gitea (Unix) |
||||
|
||||
Distributions utilisant systemd: |
||||
|
||||
* Copiez le script mis à jour vers `/etc/systemd/system/gitea.service` |
||||
* Ajoutez le service avec la commande `sudo systemctl enable gitea` |
||||
* Désactivez Gogs avec la commande `sudo systemctl disable gogs` |
||||
|
||||
Distributions utilisant SysVinit: |
||||
|
||||
* Copiez le script mis à jour vers `/etc/init.d/gitea` |
||||
* Ajoutez le service avec la commande `sudo rc-update add gitea` |
||||
* Désactivez Gogs avec la commande `sudo rc-update del gogs` |
||||
@ -0,0 +1,278 @@ |
||||
--- |
||||
date: "2017-08-23T09:00:00+02:00" |
||||
title: "Documentation" |
||||
slug: "documentation" |
||||
weight: 10 |
||||
toc: true |
||||
draft: false |
||||
--- |
||||
|
||||
# A propos de Gitea |
||||
|
||||
Gitea est un service Git auto-hébergé très simple à installer et à utiliser. Il est similaire à GitHub, Bitbucket ou Gitlab. Le développement initial provient sur [Gogs] (http://gogs.io), mais nous l'avons forké puis renommé Gitea. Si vous souhaitez en savoir plus sur les raisons pour lesquelles nous avons fait cela, lisez [cette publication] (https://blog.gitea.io/2016/12/welcome-to-gitea/) sur le blog. |
||||
|
||||
## Objectif |
||||
|
||||
Le but de ce projet est de fournir de la manière la plus simple, la plus rapide et sans complication un service Git auto-hébergé. Grâce à Go, cela peut se faire via un binaire indépendant fonctionnant sur toutes les plateformes que Go prend en charge, y compris Linux, macOS et Windows, même sur des architectures comme ARM ou PowerPC. |
||||
|
||||
## Fonctionalités |
||||
|
||||
- Tableau de bord de l'utilisateur |
||||
- Choix du contexte (organisation ou utilisateur actuel) |
||||
- Chronologie de l'activité |
||||
- Révisions (_Commits_) |
||||
- Tickets |
||||
- Demande d'ajout (_Pull request_) |
||||
- Création de dépôts |
||||
- Liste des dépôts |
||||
- Liste de vos organisations |
||||
- Liste des dépôts miroires |
||||
- Tableau de bord des tickets |
||||
- Choix du contexte (organisation ou utilisateur actuel) |
||||
- Filtres |
||||
- Ouvert |
||||
- Fermé |
||||
- Vos dépôts |
||||
- Tickets assignés |
||||
- Vos tickets |
||||
- Dépôts |
||||
- Options de tri |
||||
- Plus vieux |
||||
- Dernière mise à jour |
||||
- Nombre de commentaires |
||||
- Tableau de bord des demandes d'ajout |
||||
- Identique au tableau de bord des tickets |
||||
- Types de dépôt |
||||
- Miroire |
||||
- Normal |
||||
- Migré |
||||
- Notifications (courriel et web) |
||||
- Lu |
||||
- Non lu |
||||
- Épinglé |
||||
- Page d'exploration |
||||
- Utilisateurs |
||||
- Dépôts |
||||
- Organisations |
||||
- Moteur de recherche |
||||
- Interface personnalisables |
||||
- Fichiers publiques remplaçables (logo, css, etc) |
||||
- Protection CSRF et XSS |
||||
- Support d'HTTPS |
||||
- Configuration des types et de la taille maximale des fichiers téléversés |
||||
- Journalisation (_Log_) |
||||
- Configuration |
||||
- Base de données |
||||
- MySQL |
||||
- PostgreSQL |
||||
- SQLite3 |
||||
- MSSQL |
||||
- [TiDB](https://github.com/pingcap/tidb) (expérimental) |
||||
- Fichier de configuration |
||||
- Voir [ici](https://github.com/go-gitea/gitea/blob/master/conf/app.ini) |
||||
- Panel d'administration |
||||
- Statistiques |
||||
- Actions |
||||
- Suppression des comptes inactifs |
||||
- Suppression des dépôts archivés |
||||
- Suppression des dépôts pour lesquels il manque leurs fichiers |
||||
- Exécution du _garbage collector_ sur les dépôts |
||||
- Ré-écriture des clefs SSH |
||||
- Resynchronisation des hooks |
||||
- Recreation des dépôts manquants |
||||
- Status du server |
||||
- Temps de disponibilité |
||||
- Mémoire |
||||
- Nombre de goroutines |
||||
- et bien plus... |
||||
- Gestion des utilisateurs |
||||
- Recherche |
||||
- Tri |
||||
- Dernière connexion |
||||
- Méthode d'authentification |
||||
- Nombre maximum de dépôts |
||||
- Désactivation du compte |
||||
- Permissions d'administration |
||||
- Permission pour crééer des hooks |
||||
- Permission pour crééer des organisations |
||||
- Permission pour importer des dépôts |
||||
- Gestion des organisations |
||||
- Membres |
||||
- Équipes |
||||
- Avatar |
||||
- Hooks |
||||
- Gestion des depôts |
||||
- Voir toutes les informations pour un dépôt donné et gérer tous les dépôts |
||||
- Méthodes d'authentification |
||||
- OAuth |
||||
- PAM |
||||
- LDAP |
||||
- SMTP |
||||
- Visualisation de la configuration |
||||
- Tout ce que contient le fichier de configuration |
||||
- Alertes du système |
||||
- Quand quelque chose d'inattendu survient |
||||
- Surveillance |
||||
- Processus courrants |
||||
- Tâches CRON |
||||
- Mise à jour des dépôts miroires |
||||
- Vérification de l'état des dépôts |
||||
- Vérification des statistiques des dépôts |
||||
- Nettoyage des anciennes archives |
||||
- Variables d'environement |
||||
- Options de ligne de commande |
||||
- Internationalisation ([21 langues](https://github.com/go-gitea/gitea/tree/master/options/locale)) |
||||
- Courriel |
||||
- Notifications |
||||
- Confirmation d'inscription |
||||
- Ré-initialisation du mot de passe |
||||
- Support de _reverse proxy_ |
||||
- _subpaths_ inclus |
||||
- Utilisateurs |
||||
- Profil |
||||
- Nom |
||||
- Prénom |
||||
- Courriel |
||||
- Site internet |
||||
- Date de création |
||||
- Abonnés et abonnements |
||||
- Organisations |
||||
- Dépôts |
||||
- Activité |
||||
- Dépôts suivis |
||||
- Paramètres |
||||
- Identiques au profil avec en plus les éléments ci-dessous |
||||
- Rendre l'adresse de courriel privée |
||||
- Avatar |
||||
- Gravatar |
||||
- Libravatar |
||||
- Personnalisé |
||||
- Mot de passe |
||||
- Courriels multiples |
||||
- Clefs SSH |
||||
- Applications connectées |
||||
- Authentification à double facteurs |
||||
- Identités OAuth2 attachées |
||||
- Suppression du compte |
||||
- Dépôts |
||||
- Clone à partir de SSH / HTTP / HTTPS |
||||
- Git LFS |
||||
- Suivre, Voter, Fork |
||||
- Voir les personnes qui suivent, les votes et les forks |
||||
- Code |
||||
- Navigation entre les branches |
||||
- Création ou téléversement de fichier depuis le navigateur |
||||
- URLs pour clôner le dépôt |
||||
- Téléchargement |
||||
- ZIP |
||||
- TAR.GZ |
||||
- Édition en ligne |
||||
- Éditeur Markdown |
||||
- Éditeur de texte |
||||
- Coloration syntaxique |
||||
- Visualisation des Diffs |
||||
- Visualisation |
||||
- Possibilité de choisir où sauvegarder la révision |
||||
- Historiques des fichiers |
||||
- Suppression de fichiers |
||||
- Voir le fichier brut |
||||
- Tickets |
||||
- Modèle de ticket |
||||
- Jalons |
||||
- Étiquettes |
||||
- Affecter des tickets |
||||
- Filtres |
||||
- Ouvert |
||||
- Ferme |
||||
- Personne assignée |
||||
- Créer par vous |
||||
- Qui vous mentionne |
||||
- Tri |
||||
- Plus vieux |
||||
- Dernière mise à jour |
||||
- Nombre de commentaires |
||||
- Moteur de recherche |
||||
- Commentaires |
||||
- Joindre des fichiers |
||||
- Demande d’ajout (_Pull request_) |
||||
- Les mêmes fonctionnalités que pour les tickets |
||||
- Révisions (_Commits_) |
||||
- Representation graphique des révisions |
||||
- Révisions par branches |
||||
- Moteur de recherche |
||||
- Voir les différences |
||||
- Voir les numéro de révision SHA |
||||
- Voir l'auteur |
||||
- Naviguer dans les fichiers d'une révision donnée |
||||
- Publication |
||||
- Pièces jointes |
||||
- Titre |
||||
- Contenu |
||||
- Suppression |
||||
- Définir comme une pré-publication |
||||
- Choix de la branche |
||||
- Wiki |
||||
- Import |
||||
- Éditeur Markdown |
||||
- Paramètres |
||||
- Options |
||||
- Nom |
||||
- Description |
||||
- Privé / Publique |
||||
- Site internet |
||||
- Wiki |
||||
- Activé / Désactivé |
||||
- Interne / externe |
||||
- Tickets |
||||
- Activé / Désactivé |
||||
- Interne / externe |
||||
- URL personnalisable pour une meilleur intégration avec un gestionnaire de tickets externe |
||||
- Activer / désactiver les demandes d'ajout (_Pull request_) |
||||
- Transfert du dépôt |
||||
- Suppression du wiki |
||||
- Suppression du dépôt |
||||
- Collaboration |
||||
- Lecture / Écriture / Administration |
||||
- Branches |
||||
- Branche par défaut |
||||
- Protection |
||||
- Webhooks |
||||
- Git hooks |
||||
- Clefs de déploiement |
||||
|
||||
## Configuration requise |
||||
|
||||
- Un simple Raspberry Pi est assez puissant pour les fonctionnalités de base. |
||||
- Un processeur double coeurs et 1Gb de RAM est une bonne base pour une utilisation en équipe. |
||||
- Gitea est censé être exécuté avec un compte utilisateur dédié et non root, aucun autre mode de fonctionnement n'est pris en charge. (**NOTE**: Dans le cas où vous l'exécutez avec votre propre compte d'utilisateur et que le serveur SSH intégré est désactivé, Gitea modifie le fichier `~ /.ssh /authorized_keys` afin que vous ne soyez **plus capable** de vous connecter interactivement). |
||||
|
||||
## Navigateurs supportés |
||||
|
||||
- Consultez [Semantic UI](https://github.com/Semantic-Org/Semantic-UI#browser-support) pour la liste des navigateurs supportés. |
||||
- La taille minimale supportée officielement est de **1024*768**, l'interface utilisateur peut toujours fonctionner à une taille plus petite, mais ce n'est pas garanti et les problèmes remontés ne seront pas corrigés. |
||||
|
||||
## Composants |
||||
|
||||
* Framework web : [Macaron](http://go-macaron.com/) |
||||
* ORM : [XORM](https://github.com/go-xorm/xorm) |
||||
* Interface graphique : |
||||
* [Semantic UI](http://semantic-ui.com/) |
||||
* [GitHub Octicons](https://octicons.github.com/) |
||||
* [Font Awesome](http://fontawesome.io/) |
||||
* [DropzoneJS](http://www.dropzonejs.com/) |
||||
* [Highlight](https://highlightjs.org/) |
||||
* [Clipboard](https://zenorocha.github.io/clipboard.js/) |
||||
* [Emojify](https://github.com/Ranks/emojify.js) |
||||
* [CodeMirror](https://codemirror.net/) |
||||
* [jQuery Date Time Picker](https://github.com/xdan/datetimepicker) |
||||
* [jQuery MiniColors](https://github.com/claviska/jquery-minicolors) |
||||
* Connecteurs de base de données : |
||||
* [github.com/go-sql-driver/mysql](https://github.com/go-sql-driver/mysql) |
||||
* [github.com/lib/pq](https://github.com/lib/pq) |
||||
* [github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3) |
||||
* [github.com/pingcap/tidb](https://github.com/pingcap/tidb) |
||||
* [github.com/denisenkom/go-mssqldb](https://github.com/denisenkom/go-mssqldb) |
||||
|
||||
## Logiciels et services |
||||
|
||||
- [Drone](https://github.com/drone/drone) (Intégration continue) |
||||
Loading…
Reference in new issue