<h1 id="installation-de-la-vm">Installation de la VM</h1>
<p>“64-bit” dans <strong>“Debian 64-bit”</strong> fait référence à
l’architecture du processeur et du système d’exploitation. Plus
précisément, ça signifie que la version de Debian est conçue pour
fonctionner sur un processeur <strong>64 bits</strong>, qui peut traiter
des instructions et gérer la mémoire de manière plus efficace qu’un
processeur <strong>32 bits</strong>.</p>
<p>Un OS avec une architecture 32 bits ne pourra pas traîter autant de
données qu’un OS fonctionnant sur du 64 bits. Les bits font références à
un type d’architecture informatique dans lequel le processeur et le
système d’exploitation peuvent traiter des données par <strong>morceaux
de 3/64 bits à la fois</strong>. Cela signifie que l’ordinateur peut
traiter des données et effectuer des calculs sur des chiffres de
<strong><a
href="https://canada.lenovo.com/fr/ca/en/glossary/32-bit/">32/64 bits de
long</a></strong>.</p>
<p>A - Configuration réseau utilisée par défaut : Intel Pro/1000 MT
Desktop (NAT)</p>
<p>B - Nom du fichier XML contenant la configuration de la VM :
sae203.vbox</p>
<p>C - On peut changer le nombre de processeurs dans le fichier
sae203.vbox en l’ouvrant avec nano dans un terminal.</p>
<p>Installation de l’OS:</p>
<p><img src="./imgs/accueilDebian.png" style="width:30.0%"
alt="Accueil OS Debian" /> <img src="./imgs/miroir.png"
style="width:30.0%" alt="Paquets miroir Debian" /> <img
src="./imgs/logiciels.png" style="width:30.0%"
alt="Logiciels Debian" /></p>
<h2 id="questions-os">Questions OS :</h2>
<p>Un fichier ISO amorçable est conçu pour <strong>s’exécuter lorsque
vous démarrez votre PC</strong>. Les exemples sont nombreux, mais l’un
d’entre eux concerne l’<a
href="https://www.winzip.com/fr/learn/file-formats/iso/">utilisation
d’un fichier ISO</a> pour installer un système d’exploitation.</p>
<p><a href="https://mate-desktop.org/fr/">MATE</a> est un fork de
<strong>GNOME 2</strong>. Il fournit un environnement de bureau
attractif et intuitif en se basant sur les métaphores traditionnelles
pour GNU/Linux et d’autres systèmes d’exploitation similaires à
Unix.</p>
<p>Chaque fois que vous visitez un site internet, vous vous adressez à
un <a href="https://fr.wikipedia.org/wiki/Serveur_web">serveur web</a>
pour récupérer la page que vous souhaitez consulter. Le serveur répond à
votre requête en envoyant la page à votre ordinateur ou appareil avant
que vous ne puissiez la consulter dans votre navigateur web (aussi
appelé client web).</p>
<p><strong>Secure Shell</strong> (<strong>SSH</strong>) est un protocole
de communication sécurisé. Le protocole de connexion impose un échange
de clés de chiffrement en début de connexion. Par la suite, tous les
segments TCP sont authentifiés et chiffrés. Il devient donc impossible
d’utiliser un analyseur de paquets (sniffer) pour voir ce que fait
l’utilisateur.Le protocole SSH a été conçu avec l’objectif de remplacer
les différents protocoles non chiffrés comme rlogin, telnet, rcp et
rsh.</p>
<p>Un <strong><a href="https://fr.m.wikipedia.org/wiki/Proxy">serveur
mandataire</a></strong> ou <strong>proxy</strong> (de l’anglais) est un
serveur informatique qui a pour fonction de relayer des requêtes entre
un poste client et un serveur. Les serveurs mandataires sont notamment
utilisés pour assurer les fonctions suivantes :</p>
<ul>
<li>la mémoire cache</li>
<li>la journalisation des requêtes (“logging”)</li>
<li>la sécurité du réseau local</li>
<li>le filtrage et l’anonymat</li>
</ul>
<p>L’utilité des serveurs mandataires est importante, notamment dans le
cadre de la sécurisation des systèmes d’information.</p>
<h2 id="préparation-du-système">Préparation du Système</h2>
<ol type="1">
<li>Mettre les droits Sudo à user :</li>
</ol>
<figure>
<img src="./imgs/commandeSudo.png" style="width:50.0%"
alt="Commandes Sudo" />
<figcaption aria-hidden="true">Commandes Sudo</figcaption>
</figure>
<ol start="2" type="1">
<li>Installation des additions guest :</li>
</ol>
<figure>
<img src="./imgs/additionsGuest.png" style="width:50.0%"
alt="additionsGuest" />
<figcaption aria-hidden="true">additionsGuest</figcaption>
</figure>
<p>La commande pour savoir à quel groupe est assigné l’utilisateur est :
<code>groups nom_utilisateur</code></p>
<p>La commande <code>uname -r</code> permet de regarder la version du
noyau linux. (Celle de la VM est 6.1.0-31-amd64.)</p>
<p>Les <strong>suppléments invités</strong> (Guest Additions) sont un
ensemble de pilotes et d’outils fournis par VirtualBox pour améliorer
l’intégration entre l’hôte et la machine virtuelle (VM).</p>
<p>Elles permettent :</p>
<ul>
<li>Une amélioration des performances et de l’affichage avec une
meilleure résolution dynamique.</li>
<li>Une meilleure interaction entre l’hôte et la VM avec entre autre le
partage du presse-papiers et la permission de glisser-déposer de
fichiers.</li>
</ul>
<h3 id="installation-des-suppléments-invités">Installation des
suppléments invités:</h3>
<p>Pour installer les suppléments invités il faut inssérer le disque des
dépendances dans le menu périphérique puis le monter avec la commande
<code>mount</code>.</p>
<p><strong>La commande <code>mount</code>:</strong> Elle sert à monter
un <strong>système de fichiers</strong> (partition, clé USB, disque dur,
ISO…) afin qu’il soit accessible dans l’arborescence du système.<br />
Ici, la comma <strong>Pour Installer ces outils:</strong><br />
- <code>sudo mount /dev/cdrom /mnt</code> <em>Pour monter les fichiers
sur vôtre appareil.</em> - <code>sudo /mnt/VBoxLinuxAdditions.run</code>
<em>Pour éxécuter le script d’installation des outils.</em> -
<code>sudo reboot</code> <em>Pour redémarer le système.</em></p>
<h1 id="à-propos-de-la-distribution-debian">À propos de la distribution
Debian</h1>
<h2 id="documentations">Documentations</h2>
<ul>
<li>https://www.debian.org/doc/</li>
<li>https://debian-fr.org</li>
<li>https://forum-debian.fr</li>
<li>https://debian-facile.org</li>
</ul>
<h2 id="quelques-questions">Quelques Questions</h2>
<p>Le nom <a href="https://wiki.debian.org/DebianName">Debian</a> vient
de Debian = Debra + Ian Lan est le créateur de Debian distribution.Debra
est la copine de Lan. <a
href="https://www.debian.org/doc/manuals/debian-reference/pr01.fr.html#_what_is_debian">Qu’est
ce que Debian ?</a></p>
<p>Le Projet Debian est une association de personnes qui ont fait cause
commune afin de créer un système d’exploitation libre.</p>
<p>Il s’efforce de fournir à tous ses utilisateurs une documentation
facilement accessible et qui est un système d’exploitation libre de
haute qualité englobe les manuels techniques qui décrivent le
fonctionnement et l’utilisation des programmes.</p>
<p>Il existe 3 durées de prise en charge (support) de ces versions, dont
:</p>
<ul>
<li><p>La durée minimale ; Une durée de vie totale d’environ 3 ans
(entre sa publication et la fin des mises à jour de sécurité).</p></li>
<li><p>La durée en support long terme (<a
href="https://wiki.debian.org/fr/LTS?action=fullsearch&amp;context=180&amp;value=time+support&amp;titlesearch=Titres">LTS</a>)
: Debian Long Term Support, pour prise en charge à long terme, est un
projet pour étendre la durée de vie de toutes les versions stables de
Debian à (au moins) 5 ans.</p></li>
<li><p>La durée en support long terme étendue (ELTS) : La prise en
charge à long terme étendue (<a
href="https://wiki.debian.org/LTS/Extended?action=show&amp;redirect=eLTS">ELTS</a>)
est une offre commerciale offrant un prolongement de la durée de vie de
10 ans des versions de Debian. Elle a une structure de 32 bits et ne
pourra pas traîter autant de données qu’un OS fonctionnant sur du 64
bits. Les bits font références à un type d’architecture informatique
dans lequel le processeur et le système d’exploitation peuvent traiter
des données par morceaux.</p></li>
</ul>
<p>Les versions successives de la distribution Debian portent à la fois
un numéro de version traditionnel et des noms de code tirés des
personnages du film Toy Story de Pixar/Disney (1995).<br />
Dès que de nouveaux bogues de sécurité sont décelés dans les paquets,
les responsables Debian et les auteurs amont les corrigent généralement
dans les journées ou les heures suivantes.<br />
Une fois le bogue résolu, un nouveau paquet est fourni sur <a
href="http://security.debian.org">Debian Security</a>.</p>
<p><a
href="https://www.debian.org/doc/manuals/securing-debian-manual/security-update.fr.html">Faire
une mise à jour de sécurité Debian</a></p>
<p>Versions courantes activement maintenues par debian :</p>
<ul>
<li>oldstable - La version précédant la version stable (Bullseye).</li>
<li>stable - La version stable actuelle (Bookworm).</li>
<li>testing - La prochaine version stable (Trixie).</li>
<li>unstable - La version de développement instable (Sid), c’est là que
sont ajoutés les nouveaux paquets ou les nouvelles mises à jour.</li>
</ul>
<p>À tout moment, il y a une version stable de Debian qui est maintenue
par l’équipe de sécurité Debian. Quand une nouvelle version stable sort,
l’équipe de sécurité maintient la version précédente pendant un an
tandis qu’elle maintient aussi la nouvelle version courante. Seule la
version stable est recommandée pour un environnement de
production.<br />
Et donc Debian maintient trois versions activement : la version stable
stable, la version unstable et la version testing.</p>
<p><a
href="https://wiki.debian.org/fr/DebianReleases?highlight=%28version%29%7C%28maintenu%29">Les
versions de Debian</a></p>
<p>Chaque distribution majeur possède un <strong>nom de code</strong>
différent.</p>
<p>Les noms de code des versions de Debian sont inspirés des personnages
du film d’animation “Toy Story”. Cette tradition a été instaurée par
Bruce Perens, qui était responsable du projet Debian à l’époque et
travaillait chez Pixar, le studio derrière “Toy Story”. Par exemple la
branche “unstable” est nommée “Sid” , la branche Old Stable à le nom de
code “Bullseye” (auparavant “woody” le personnage principal du film) et
la Branche testing s’appelle “Trixie”.</p>
<ul>
<li><a href="https://wiki.debian.org/fr/Distributions">Distributions
Debian</a></li>
<li><a
href="https://www.debian.org/doc/manuals/debian-faq/ftparchives.fr.html#sourceforcodenames">FAQ
Debian</a></li>
</ul>
<p>L’un des atouts de Debian fut le nombre d’architecture officiellement
prises en charge.<br />
Par exemple, la version Bullseye prend en charge neuf architectures au
total, dont les suivantes :</p>
<ul>
<li><strong>amd64</strong> pour AMD64 PC 64 bits / Intel EM64T /
x86-64</li>
<li><strong>i386</strong> pour i386 PC 32 bits / Intel IA-32</li>
<li><strong>ppc64el</strong> pour PowerPC 64 bits little-endian
Motorola/IBM PowerPC</li>
<li><strong>s390x</strong> pour S390 64 bits IBM S/390</li>
<li><strong>armel</strong> pour ARM</li>
<li><strong>armhf</strong> pour les anciens matériels ARM et de plus
récentes architectures 32 bits</li>
<li><strong>arm64</strong> pour les architectures ARM 64 bits
Arch64</li>
<li><strong>mipsel</strong> pour MIPS 32 bits little-endian</li>
<li><strong>mips64el</strong> pour MIPS 64 bits little-endian<br />
(Source : https://wiki.debian.org/fr/DebianBullseye#Architectures)</li>
</ul>
<p>Le premier nom de code utilisé fut buzz (Debian 1.1), c’est le
cosmonaute Buzz Lightyear.<br />
Cette version a été publiée le 17 juin 1996 sous le nom de Debian
GNU/Linux 1.1.<br />
Cette version était était totalement en ELF (Executable and Linkable
Format), utilisant le noyau Linux 2.0.</p>
<p>Le derrière nom de code annoncé à ce jour est sid, le garçon des
voisins qui casse tous les jouets dans Toy Story.<br />
Sid est en phase de développement, il n’y a donc pas de date de sortie
annoncée.<br />
La version précédente, le bookworm est sortie le 10 juin 2023.<br />
A savoir que Debian Sid n’a pas de numéro de version, car c’est une
branche en perpétuel développement. Contrairement aux versions stables
de Debian (comme <a
href="https://www.debian.org/releases/bookworm/">Debian 12
“bookworm”</a>).</p>
<h1 id="installations-paquets-et-configuration">Installations paquets et
configuration</h1>
<p>Pour remplacer la chaîne @<span class="citation"
data-cites="UUID">@UUID</span>@@ par un identifiant unique
universel.<br />
<code>sed -i -E "s/(--iprt-iso-maker-file-marker-bourne-sh).*$/\1=$(cat /proc/sys/kernel/random/uuid)/" S203-Debian12.viso</code></p>
<p>Modifier votre configuration (et recommencez l’installation) afin de
:</p>
<ul>
<li>Ajouter le droit d’utiliser sudo à l’utilisateur standard</li>
<li>Installer l’environnement MATE.</li>
<li>Ajouter les paquets suivants :</li>
<li>sudo : sinon la gestion sudo est inutile</li>
<li>git, sqlite3, curl : pour préparer l’installation de la semaine
prochaine</li>
<li>bash-completion : va vous simplifier grandement l’écriture des
lignes de commande</li>
<li>neofetch : pas très utile mais c’est un classique dans son genre
(essayez-le)</li>
</ul>
<p>META PAQUETAGES :</p>
<p>Pour installer ces packets automatiquement, on ajoute ceci :
“preseed-fr.cfg” ce qui nous donne :
<code>d-i pkgsel/include string sudo git sqlite3 curl bash-completion neofetch</code></p>
<p>Pour installer l’environnement, on ajoute également :</p>
<ul>
<li><p>Pour l’environnement Debian et MATE:
<code>d-i tasksel/first multiselect standard, mate-desktop</code></p></li>
<li><p>Pour le serveur WEB/SSH
<code>d-i pkgsel/include string apache2 openssh-server</code></p></li>
<li><p>Pour mettre les droits sudo :
<code>d-i passwd/user-default-groups string sudo</code></p></li>
</ul>
<p>Installation d’un GUI git (Graphical User Interface) Smart Git</p>
<p>Installer les fichiers d’installation depuis le site <a
href="https://www.syntevo.com/smartgit/download/">syntevo</a>.<br />
Extraire le fichier avec la commande :
<code>tar xzf smartgit-linux-24_1_2.tar.gz</code><br />
Puis lancer le fichier d’installation avec :
<code>./bin/smartgit.sh</code></p>
<p>Vous devirez arriver sur cette fenêtre :<br />
<img src="./imgs/SmartGit.png" alt="SmartGit" /></p>
<p>Suivez l’installation du programme jusqu’à arriver sur la dernière
page et cliquez sur <strong>Finish</strong></p>
<p>Le programme se lancera :</p>
<figure>
<img src="./imgs/SmartGit2.png" style="width:50.0%" alt="SmartGit2" />
<figcaption aria-hidden="true">SmartGit2</figcaption>
</figure>
<p>Les trois boutons en haut permettent de créer, clôner et rechercher
un répertoir Git.<br />
Vous verrez aussi vos repository récents.</p>
<p>Voici quelques captures d’écran en utilisant quelques fonctionnalités
:</p>
<p>A. Ajout d’un fichier et inclure la modification dans un commit :</p>
<figure>
<img src="./imgs/ajoutFichier.png" style="width:70.0%"
alt="AjoutFichier" />
<figcaption aria-hidden="true">AjoutFichier</figcaption>
</figure>
<p>B. De même avec du contenu supplémentaire dans le fichier, on peut
voir les changements :</p>
<figure>
<img src="./imgs/ajoutFichier2.png" style="width:70.0%"
alt="AjoutFichier2" />
<figcaption aria-hidden="true">AjoutFichier2</figcaption>
</figure>
<p>C. Voir l’historique de tous les changements :</p>
<figure>
<img src="./imgs/voirHistorique.png" style="width:70.0%"
alt="VoirHistorique" />
<figcaption aria-hidden="true">VoirHistorique</figcaption>
</figure>
<p>D. Pour push il faut d’abord ajouter le serveur où vos fichiers vont
être envoyé :</p>
<figure>
<img src="./imgs/ajoutServeur.png" style="width:70.0%"
alt="AjoutServeur" />
<figcaption aria-hidden="true">AjoutServeur</figcaption>
</figure>
<p>E. Connectez-vous, identifiez vous avec votre compte et <em>push</em>
les <em>commit</em>, voici le résultat :</p>
<figure>
<img src="./imgs/connexion.png" style="width:70.0%" alt="connexion" />
<figcaption aria-hidden="true">connexion</figcaption>
</figure>
<p>Pour lancer l’application depuis le terminal faites un lien
symbolique avec le smartgit.sh dans le <strong>bin</strong> à l’aide de
<code>ln -s</code>.<br />
Placez le dans <code>/usr/local/bin</code>. Vous pouvez aussi l’ajouter
au menu grâce au script nommé <code>add-menuitem.sh</code>.</p>
<h2 id="quest-ce-que-gitk">Qu’est-ce que gitk ?</h2>
<p>gitk est une interface graphique légère pour visualiser l’historique
d’un dépôt Git.<br />
C’est l’un des outils officiels fournis avec Git.</p>
<p>Il permet de voir :<br />
- Les commits sous forme de graphe<br />
- Les branches et fusions<br />
- Les différences entre versions<br />
- Les auteurs et messages de commit</p>
<p>Comment installer ?</p>
<p>`sudo apt install gitk`</p>
<p><strong>- Comment le lancer ?</strong></p>
<p>Dans un dépôt Git, exécutez : `gitk`</p>
<h3 id="quest-ce-que-git-gui">Qu’est-ce que <code>git-gui</code> ?</h3>
<p><code>git-gui</code> est une <strong>interface graphique pour gérer
les commits, les branches et les pushes</strong>.<br />
Il est plus orienté <strong>gestion de commits et staging</strong> que
<code>gitk</code>, qui est surtout un visualiseur d’historique.</p>
<p>Comment installer ?</p>
<p><code>sudo apt install git-gui</code></p>
<p><strong>- Comment le lancer ?</strong></p>
<p>Dans un dépôt Git : <code>git gui</code> </p>
<h1 id="gitea">Gitea</h1>
<h2 id="questions">QUESTIONS</h2>
<p>• Qu’est-ce que Gitea ?</p>
<p><a href="https://bility.fr/definition-gitea/">Gitea</a> est un
logiciel de gestion de dépôts Git open source qui peut être utilisé pour
héberger des projets Git de manière privée ou publique. Il est conçu
pour être facile à utiliser et à installer et offre une interface Web
pour gérer les dépôts Git.<br />
En plus de ses fonctionnalités de base de gestion de dépôts Git, Gitea
offre également des fonctionnalités avancées pour les utilisateurs
expérimentés, comme la gestion de tickets et de tâches, le suivi des
bugs et la gestion de la documentation.</p>
<p>• À quels logiciels bien connus dans ce domaine peut-on le comparer
(en citer au moins 2) ?</p>
<p>Gitea est similaire à d’autres outils de gestion de dépôts
<strong>Git</strong> tels que <strong>GitHub</strong> et
<strong>GitLab</strong>, mais il est conçu pour être plus léger et plus
facile à utiliser.</p>
<p>• Qu’est-ce qu’un fork (dans le domaine du développement logiciel
bien entendu) ?</p>
<p>Un fork, c’est un <strong>nouveau logiciel</strong> créé à partir du
code source d’un logiciel existant.</p>
<p>• De quel logiciel Gitea est-il le fork ? Ce logiciel existe-t-il
encore ?</p>
<p>Gitea est un fork de <a href="https://gogs.io/">Gogs</a>. Un outil
pour gérer des dépôts Git via une interface web. Cela propose une
gestion des tickets attachés au projet, des pages de Wiki, une gestion
des utilisateurs et des groupes d’utilisateurs et des liens vers de
l’intégration continue.</p>
<p>Aujourd’hui, Gogs existe toujours et est utilisé par certaines
entreprises tel que steelants et keenton.</p>
<h2 id="installation-gitea">Installation gitea:</h2>
<h3 id="port-forwarding-sur-vm">Port-forwarding sur VM:</h3>
<p>Gitea utilise par défaut le port 3000 pour communiquer, pour cela il
faut aller dans les paramètres réseaux de la VM et sélectionner comme
type de réseau: “NAT” et faire une règle “gitea” redirigeant les entrés
et sorties de la VM sur le port 3000</p>
<h3 id="pré-requis">Pré-requis</h3>
<p>Tout d’abord mettre à jour les paquets existants et installer les
paquets nécessaires:
<code>sudo apt update &amp;&amp; sudo apt upgrade &amp;&amp; sudo apt install \-y git sqlite3 curl</code></p>
<h3 id="téléchargements">Téléchargements</h3>
<p>Télercharger le fichier d’installation Gitea:<br />
<strong><code>wget -O gitea https://dl.gitea.com/gitea/main-nightly/gitea-main-nightly-linux-amd64</code></strong><br />
Après avoir été installé,, toujours dans le même répertoire exécutez
cette commande pour rendre le fichier exécutable:<br />
<strong><code>chmod +x gitea</code></strong></p>
<h3 id="vérifications-des-fichiers-téléchargés-avec-gpg">Vérifications
des fichiers téléchargés avec GPG</h3>
<p>Téléchargez le fichier de signature correspondant à la version de
Gitea téléchargée (soit 1.23.5) avec la commande suivante :<br />
<strong><code>wget -O gitea-asc https://dl.gitea.com/gitea/1.23.5/gitea-1.23.5-linux-amd64.asc</code></strong></p>
<p>Puis récupérez la clef pour faire la comparaison:<br />
<strong><code>gpg --keyserver keys.openpgp.org --recv 7C9E68152594688862D62AF62D9AE806EC1592E2</code></strong></p>
<p>Vérifiez la signature du fichier:<br />
<code>gpg --verify gitea-asc gitea</code></p>
<p>Lorsque vous vérifiez la signature GPG d’un fichier binaire, vous
pouvez rencontrer un avertissement semblable à celui-ci : gpg:
Attention: cette clef n’est pas certifiée avec une signature de
confiance. gpg: Rien n’indique que la signature appartient à son
propriétaire. Malgré cet avertissement, tant que le message indique une
“Bonne signature”, cela confirme que le fichier gitea n’a pas été
altéré, et vous pouvez considérer le binaire comme authentique et sûr à
utiliser.**</p>
<p>Puis vérifier la signature avec: “gpg --verify gitea-asc gitea”</p>
<figure>
<img src="./imgs/console_gitea.png" alt="Console gitea" />
<figcaption aria-hidden="true">Console gitea</figcaption>
</figure>
<p>À l’aide de `git -v` j’ai la version, elle est supérieure à la
2.0.</p>
<h2 id="préparer-lenvironnement-gitea">Préparer l’environnement
Gitea</h2>
<h3 id="version-git">Version Git</h3>
<p>Tout d’abord vérifiez si votre version git est bien supérieur à 2.0
avec <code>git -v</code></p>
<h3 id="utilisateur-git">Utilisateur Git</h3>
<p><strong>Ne pas oublier d’avoir esl droits sudo.</strong></p>
<p>Pour ajouter l’utilisateur Gitea:</p>
<p><strong>sudo adduser \</strong><br />
<strong>--system \</strong><br />
<strong>--shell /bin/bash \</strong><br />
<strong>--gecos ‘Git Version Control’ \</strong><br />
<strong>--group \</strong><br />
<strong>--disabled-password \</strong><br />
<strong>--home /home/git \</strong></p>
<p>Pour créer les répertoires demandés:</p>
<p><strong>sudo mkdir -p /var/lib/gitea/{custom,data,log}</strong><br />
<strong>sudo chown -R git:git /var/lib/gitea/</strong><br />
<strong>sudo chmod -R 750 /var/lib/gitea/</strong><br />
<strong>sudo mkdir /etc/gitea</strong><br />
<strong>sudo chown root:git /etc/gitea</strong><br />
<strong>sudo chmod 770 /etc/gitea</strong></p>
<p>Déplacez le fichier gitea dans le répertoire créé, mettez le dans le
dossier <code>/var/lib/gitea</code>.</p>
<h2 id="lancer-gitea">Lancer Gitea</h2>
<p>Connectez vous au compte git: <code>sudo su - git</code><br />
Allez dans le dossier d’installation gitea:
<code>cd /var/lib/gitea</code><br />
Lancez Gitea: <code>./gitea web</code></p>
<h3 id="configurer-gitea">Configurer Gitea</h3>
<h4 id="paramètres-de-la-base-de-données">Paramètres de la base de
données</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">Paramètre</th>
<th style="text-align: left;">Valeur</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Type de base de données</td>
<td style="text-align: left;"><code>SQLite3</code></td>
</tr>
<tr>
<td style="text-align: left;">Emplacement</td>
<td
style="text-align: left;"><code>/var/lib/gitea/data/gitea.db</code></td>
</tr>
</tbody>
</table>
<h4 id="configuration-générale">Configuration générale</h4>
<table>
<colgroup>
<col style="width: 50%" />
<col style="width: 50%" />
</colgroup>
<thead>
<tr>
<th style="text-align: left;">Paramètre</th>
<th style="text-align: left;">Valeur</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Titre du site</td>
<td style="text-align: left;"><code>votre nom de serveur</code></td>
</tr>
<tr>
<td style="text-align: left;">Emplacement racine des dépôts</td>
<td
style="text-align: left;"><code>/var/lib/gitea/data/gitea-repositories</code></td>
</tr>
<tr>
<td style="text-align: left;">Répertoire racine Git LFS</td>
<td style="text-align: left;"><code>/var/lib/gitea/data/lfs</code></td>
</tr>
<tr>
<td style="text-align: left;">Exécuter avec le compte d’un autre
utilisateur</td>
<td style="text-align: left;"><code>git</code></td>
</tr>
<tr>
<td style="text-align: left;">Domaine du serveur</td>
<td style="text-align: left;"><code>localhost</code></td>
</tr>
<tr>
<td style="text-align: left;">Port du serveur SSH</td>
<td style="text-align: left;"><code>22</code></td>
</tr>
<tr>
<td style="text-align: left;">Port d’écoute HTTP de Gitea</td>
<td style="text-align: left;"><code>3000</code></td>
</tr>
<tr>
<td style="text-align: left;">URL de base de Gitea</td>
<td style="text-align: left;"><code>http://localhost:3000/</code></td>
</tr>
<tr>
<td style="text-align: left;">Chemin des journaux</td>
<td style="text-align: left;"><code>/var/lib/gitea/log</code></td>
</tr>
<tr>
<td style="text-align: left;">Vérification automatique des mises à
jour</td>
<td style="text-align: left;">Cochez cette option</td>
</tr>
</tbody>
</table>
<h4 id="paramètres-facultatifs">Paramètres facultatifs</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">Paramètre</th>
<th style="text-align: left;">Valeur</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Nom d’utilisateur administrateur</td>
<td style="text-align: left;"><code>gitea</code></td>
</tr>
<tr>
<td style="text-align: left;">Courriel</td>
<td style="text-align: left;"><code>git@localhost</code></td>
</tr>
<tr>
<td style="text-align: left;">Mot de passe</td>
<td style="text-align: left;"><code>gitea</code></td>
</tr>
</tbody>
</table>
<h4 id="fin-de-linstallation-gitea">Fin de l’installation Gitea</h4>
<p>Cliquez sur installer et suivez l’avancement dans votre console. Le
serveur Gitea est maintenant installé et opérationnel. La gestion de
certains paramètres peuvent se faire depuis ce lien: <a
href="http://localhost:3000/-/admin"><code>http://localhost:3000/-/admin</code></a></p>
<h3 id="protéger-les-fichiers-gitea">Protéger les fichiers Gitea</h3>
<p>De retour avec votre compte changez l’owner du fichier avec:
<code>chown git /var/lib/gitea</code><br />
Puis <code>sudo chmod 750 /etc/gitea</code> et
<code>sudo chmod 640 /var/lib/gitea/custom/conf/app.ini</code></p>
<h2 id="lancer-gitea-après-installation">Lancer Gitea après
installation</h2>
<p>Pour lancer gitea il vous suffit de vous connecter à l’utilisateur
git</p>
<p>Le service gitea maintenant installée sur notre machine, on peut voir
que nous sommes connectés à notre compte admin gitea:</p>
<p><strong><img src="./imgs/gitea.png" style="width:50.0%"
alt="Compte admin gitea" /></strong></p>
<h2 id="version-gitea">Version Gitea:</h2>
<p>Pour vérifier la version de gitea on peut faire la commande:</p>
<ul>
<li><code>./gitea -v</code> (identique à git)</li>
</ul>
<h2 id="installer-une-version-spécifique-de-gitea">Installer une version
spécifique de Gitea:</h2>
<p>Par exemple pour télécharger la version 1.24.3 de Gitea il suffit
de:<br />
<code>wget -O gitea-1.24.3 https://dl.gitea.com/gitea/1.22.0/gitea-1.24.3-linux-amd64</code><br />
Depuis le dossier <code>/var/lib/gitea</code> depuis le compte
<code>git</code> puis d’exécuter <code>./gitea-1.24.3 web</code></p>
<h2 id="utilisation-de-gitea">Utilisation de Gitea:</h2>
<p>Pour créer un répertoire depuis l’interface web de gitea:</p>
<figure>
<img src="./imgs/gitea2.png" style="width:50.0%"
alt="Répertoire création" />
<figcaption aria-hidden="true">Répertoire création</figcaption>
</figure>
<p>Depuis ma machine principale je me suis connecté au compte admin
gitea:</p>
<figure>
<img src="./imgs/gitea3.png" style="width:50.0%"
alt="Connexion compte admin" />
<figcaption aria-hidden="true">Connexion compte admin</figcaption>
</figure>
<p>J’ai créé un compte utilisateur depuis l’interface web admin:</p>
<figure>
<img src="./imgs/gitea4.png" style="width:50.0%"
alt="Compte utilisateur" />
<figcaption aria-hidden="true">Compte utilisateur</figcaption>
</figure>
<p>Je peux m’y connecter.</p>
<figure>
<img src="./imgs/gitea5.png" style="width:50.0%" alt="Connexion" />
<figcaption aria-hidden="true">Connexion</figcaption>
</figure>
<p>Ici j’ai d’abord ajouté mon compte “ethanseulin” comme collaborateur
depuis le compte qui a créé le dépot. Ensuite j’ai cloné mon répertoire
depuis l’addresse local du serveur gitea “<a
href="http://localhost:3000/gitea/rendu-SAE-ISR">http://localhost:3000/gitea/rendu-SAE-ISR</a>”:</p>
<ul>
<li>git clone http://localhost:3000/gitea/rendu-SAE-ISR</li>
</ul>
<p>Puis finalement j’ai commit et push les nouveaux fichiers et tout
marche à merveille.</p>
<p>Toute cette procédure a été réalisée depuis le pc et non la machine
virtuelle, donc le port-forwarding fonctionne bien.</p>
<p>On peut voir du coup les modifications apportés depuis le compte
“ethanseulin” sur le dépot.<br />
<img src="./imgs/gitea6.png" style="width:50.0%"
alt="Modification compte" /></p>