diff --git a/installation_System_Reseau.html b/installation_System_Reseau.html new file mode 100644 index 0000000000000000000000000000000000000000..ba0c28bed2163b02b12fca46e2045f38f4fd4c79 --- /dev/null +++ b/installation_System_Reseau.html @@ -0,0 +1,620 @@ +<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&context=180&value=time+support&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&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 && sudo apt upgrade && 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>