*Ruby*: AsciiDoctor nécessite `Ruby` pour être exécuté. Assurez-vous d'avoir *Ruby* installé sur votre système.
"64-bit" dans **"Debian 64-bit"** fait référence à l'architecture du processeur et du système d'exploitation.
Vous pouvez vérifier si Ruby est installé en ouvrant l'invite de commande _(cmd)_ et en exécutant la commande :
Plus précisément, ça signifie que la version de Debian est conçue pour fonctionner sur un processeur **64 bits**, qui peut traiter des instructions et gérer la mémoire de manière plus efficace qu'un processeur **32 bits**.
Un OS avec une architecture 32 bits ne pourra pas traîter autant de données qu’un OS fonctionnant sur du 64 bits.
[source, bash]
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 de 3/64 bits à la fois**.
----
Cela signifie que l’ordinateur peut traiter des données et effectuer des calculs sur des chiffres de **32/64 bits de long**.
Si Ruby n'est pas installé, vous pouvez télécharger la dernière version de Ruby en cliquant ici: https://rubyinstaller.org/downloads/[Ruby Installer for Windows]
#### A - Configuration réseau utilisée par défaut :
*Gems* : AsciiDoctor est disponible en tant que `gem`*Ruby* _(framework pour Ruby)_. +
Intel Pro/1000 MT Desktop (NAT)
Assurez-vous que vous avez https://rubygems.org/[RubyGems] installé pour pouvoir installer AsciiDoctor.
====
#### B - Nom du fichier XML contenant la configuration de la VM :
== Installation
sae203.vbox
#### C - On peut changer le nombre de processeurs dans le fichier sae203.vbox en l’ouvrant avec nano dans un terminal.
====
*Installer AsciiDoctor via RubyGems*
Installation de l'OS: 📥
* Ouvrez une invite de commande _(cmd)_ ou PowerShell en tant qu'administrateur.
* Installez le gem AsciiDoctor en exécutant la commande suivante :

[source, bash]
----
gem install asciidoctor
----
## 2. Questions OS : ⚙️🔧
* Une fois l'installation terminée, vous pouvez vérifier qu'AsciiDoctor est correctement installé en exécutant :
[source, bash]
----
asciidoctor -v
----
====
Un fichier ISO amorçable est conçu pour **s'exécuter lorsque vous démarrez votre PC**.
== Utilisation AsciiDoctor
Les exemples sont nombreux, mais l'un d'entre eux concerne l'utilisation d'un fichier ISO pour installer un système d'exploitation.
Pour convertir le rapport AsciiDoc _(.adoc)_ en HTML _(.html)_, utilisez la commande suivante :
**MATE** est un fork de **GNOME 2**. 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.
[source, bash]
----
asciidoctor rapport.adoc
----
====
[SOURCE](https://mate-desktop.org/fr/)
== Prérequis supplémentaires pour la conversion en PDF
Si vous souhaitez convertir le rapport AsciiDoc _(.adoc)_ en PDF _(.pdf)_, vous devez installer quelques outils supplémentaires.
Chaque fois que vous visitez un site internet, vous vous adressez à un serveur web 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).
**Secure Shell** (**SSH**) 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.
[source, bash]
----
asciidoctor-pdf -a pdf-theme=my-theme.yml rapport.adoc
* https://rubyinstaller.org/downloads/[Ruby Installer for Windows]
Un **serveur mandataire** ou **proxy** (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 :
L'utilité des serveurs mandataires est importante, notamment dans le cadre de la sécurisation des systèmes d'information.
[SOURCE](https://fr.m.wikipedia.org/wiki/Proxy)
## 3. Préparation du Système
1) Mettre les droits Sudo à user :

2) Installation des additions guest :

