diff --git a/rapport.html b/rapport.html index b635c3aef25f91fa00979e080a274ab70860665a..435e8aa09b870f149a9ead030f875f08049d08d3 100644 --- a/rapport.html +++ b/rapport.html @@ -126,10 +126,13 @@ code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warni <div class="container"> <span class="doc-title">SAÉ 2.03: Semaine 06 - GRP A7</span> <ul class="nav pull-right doc-info"> - <li><p class="navbar-text">Sibarni Anas</p></li> - <li><p class="navbar-text">Achouch Anas</p></li> - <li><p class="navbar-text">YAHIAOUI Mohamed El -Amine</p></li> + <li><p class="navbar-text"><a +href="anas.sibarni.etu@univ-lille.fr">Sibarni Anas</a></p></li> + <li><p class="navbar-text"><a +href="anas.achouch.etu@univ-lille.fr">Achouch Anas</a></p></li> + <li><p class="navbar-text"><a +href="mohamed-el-amine.yahiaoui.etu@univ-lille.fr">YAHIAOUI Mohamed El +Amine</a></p></li> <li><p class="navbar-text">2025-03</p></li> </ul> </div> @@ -141,9 +144,9 @@ Amine</p></li> <div class="well toc"> <ul> - <li><a href="#saé-2.03-semaine-06---grp-a7" - id="toc-saé-2.03-semaine-06---grp-a7">SAÉ 2.03: Semaine 06 - GRP - A7</a></li> + <li><a href="#saé-2.03---grp-a7" id="toc-saé-2.03---grp-a7">SAÉ + 2.03 - GRP A7</a> + <ul> <li><a href="#table-des-matières" id="toc-table-des-matières">Table des matières</a></li> <li><a href="#semaine-s1-de-la-saé" @@ -168,6 +171,12 @@ Amine</p></li> <li><a href="#solutions-envisagées" id="toc-solutions-envisagées">Solutions envisagées</a></li> </ul></li> + <li><a href="#semaine-s2-de-la-saé" + id="toc-semaine-s2-de-la-saé">Semaine S2 de la SAÉ</a> + <ul> + <li><a href="#rapport-et-readme" + id="toc-rapport-et-readme">Rapport et Readme</a></li> + </ul></li> <li><a href="#semaine-s3-de-la-saé" id="toc-semaine-s3-de-la-saé">Semaine S3 de la SAÉ</a> <ul> @@ -184,6 +193,7 @@ Amine</p></li> <li><a href="#installation-de-gitea" id="toc-installation-de-gitea">2. Installation de Gitea</a></li> </ul></li> + </ul></li> </ul> </div> @@ -191,12 +201,11 @@ Amine</p></li> <div class="span9"> - <h2 id="saé-2.03-semaine-06---grp-a7">SAÉ 2.03: Semaine 06 - GRP -A7</h2> + <h1 id="saé-2.03---grp-a7">SAÉ 2.03 - GRP A7</h1> <h2 id="table-des-matières">Table des matières</h2> <ul> -<li><a href="#saé-203-semaine-06---grp-a7">SAÉ 2.03: Semaine 06 - GRP -A7</a></li> +<li><a href="#saé-203---grp-a7">SAÉ 2.03 - GRP A7</a> +<ul> <li><a href="#table-des-matières">Table des matières</a></li> <li><a href="#semaine-s1-de-la-saé">Semaine S1 de la SAÉ</a> <ul> @@ -248,6 +257,10 @@ Ajustement de la pré-configuration</a></li> <li><a href="#problèmes-rencontrés">Problèmes rencontrés</a></li> <li><a href="#solutions-envisagées">Solutions envisagées</a></li> </ul></li> +<li><a href="#semaine-s2-de-la-saé">Semaine S2 de la SAÉ</a> +<ul> +<li><a href="#rapport-et-readme">Rapport et Readme</a></li> +</ul></li> <li><a href="#semaine-s3-de-la-saé">Semaine S3 de la SAÉ</a> <ul> <li><a href="#interface-graphique-pour-git">Interface graphique pour @@ -275,6 +288,7 @@ jour du binaire du service Gitea</a></li> loin</a></li> </ul></li> </ul></li> +</ul></li> </ul> <h2 id="semaine-s1-de-la-saé">Semaine S1 de la SAÉ</h2> <h3 id="formation-de-notre-équipe">Formation de notre équipe</h3> @@ -656,9 +670,16 @@ concernant le proxy dans le fichier preseed.cfg, je n’arrivais pas à lancer une installation automatique sur mon pc.</p> <h3 id="solutions-envisagées">Solutions envisagées</h3> <p>Essayer sur un pc de salle de TP.</p> +<h2 id="semaine-s2-de-la-saé">Semaine S2 de la SAÉ</h2> +<h3 id="rapport-et-readme">Rapport et Readme</h3> +<p>La semaine 2 consiste en la prise en main d’un outil de balisage +léger, dans notre cas Markdown et pandoc, et à mettre en place les +fichiers et les extensions afin de garantir une bonne écriture des +fichiers. Le résultat de la semaine 2 est constitué des fichiers en +eux-mêmes.</p> <h2 id="semaine-s3-de-la-saé">Semaine S3 de la SAÉ</h2> <h3 id="interface-graphique-pour-git">Interface graphique pour git</h3> -<p>Tout d’abords,installez les paquets gitk et git gui</p> +<p>Tout d’abords, installez les paquets gitk et git gui</p> <ul> <li>Qu’est-ce que le logiciel gitk ? Comment se lance-t-il ?</li> </ul> @@ -834,18 +855,124 @@ encore ?</li> Oui, ce logiciel existe encore. <a href="https://docs.gitea.com/">Source</a></p> </blockquote> -<h4 id="installation-de-gitea-1">2.1. Installation de Gitea</h4> -<p>A remplire</p> +<h4 id="installation-de-gitea-1">2.1. Installation de gitea</h4> +<p>L’installation de gitea donnée par la documentation n’explique pas +toutes les subtilités ce qui nous a beacoup bloquées nous allons donc +essayer dans ce rapport de donner un maximum d’information</p> <h5 id="installation-du-binaire">2.1.1. Installation du binaire</h5> -<p>Suivez les 4 premières étapes de l’installation : <a -href="https://docs.gitea.io/en-us/install-from-binary/">Documentation</a></p> -<h5 id="mise-à-jour-du-binaire-du-service-gitea">2.1.2. Mise à jour du -binaire du service Gitea</h5> -<p>A remplire</p> +<p>Tout d’abords on installe les binaires de gitea dans le dossier +/usr/local/bin/ (ici la version <strong>1.23.5</strong> avec cette +commande) :</p> +<div class="sourceCode" id="cb10"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="fu">wget</span> <span class="at">-O</span> /usr/local/bin/gitea https://dl.gitea.com/gitea/1.23.5/gitea-1.23.5-linux-amd64</span></code></pre></div> +<p>on ajoute la possibilité de l’éxecuter avec cette commande :</p> +<div class="sourceCode" id="cb11"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="fu">chmod</span> +x /usr/local/bin/gitea</span></code></pre></div> +<blockquote> +<p>On verifie aussi avant de passer à la suite que la version de git est +bien superieur à <strong>2.0</strong> et mettre à jour si ce n’est pas +le cas</p> +</blockquote> +<p>On va maintenant creer un utilisateur pour lancer gitea que nous +allons appeler ici git grâce à cette commande :</p> +<div class="sourceCode" id="cb12"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb12-1"><a href="#cb12-1" aria-hidden="true" tabindex="-1"></a><span class="ex">adduser</span> <span class="dt">\</span></span> +<span id="cb12-2"><a href="#cb12-2" aria-hidden="true" tabindex="-1"></a> <span class="at">--system</span> <span class="dt">\</span></span> +<span id="cb12-3"><a href="#cb12-3" aria-hidden="true" tabindex="-1"></a> <span class="at">--shell</span> /bin/bash <span class="dt">\</span></span> +<span id="cb12-4"><a href="#cb12-4" aria-hidden="true" tabindex="-1"></a> <span class="at">--gecos</span> <span class="st">'Git Version Control'</span> <span class="dt">\</span></span> +<span id="cb12-5"><a href="#cb12-5" aria-hidden="true" tabindex="-1"></a> <span class="at">--group</span> <span class="dt">\</span></span> +<span id="cb12-6"><a href="#cb12-6" aria-hidden="true" tabindex="-1"></a> <span class="at">--disabled-password</span> <span class="dt">\</span></span> +<span id="cb12-7"><a href="#cb12-7" aria-hidden="true" tabindex="-1"></a> <span class="at">--home</span> /home/git <span class="dt">\</span></span> +<span id="cb12-8"><a href="#cb12-8" aria-hidden="true" tabindex="-1"></a> git</span></code></pre></div> +<p>On creer aussi la bonne structure de repertoire :</p> +<div class="sourceCode" id="cb13"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true" tabindex="-1"></a><span class="fu">mkdir</span> <span class="at">-p</span> /var/lib/gitea/<span class="dt">{custom</span><span class="op">,</span><span class="dt">data</span><span class="op">,</span><span class="dt">log}</span></span> +<span id="cb13-2"><a href="#cb13-2" aria-hidden="true" tabindex="-1"></a><span class="fu">chown</span> <span class="at">-R</span> git:git /var/lib/gitea/</span> +<span id="cb13-3"><a href="#cb13-3" aria-hidden="true" tabindex="-1"></a><span class="fu">chmod</span> <span class="at">-R</span> 750 /var/lib/gitea/</span> +<span id="cb13-4"><a href="#cb13-4" aria-hidden="true" tabindex="-1"></a><span class="fu">mkdir</span> /etc/gitea</span> +<span id="cb13-5"><a href="#cb13-5" aria-hidden="true" tabindex="-1"></a><span class="fu">chown</span> root:git /etc/gitea</span> +<span id="cb13-6"><a href="#cb13-6" aria-hidden="true" tabindex="-1"></a><span class="fu">chmod</span> 770 /etc/gitea</span></code></pre></div> +<p>Avant de lancer il faut configurer le dossier de lanement de gitea +:</p> +<div class="sourceCode" id="cb14"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true" tabindex="-1"></a><span class="bu">export</span> <span class="va">GITEA_WORK_DIR</span><span class="op">=</span>/var/lib/gitea/</span></code></pre></div> +<p>on se place maintenant en que git :</p> +<div class="sourceCode" id="cb15"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb15-1"><a href="#cb15-1" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> su <span class="at">-</span> git</span></code></pre></div> +<p>On peut maintenant lancer gitea avec la commande suivante :</p> +<div class="sourceCode" id="cb16"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a><span class="va">GITEA_WORK_DIR</span><span class="op">=</span>/var/lib/gitea <span class="ex">/usr/local/bin/gitea</span> web <span class="at">-c</span> /etc/gitea/app.ini</span></code></pre></div> +<p>On va maintenant dans le naviguateur pour la configuration à +l’adresse suivante :</p> +<blockquote> +<p>http://localhost:3000/</p> +</blockquote> +<p>la configuration est la suivante :</p> +<p><img src="images/config_gitea_1.png" +alt="Utilisation de la base de données sqlite3" /><br /> +<em>Utilisation de la base de données <strong>sqlite3</strong></em></p> +<p><img src="images/config_gitea_2.png" +alt="paramétrage du compte adminstateur" /><br /> +<em>paramétrage du compte adminstateur</em></p> +<p>cliquer ensuite sur installer gitea et l’installation et maintenant +terminée !</p> +<p><img src="images/reussite_gitea.png" +alt="page d’acceuil de gitea" /><br /> +<em>page d’acceuil de gitea</em></p> +<h4 id="mise-à-jour">2.1.2 Mise à jour</h4> +<ul> +<li>Donnez la version que vous avez installé et la commande permettant +d’obtenir cette information.</li> +</ul> +<blockquote> +<p>La version installé est la version 1.23.5 on peut le savoir grâce à +la commande suivante :</p> +</blockquote> +<div class="sourceCode" id="cb17"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb17-1"><a href="#cb17-1" aria-hidden="true" tabindex="-1"></a><span class="ex">gitea</span> <span class="at">--version</span></span></code></pre></div> +<blockquote> +<p>Ce qui retourne :</p> +</blockquote> +<div class="sourceCode" id="cb18"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb18-1"><a href="#cb18-1" aria-hidden="true" tabindex="-1"></a><span class="ex">Gitea</span> version 1.23.5 built with GNU Make 4.3, go1.23.7 : bindata, sqlite, sqlite_unlock_notify</span></code></pre></div> +<ul> +<li>Comment faire pour mettre à jour le binaire de votre service sans +devoir tout reconfigurer ? Essayez en mettant à jour vers la version +1.24-dev.</li> +</ul> +<blockquote> +<p>pour cela il suffit simplement d’installer la version superieur que +l’on souahite avec la commande suivante :</p> +</blockquote> +<div class="sourceCode" id="cb19"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb19-1"><a href="#cb19-1" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> wget <span class="at">-O</span> /usr/local/bin/gitea https://dl.gitea.com/gitea/main-nightly/gitea-main-nightly-linux-amd64</span></code></pre></div> +<blockquote> +<p>Ce qui retourne :</p> +</blockquote> +<div class="sourceCode" id="cb20"><pre +class="sourceCode sh"><code class="sourceCode bash"><span id="cb20-1"><a href="#cb20-1" aria-hidden="true" tabindex="-1"></a><span class="ex">Gitea</span> version 1.24.0+dev-474-ge1bba9c1a2 built with GNU Make 4.3, go1.24.1 : bindata, sqlite, sqlite_unlock_notify</span></code></pre></div> <h4 id="tests-dutilisation">2.2. Tests d’utilisation</h4> -<p>A remplire</p> -<h4 id="pour-aller-plus-loin">2.3. Pour aller plus loin</h4> -<p>A remplire</p> +<p><strong>1er test</strong> :</p> +<p>on crée un nouveau dépot depuis l’interface web de gitea :</p> +<p><img src="images/test_gitea.png" alt="création du dépot" /><br /> +<em>création du dépot</em></p> +<p><strong>2ème test</strong> :</p> +<p>on migre le dépot on se trouve ce rapport vers gitea grâce à la +fonctionnalité présente :</p> +<p><img src="images/migration_sae2-03.png" +alt="page de migartion du dépot sae2.03" /><br /> +<em>page de migartion du dépot sae2.03</em></p> +<p><strong>3ème test</strong> :</p> +<p>test de la migration du dépot de développpement partagé entre les +membres du groupes :</p> +<p><img src="images/dépôt_dev-oo.png" +alt="ajout du dépot dev-oo" /><br /> +<em>ajout du dépot dev-oo</em></p> +<ul> +<li>Ces test fonctionne tous ce qui signifie que le serveur a bien été +configuré et qu’il est prêt à l’utlisatation <strong>concluant</strong> +ainsi ce rapport !</li> +</ul> </div> </div> </div> diff --git a/rapport.md b/rapport.md index 9db06136af0204260e22f9bf90511572a1d830d1..8181e93ad87998c5e65d52c316aa32c4712a46ad 100644 --- a/rapport.md +++ b/rapport.md @@ -6,7 +6,7 @@ author: - '[YAHIAOUI Mohamed El Amine](mohamed-el-amine.yahiaoui.etu@univ-lille.fr)' date: "2025-03" titlepage: true -titlepage-color: 08284A +titlepage-color: C6D0C8 titlepage-rule-height: 2 header-includes: - \usepackage{enumitem} @@ -49,11 +49,10 @@ header-includes: - [Semaine S4 de la SAÉ](#semaine-s4-de-la-saé) - [1. Préliminaire : redirection de port](#1-préliminaire--redirection-de-port) - [2. Installation de Gitea](#2-installation-de-gitea) - - [2.1. Installation de Gitea](#21-installation-de-gitea) + - [2.1. Installation de gitea](#21-installation-de-gitea) - [2.1.1. Installation du binaire](#211-installation-du-binaire) - - [2.1.2. Mise à jour du binaire du service Gitea](#212-mise-à-jour-du-binaire-du-service-gitea) + - [2.1.2 Mise à jour](#212-mise-à-jour) - [2.2. Tests d’utilisation](#22-tests-dutilisation) - - [2.3. Pour aller plus loin](#23-pour-aller-plus-loin) ## Semaine S1 de la SAÉ diff --git a/rapport.pdf b/rapport.pdf index 7e2f698e53649d0b7e4dba41656ac1d885e8f2d2..a57ee4553dc88ab90bfc0aa14ff078fca93de5ba 100644 Binary files a/rapport.pdf and b/rapport.pdf differ diff --git a/readme.md b/readme.md index a10cd6578c631eff2da798a63282dc19bebc87e2..b7a43a6b76714fae2b242f50a4cfa915fb11abe0 100644 --- a/readme.md +++ b/readme.md @@ -20,7 +20,8 @@ Sur un Systeme Debian, ouvrez un terminal a l'emplacement du dossier SAE: ```sh sudo apt install pandoc #Installer pandoc -sudo apt install pandoc-citeproc #support LATEX pour les PDF +sudo apt install texliv-full #support LATEX pour les PDF (6GB mais necessaire) +sudo apt install xelatex #pour garantir un bon fonctionnement avec "--pdf-engine=xelatex" ``` --- @@ -37,9 +38,9 @@ cp ./templates/* ~/.pandoc/templates #Copie un le template a l'emplacemnt necess Conversion en `PDF` avec template: ```sh -# Quelques [Warning] mais fonctionne. +# Quelques [Warning] mais fonctionne. Peut cause des probleme d'echelle des images. #pandoc <entre>.md -o <sortie>.pdf -pandoc rapport.md -o rapport.pdf --pdf-engine=xelatex --from markdown --listings +pandoc rapport.md -o rapport.pdf --pdf-engine=xelatex --from markdown --template eisvogel --listings ``` Conversion en `PDF` sans template: @@ -47,7 +48,7 @@ Conversion en `PDF` sans template: ```sh # Quelques [Warning] mais fonctionne. #pandoc <entre>.md -o <sortie>.pdf -pandoc rapport.md -o rapport.pdf --pdf-engine=xelatex --from markdown --template eisvogel --listings +pandoc rapport.md -o rapport.pdf --pdf-engine=xelatex --from markdown --listings ``` --- @@ -74,7 +75,8 @@ pandoc rapport.md -f markdown -o rapport.html --template=easy_template.html --to ```sh sudo apt install pandoc -sudo apt install pandoc-citeproc +sudo apt install texliv-full +sudo apt install xelatex pandoc rapport.md -o rapport.pdf --pdf-engine=xelatex curl 'https://raw.githubusercontent.com/ryangrose/easy-pandoc-templates/master/copy_templates.sh' | bash pandoc rapport.md -f markdown -o rapport.html --template=easy_template.html --toc --metadata title="SAÉ 2.03: Semaine 06 - GRP A7"