Gitea - Historique des versions

Ycharbi : Ajout de la section "Éléments de configuration" + remplacement de la balise "source" obsolète

2023-02-24T18:50:41Z

Ajout de la section "Éléments de configuration" + remplacement de la balise "source" obsolète

Ycharbi : /* Installation */ Adaptation de l'utilisateur du programme pour coller aux nouvelles exigences fixées dans le code source du programme.

2022-01-23T18:19:14Z

Installation : Adaptation de l'utilisateur du programme pour coller aux nouvelles exigences fixées dans le code source du programme.

← Version précédente		Version du 23 janvier 2022 à 18:19
Ligne 28 :		Ligne 28 :

	'''Création de l'utilisateur système'''		'''Création de l'utilisateur système'''
	useradd --system --shell /usr/sbin/nologin --home-dir /var/lib/~~gitea~~/ --user-group ~~gitea~~		useradd --system --shell /usr/sbin/nologin --home-dir /var/lib/git/ --user-group git

	'''Préparation de l'arborescence de travail'''		'''Préparation de l'arborescence de travail'''
	mkdir -p /etc/~~gitea~~ /var/lib/~~gitea~~/{custom,data,indexers,public,log}		mkdir -p /etc/git /var/lib/git/{custom,data,indexers,public,log}
	chown -R ~~gitea~~:~~gitea~~ /var/lib/~~gitea~~		chown -R git:git /var/lib/git
	chmod 750 /var/lib/~~gitea~~/{data,indexers,log}		chmod 750 /var/lib/git/{data,indexers,log}
	chown root:~~gitea~~ /etc/~~gitea~~		chown root:git /etc/git
	chmod 770 /etc/~~gitea~~		chmod 770 /etc/git

	'''Initialisation de la configuration'''		'''Initialisation de la configuration'''
	su - ~~gitea~~ -s /bin/sh -c "GITEA_WORK_DIR=/var/lib/~~gitea~~/ /usr/local/bin/gitea web -c /etc/~~gitea~~/app.ini"		su - git -s /bin/sh -c "GITEA_WORK_DIR=/var/lib/git/ /usr/local/bin/gitea web -c /etc/git/app.ini"

	À ce stade, ''Gitea'' écoute sur le port ''HTTP'' 3000. Rendez-vous sur la page d'installation avec un navigateur ''WEB'' pour configurer le contenu du fichier <source lang="bash" inline>/etc/~~gitea~~/app.ini</source>. Vous pouvez ignorer cette étape si vous en avez déjà un.		À ce stade, ''Gitea'' écoute sur le port ''HTTP'' 3000. Rendez-vous sur la page d'installation avec un navigateur ''WEB'' pour configurer le contenu du fichier <source lang="bash" inline>/etc/git/app.ini</source>. Vous pouvez ignorer cette étape si vous en avez déjà un.

	Lors de cette configuration il est possible de changer quelques paramètres. Pour ma part, j'ai choisi de n'autoriser aucun services externes (toutes cases décochées).		Lors de cette configuration il est possible de changer quelques paramètres. Pour ma part, j'ai choisi de n'autoriser aucun services externes (toutes cases décochées).
Ligne 46 :		Ligne 46 :
	Une fois terminé, arrêtez ''Gitea'' via un <source lang="bash" inline><ctrl+c></source> suivit d'un <source lang="bash" inline>pkill gitea</source>.		Une fois terminé, arrêtez ''Gitea'' via un <source lang="bash" inline><ctrl+c></source> suivit d'un <source lang="bash" inline>pkill gitea</source>.

	Pour désactiver la possibilité de s'inscrire (seul l'administrateur peut créer des comptes), il faut passer la valeur <source lang="bash" inline>DISABLE_REGISTRATION</source> du fichier <source lang="bash" inline>/etc/~~gitea~~/app.ini</source> à <source lang="bash" inline>true</source>.		Pour désactiver la possibilité de s'inscrire (seul l'administrateur peut créer des comptes), il faut passer la valeur <source lang="bash" inline>DISABLE_REGISTRATION</source> du fichier <source lang="bash" inline>/etc/git/app.ini</source> à <source lang="bash" inline>true</source>.

	'''Création du service Systemd'''		'''Création du service Systemd'''
