mirror of
https://codeberg.org/forgejo/forgejo
synced 2024-11-25 03:06:10 +01:00
81 lines
4.3 KiB
Markdown
81 lines
4.3 KiB
Markdown
|
---
|
||
|
|
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.
|