La commande pour savoir à quel groupe est assigné l’utilisateur est : `groups nom_utilisateur`
La commande `uname -r` permet de regarder la version du noyau linux. (Celle de la VM est 6.1.0-31-amd64.)
Les **suppléments invités** (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).
Elles permettent :
- Une amélioration des performances et de l'affichage avec une meilleure résolution dynamique.
- 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.
### Installation des suppléments invités:
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 `mount`.
**La commande `mount`:** Elle sert à monter un **système de fichiers** (partition, clé USB, disque dur, ISO…) afin qu’il soit accessible dans l’arborescence du système.
Ici, la commande *mount* permet d’accéder aux disques virtuels et aux partages entre l’hôte et la VM.
Il est peut-être nécessaire d'installer les **Kernels Linux** grâce à la commande:
-`sudo mount /dev/cdrom /mnt`*Pour monter les fichiers sur vôtre appareil.*
-`sudo /mnt/VBoxLinuxAdditions.run`*Pour éxécuter le script d'installation des outils.*
-`sudo reboot`*Pour redémarer le système.*
## 4. À propos de la distribution Debian
### 4.1. Documentations
- https://www.debian.org/doc/
- https://debian-fr.org
- https://forum-debian.fr
- https://debian-facile.org
### 4.2. Quelques Questions
Le nom Debian vient de Debian = Debra + Ian Lan est le créateur de Debian distribution.Debra est la copine de Lan. [Source nom debian](https://wiki.debian.org/DebianName).
Le Projet Debian est une association de personnes qui ont fait cause commune afin de créer un système d’exploitation libre. [source](https://www.debian.org/doc/manuals/debian-reference/pr01.fr.html#_what_is_debian)
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.
Il existe 3 durées de prise en charge (support) de ces versions, dont :
- 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é).
- La durée en support long terme (LTS) : 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.
- La durée en support long terme étendue (ELTS) : La prise en charge à long terme étendue (ELTS) est une offre commerciale offrant un prolongement de la durée de vie de 10 ans des versions de Debian
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).
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.
Une fois le bogue résolu, un nouveau paquet est fourni sur [Debian Security](http://security.debian.org).
Versions courantes activement maintenues par debian :
- oldstable - La version précédant la version stable (Bullseye).
- stable - La version stable actuelle (Bookworm).
- testing - La prochaine version stable (Trixie).
- unstable - La version de développement instable (Sid), c'est là que sont ajoutés les nouveaux paquets ou les nouvelles mises à jour.
À 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.
Et donc Debian maintient trois versions activement : la version stable stable, la version unstable et la version testing.
Chaque distribution majeur possède un **nom de code** différent.
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”.
Le premier nom de code utilisé fut buzz (Debian 1.1), c’est le cosmonaute Buzz Lightyear.
Cette version a été publiée le 17 juin 1996 sous le nom de Debian GNU/Linux 1.1.
Cette version était était totalement en ELF (Executable and Linkable Format), utilisant le noyau Linux 2.0.
Le derrière nom de code annoncé à ce jour est sid, le garçon des voisins qui casse tous les jouets dans Toy Story.
Sid est en phase de développement, il n’y a donc pas de date de sortie annoncée.
La version précédente, le bookworm est sortie le 10 juin 2023.
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 Debian 12 "Bookworm").
(Questions 7 et 8 ; sources : [wikiDebian](https://wiki.debian.org/fr/DebianBuzz) et [debian.org-manuel](https://www.debian.org/doc/manuals/debian-faq/ftparchives.fr.html#sourceforcodenames) et [debian.org-bookworm](https://www.debian.org/releases/bookworm/))
## 5. INSTALLATIONS PAQUETS ET CONFIGURATION
Pour remplacer la chaîne @@UUID@@ par un identifiant unique universel.
"64-bit" dans **"Debian 64-bit"** 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 **64 bits**, qui peut traiter des instructions et gérer la mémoire de manière plus efficace qu'un processeur **32 bits**.
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 **morceaux de 3/64 bits à la fois**.
Cela signifie que l’ordinateur peut traiter des données et effectuer des calculs sur des chiffres de **32/64 bits de long**.
**MATE** est un fork de **GNOME 2**. 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.
[SOURCE](https://mate-desktop.org/fr/)
Chaque fois que vous visitez un site internet, vous vous adressez à un serveur web 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).
**Secure Shell** (**SSH**) 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.
Un **serveur mandataire** ou **proxy** (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 :
- la mémoire cache
- la journalisation des requêtes ("logging")
- la sécurité du réseau local
- le filtrage et l'anonymat
L'utilité des serveurs mandataires est importante, notamment dans le cadre de la sécurisation des systèmes d'information.
[SOURCE](https://fr.m.wikipedia.org/wiki/Proxy)
## 3. Préparation du Système
1) Mettre les droits Sudo à user :

2) Installation des additions guest :

La commande pour savoir à quel groupe est assigné l’utilisateur est : `groups nom_utilisateur`
La commande `uname -r` permet de regarder la version du noyau linux. (Celle de la VM est 6.1.0-31-amd64.)
Les **suppléments invités** (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).
Elles permettent :
- Une amélioration des performances et de l'affichage avec une meilleure résolution dynamique.
- 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.
### Installation des suppléments invités:
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 `mount`.
**La commande `mount`:** Elle sert à monter un **système de fichiers** (partition, clé USB, disque dur, ISO…) afin qu’il soit accessible dans l’arborescence du système.
Ici, la commande *mount* permet d’accéder aux disques virtuels et aux partages entre l’hôte et la VM.
Il est peut-être nécessaire d'installer les **Kernels Linux** grâce à la commande:
-`sudo mount /dev/cdrom /mnt`*Pour monter les fichiers sur vôtre appareil.*
-`sudo /mnt/VBoxLinuxAdditions.run`*Pour éxécuter le script d'installation des outils.*
-`sudo reboot`*Pour redémarer le système.*
## 4. À propos de la distribution Debian
### 4.1. Documentations
- https://www.debian.org/doc/
- https://debian-fr.org
- https://forum-debian.fr
- https://debian-facile.org
### 4.2. Quelques Questions
Le nom Debian vient de Debian = Debra + Ian Lan est le créateur de Debian distribution.Debra est la copine de Lan. [Source nom debian](https://wiki.debian.org/DebianName).
Le Projet Debian est une association de personnes qui ont fait cause commune afin de créer un système d’exploitation libre. [source](https://www.debian.org/doc/manuals/debian-reference/pr01.fr.html#_what_is_debian)
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.
Il existe 3 durées de prise en charge (support) de ces versions, dont :
- 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é).
- La durée en support long terme (LTS) : 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.
- La durée en support long terme étendue (ELTS) : La prise en charge à long terme étendue (ELTS) est une offre commerciale offrant un prolongement de la durée de vie de 10 ans des versions de Debian
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).
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.
Une fois le bogue résolu, un nouveau paquet est fourni sur [Debian Security](http://security.debian.org).
Versions courantes activement maintenues par debian :
- oldstable - La version précédant la version stable (Bullseye).
- stable - La version stable actuelle (Bookworm).
- testing - La prochaine version stable (Trixie).
- unstable - La version de développement instable (Sid), c'est là que sont ajoutés les nouveaux paquets ou les nouvelles mises à jour.
À 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.
Et donc Debian maintient trois versions activement : la version stable stable, la version unstable et la version testing.
Chaque distribution majeur possède un **nom de code** différent.
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”.
Le premier nom de code utilisé fut buzz (Debian 1.1), c’est le cosmonaute Buzz Lightyear.
Cette version a été publiée le 17 juin 1996 sous le nom de Debian GNU/Linux 1.1.
Cette version était était totalement en ELF (Executable and Linkable Format), utilisant le noyau Linux 2.0.
Le derrière nom de code annoncé à ce jour est sid, le garçon des voisins qui casse tous les jouets dans Toy Story.
Sid est en phase de développement, il n’y a donc pas de date de sortie annoncée.
La version précédente, le bookworm est sortie le 10 juin 2023.
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 Debian 12 "Bookworm").
(Questions 7 et 8 ; sources : [wikiDebian](https://wiki.debian.org/fr/DebianBuzz) et [debian.org-manuel](https://www.debian.org/doc/manuals/debian-faq/ftparchives.fr.html#sourceforcodenames) et [debian.org-bookworm](https://www.debian.org/releases/bookworm/))
## 5. INSTALLATIONS PAQUETS ET CONFIGURATION
Pour remplacer la chaîne @@UUID@@ par un identifiant unique universel.