Ligne 60 :		Ligne 60 :
	RestartSec=2s		RestartSec=2s
	Type=simple		Type=simple
	User=~~gitea~~		User=git
	Group=~~gitea~~		Group=git
	WorkingDirectory=/var/lib/~~gitea~~/		WorkingDirectory=/var/lib/git/
	ExecStart=/usr/local/bin/gitea web --config /etc/~~gitea~~/app.ini		ExecStart=/usr/local/bin/gitea web --config /etc/git/app.ini
	Restart=always		Restart=always
	Environment=USER=~~gitea~~ HOME=/var/lib/~~gitea~~/ GITEA_WORK_DIR=/var/lib/~~gitea~~		Environment=USER=git HOME=/var/lib/git/ GITEA_WORK_DIR=/var/lib/git

	[Install]		[Install]
Ligne 78 :		Ligne 78 :

	Une fois l'installation terminée, il est conseillé d’interdire l'écriture sur le fichier de configuration de ''Gitea'' :		Une fois l'installation terminée, il est conseillé d’interdire l'écriture sur le fichier de configuration de ''Gitea'' :
	chmod 750 /etc/~~gitea~~		chmod 750 /etc/git
	chmod 644 /etc/~~gitea~~/app.ini		chmod 644 /etc/git/app.ini

	{{astuce\|Il est tout à fait possible d'éditer manuellement cette configuration en écrivant directement dans le fichier <source lang="bash" inline>/etc/~~gitea~~/app.ini</source>.}}		{{astuce\|Il est tout à fait possible d'éditer manuellement cette configuration en écrivant directement dans le fichier <source lang="bash" inline>/etc/git/app.ini</source>.}}

	{{info\|Le premier utilisateur créé sera l'administrateur de ''Gitea''.}}		{{info\|Le premier utilisateur créé sera l'administrateur de ''Gitea''.}}

Ycharbi : Mise à jour de la procédure avec l'évolution de l'outil en 1.14.2.

2021-06-08T15:19:38Z

Mise à jour de la procédure avec l'évolution de l'outil en 1.14.2.

Voir les modifications

Ycharbi : /* Mise à jour de Gitea */ Ajout d'une section traitant du cas particulier de l'encodage "UTF8mb4" depuis la branche 1.14 de Gitea + ajout d'un détail sur l'avancée de la mise à jour + légères corrections de syntaxe.

2021-05-03T18:29:00Z

Mise à jour de Gitea : Ajout d'une section traitant du cas particulier de l'encodage "UTF8mb4" depuis la branche 1.14 de Gitea + ajout d'un détail sur l'avancée de la mise à jour + légères corrections de syntaxe.

