279 lines
9.9 KiB
Markdown
279 lines
9.9 KiB
Markdown
|
---
|
|||
|
|
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)
|