← Version précédente		Version du 3 mai 2021 à 18:29
Ligne 91 :		Ligne 91 :

	=Mise à jour de Gitea=		=Mise à jour de Gitea=
	Les mises à jours sont simples puisque il suffit ~~d'arreter~~ le service Gitea avec:		==Routine==
			Les mises à jours sont simples puisque il suffit d’arrêter le service Gitea avec :
	systemctl stop gitea.service		systemctl stop gitea.service

	et de remplacer le binaire <source lang="bash" inline>/usr/local/bin/gitea</source> par le plus récent avant de relancer le service avec:		et de remplacer le binaire <source lang="bash" inline>/usr/local/bin/gitea</source> par le plus récent avant de relancer le service avec :
	systemctl start gitea.service		systemctl start gitea.service

	{{info\|Il faut attendre quelques minutes que le service se lance la première fois~~. J'imagine~~ qu'il ~~met~~ à jour la base de données.}}		{{info\|Il faut attendre quelques minutes que le service se lance la première fois pour qu'il mette à jour la base de données. L'avancée est visible dans le fichier <source lang="bash" inline>/var/lib/gitea/log/gitea.log</source> et doit se conclure par <source lang="bash" inline>NewServer() [I] Starting new Web server: tcp:0.0.0.0:3000 on PID: UN_PID</source>.}}

			==Changement d'encodage UTF-8==
			Depuis le passage à la branche ''1.14'' (passage de la 1.11.4 à la 1.14.1 pour ma part), ''Gitea'' utilise l'encodage <source lang="bash" inline>UTF8mb4</source> de [[:Category:Base_de_données\|MariaDB]] en lieu et place de l'<source lang="bash" inline>UTF8</source>. 767 octets correspondent à 255 caractères en ''UTF8'' et 191 en ''UTF8mb4''. Ceci a pour conséquence de faire échouer la conversion de certaines tables et donc de foutre la merde sévère dans la base (<source lang="bash" inline>Error 1071: Specified key was too long; max key length is 767 bytes</source>). ''Gitea'' est alors pété et ne démarre plus... Pour prévenir ça, il faut (avant la migration - possible pendant si vous êtes rapide), arrêter le service comme expliqué supra, remplacer le binaire par la nouvelle version ET exécuter les actions suivantes (comme expliqué dans ce [https://github.com/go-gitea/gitea/issues/15540 ticket]) en utilisateur ''root MariaDB'' :

			<source lang="sql">
			SET GLOBAL innodb_file_format=Barracuda;
			SET GLOBAL innodb_file_per_table=1;
			SET GLOBAL innodb_large_prefix=1;
			</source>

			Vous pouvez alors relancer le service pour exécuter la mise à jour normalement.

	=Utilisation=		=Utilisation=

Ycharbi : Correction d'une erreur de coloration syntaxique.

2020-10-09T11:51:34Z

Correction d'une erreur de coloration syntaxique.

← Version précédente		Version du 9 octobre 2020 à 11:51
Ligne 11 :		Ligne 11 :

	'''Création de la base et de l'utilisateur exploitant'''		'''Création de la base et de l'utilisateur exploitant'''
	<source lang=mysql">		<source lang="mysql">
	CREATE DATABASE gitea;		CREATE DATABASE gitea;
	GRANT all privileges on gitea.* to 'gitea'@'localhost' identified by 'gitea';		GRANT all privileges on gitea.* to 'gitea'@'localhost' identified by 'gitea';

Ycharbi : /* Mise à jour de Gitea */ Ajout d'une précision.

2020-04-12T16:53:42Z

Mise à jour de Gitea : Ajout d'une précision.

← Version précédente		Version du 12 avril 2020 à 16:53
Ligne 93 :		Ligne 93 :
	Les mises à jours sont simples puisque il suffit d'arreter le service Gitea avec:		Les mises à jours sont simples puisque il suffit d'arreter le service Gitea avec:
	systemctl stop gitea.service		systemctl stop gitea.service

	et de remplacer le binaire <source lang="bash" inline>/usr/local/bin/gitea</source> par le plus récent avant de relancer le service avec:		et de remplacer le binaire <source lang="bash" inline>/usr/local/bin/gitea</source> par le plus récent avant de relancer le service avec:
	systemctl start gitea.service		systemctl start gitea.service

			{{info\|Il faut attendre quelques minutes que le service se lance la première fois. J'imagine qu'il met à jour la base de données.}}

	=Utilisation=		=Utilisation=

Ycharbi : /* Installation */ Correction de la requête SQL + Francisation du service Systemd.

2019-02-11T11:21:24Z

Installation : Correction de la requête SQL + Francisation du service Systemd.

← Version précédente		Version du 11 février 2019 à 11:21
Ligne 12 :		Ligne 12 :
	'''Création de la base et de l'utilisateur exploitant'''		'''Création de la base et de l'utilisateur exploitant'''
	<source lang=mysql">		<source lang=mysql">
	CREATE DATABASE gitea		CREATE DATABASE gitea;
	GRANT all privileges on gitea.* to 'gitea'@'localhost' identified by 'gitea';		GRANT all privileges on gitea.* to 'gitea'@'localhost' identified by 'gitea';
	~~quit~~
	</source>		</source>

Ligne 40 :		Ligne 39 :
	<source lang="bash">		<source lang="bash">
	[Unit]		[Unit]
	Description=Gitea (Git ~~with a cup of tea~~)		Description=Gitea (Git avec une tasse de thé)
	After=syslog.target		After=syslog.target
	After=network.target		After=network.target
Ligne 46 :		Ligne 45 :

	[Service]		[Service]
	# ~~Modify these two values and uncomment them if you have~~		# Modifiez ces deux valeurs et dé-commentez-les si vous avez
	# ~~repos with lots of files and get an~~ HTTP ~~error~~ 500 ~~because~~		# un dépôt avec beaucoup de fichiers et que vous avez
	~~# of that~~		# une erreur HTTP 500 à cause de ça
	###		###
	#LimitMEMLOCK=infinity		#LimitMEMLOCK=infinity
Ligne 60 :		Ligne 59 :
	Restart=always		Restart=always
	Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea		Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
	# ~~If you want to bind Gitea to a~~ port ~~below~~ 1024 ~~uncomment~~		# Si vous voulez rediriger Getea vers un port inferieur à 1024, dé-commentez
	# ~~the two values below~~		# les deux valeurs suivante
	###		###
	#CapabilityBoundingSet=CAP_NET_BIND_SERVICE		#CapabilityBoundingSet=CAP_NET_BIND_SERVICE

Ycharbi : Page créée avec « Category:service_git Gitea est une forge logiciel libre à source ouverte et une branche de [https://gogs.io/ Gogs]. C'est un logiciel écrit en [https://fr.wikipedia... »

2019-02-10T15:10:44Z

Page créée avec « Category:service_git Gitea est une forge logiciel libre à source ouverte et une branche de [https://gogs.io/ Gogs]. C'est un logiciel écrit en [https://fr.wikipedia... »

Nouvelle page

[[Category:service_git]]

Gitea est une forge logiciel libre à source ouverte et une branche de [https://gogs.io/ Gogs]. C'est un logiciel écrit en [https://fr.wikipedia.org/wiki/Go_(langage) Go] et une alternative auto-hébergeable à Github qui se veut plus légère que Gitlab tant en terme de consommation de ressources qu'en fonctionnalités.

=Installation=
'''Installation des dépendances'''
apt install mariadb-server git dirmngr

==Préparation de la base de données==
mariadb -u root

'''Création de la base et de l'utilisateur exploitant'''
<source lang=mysql">
CREATE DATABASE gitea
GRANT all privileges on gitea.* to 'gitea'@'localhost' identified by 'gitea';
quit
</source>

==Installation de Gitea==
'''Téléchargement de Gitea'''
wget https://dl.gitea.io/gitea/1.7.1/gitea-1.7.1-linux-amd64.xz

'''Décompression de Gitea'''
unxz gitea-1.7.1-linux-amd64.xz

'''Mise à disposition du binaire'''
mv gitea-1.7.1-linux-amd64 /usr/local/bin/gitea
chmod +x /usr/local/bin/gitea

'''Préparation de l'arborescence de travail'''
mkdir -p /etc/gitea /var/lib/gitea/{custom,data,indexers,public,log}
chown git:git /var/lib/gitea/{data,indexers,log}
chmod 750 /var/lib/gitea/{data,indexers,log}
chown root:git /etc/gitea
chmod 770 /etc/gitea

'''Création du service Systemd'''
vim /etc/systemd/system/gitea.service

<source lang="bash">
[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target
After=mysql.service

[Service]
# Modify these two values and uncomment them if you have
# repos with lots of files and get an HTTP error 500 because
# of that
###
#LimitMEMLOCK=infinity
#LimitNOFILE=65535
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
# If you want to bind Gitea to a port below 1024 uncomment
# the two values below
###
#CapabilityBoundingSet=CAP_NET_BIND_SERVICE
#AmbientCapabilities=CAP_NET_BIND_SERVICE

[Install]
WantedBy=multi-user.target
</source>

systemctl daemon-reload
systemctl restart gitea
systemctl enable gitea
systemctl status gitea

La suite de l'installation se fait via l'interface Web. J'ai utilisé pour mon usage personnel le proxy inverse [[Haproxy]] avec un certificat [[Letsencrypt]] mais on verra bien souvent [[Nginx]] pour cet usage. Si vous n'utilisez pas de proxy inverse, le service est accessible via sont IP avec le port 3000.

Lors de cette configuration il est possible de changer quelques paramètres. Pour ma part, j'ai choisi de désactiver la possibilité de s'inscrire (seul l'administrateur peut créer des comptes) ainsi que de désactiver Gravatar et OpenID.

{{astuce|Il est tout à fait possible d'éditer manuellement cette configuration en écrivant directement dans le fichier <source lang="bash" inline>/etc/gitea/app.ini</source>.}}

{{info|Le premier utilisateur créé sera l'administrateur de Gitea.}}

Une fois l'installation terminée, il est conseillé d’interdire l'écriture sur le fichier de configuration de Gitea:
chmod 750 /etc/gitea
chmod 644 /etc/gitea/app.ini

==Sources de la section==
* https://docs.gitea.io/fr-fr/
* https://computingforgeeks.com/how-to-install-gitea-self-hosted-git-service-on-ubuntu-18-04-ubuntu-16-04/

=Mise à jour de Gitea=
Les mises à jours sont simples puisque il suffit d'arreter le service Gitea avec:
systemctl stop gitea.service
et de remplacer le binaire <source lang="bash" inline>/usr/local/bin/gitea</source> par le plus récent avant de relancer le service avec:
systemctl start gitea.service

=Utilisation=
==Création d'un dépôt==
La création d'un nouveau dépôt s'effectue via le bouton "'''+'''" en haut à droite de l'interface utilisateur. À la fin du formulaire, un choix vous est laissé d'initialiser ou pas le dépôt. Si vous laissez Gitea l'initialiser, il va tout créer pour vous, sinon vous devrez faire ces quelques étapes à la main. Après avoir renseigné les informations demandées et dans le cas d'une non initialisation automatique. les instructions suivantes sont données pour la création en local des fichiers et envoi au serveur via Git:

'''Création d'un nouveau dépôt en ligne de commande'''
<source lang="bash">
touch README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin http://localhost:3000/yohan/Test.git
git push -u origin master
</source>

'''Soumission d'un dépôt existant par ligne de commande'''
<source lang="bash">
git remote add origin http://localhost:3000/yohan/Test.git
git push -u origin master
</source>

Gitea - Historique des versions

Ycharbi : Ajout de la section "Éléments de configuration" + remplacement de la balise "source" obsolète

Ycharbi : /* Installation */ Adaptation de l'utilisateur du programme pour coller aux nouvelles exigences fixées dans le code source du programme.

Ycharbi : Mise à jour de la procédure avec l'évolution de l'outil en 1.14.2.

Ycharbi : /* Mise à jour de Gitea */ Ajout d'une section traitant du cas particulier de l'encodage "UTF8mb4" depuis la branche 1.14 de Gitea + ajout d'un détail sur l'avancée de la mise à jour + légères corrections de syntaxe.

Ycharbi : Correction d'une erreur de coloration syntaxique.

Ycharbi : /* Mise à jour de Gitea */ Ajout d'une précision.

Ycharbi : /* Installation */ Correction de la requête SQL + Francisation du service Systemd.

Ycharbi : Page créée avec « Category:service_git Gitea est une forge logiciel libre à source ouverte et une branche de [https://gogs.io/ Gogs]. C'est un logiciel écrit en [https://fr.wikipedia... »