epita/epitls_vm
1
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity

Update README.md

Browse source
This commit is contained in:
mb 2024-03-16 01:29:26 +01:00
parent 74ba0b70fe
commit e316a27520
1 changed files with 21 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

28
README.md
View file

@ -3,37 +3,51 @@
## Utiliser ## Utiliser
1. installer VirtualBox https://www.virtualbox.org/wiki/Downloads 1. installer VirtualBox https://www.virtualbox.org/wiki/Downloads
2. télécharger la vm au format .ova https://git.barnulf.net/epita/epitls_vm/releases/download/latest/epitls.ova 2. télécharger la vm au format .ova ici : https://git.barnulf.net/epita/epitls_vm/releases/download/latest/epitls.ova
3. importer la vm dans virtualbox (double cliquer le fichier) 3. importer la vm dans virtualbox (double cliquer le fichier)
## Contribuer ## Contribuer
Vous pouvez améliorer cette machine virtuelle en contribuant à ce dépot.
- Pour ajouter des logiciels, les rajouter dans la liste `packages` dans `src/iso_root/user_configuration.json`.
- Pour ajouter des fichiers à l'installation par défaut :
- Les intégrer dans `src/iso_root/content`.
- Modifier `src/iso_root/post_install.sh` pour installer les fichiers au bon endroit.
Pour publier vos changements, ouvrez une PR.
Si je ne réagis pas, me contacter par discord (@majorbarnulf) ou mail (matthieu@imagevo.fr).
### Dépendances ### Dépendances
Les logiciels suivants sont nécessaires pour générer la VM à partir de ce dépot.
- pacman - pacman
- wget - wget
- net-tools - net-tools
- archiso - archiso
- virtualbox - virtualbox
Archlinux est recommandé comme OS host pour générer la VM.
### Fabrication ### Fabrication
La fabrication de la machine virtuelle est assez farfelue mais ça marche assez bien. La fabrication de la machine virtuelle est assez farfelue mais ça marche assez bien.
Les étapes de la fabrication sont les suivantes : Les étapes de la fabrication sont les suivantes :
- création d'un ISO d'installation archlinux - création d'un ISO d'installation archlinux
- généré à partir du profil dans `./profile` - généré à partir du profil dans `./src/profile`
- contient un script d'installation automatisé qui est exécuté au boot `./profile/airootfs/root/.zlogin` - contient un script d'installation automatisé qui est exécuté au boot `./src/profile/airootfs/root/.zlogin`
- création d'une VM vide avec VirtualBox - création d'une VM vide avec VirtualBox
- bloc de commandes dans `./build.sh` - bloc de commandes dans `./src/build.sh`
- Boot de la VM sur l'ISO - Boot de la VM sur l'ISO
- aussi dans `./build.sh` - aussi dans `./src/build.sh`
- l'ISO installe la distribution - l'ISO installe la distribution
- installe arch `archinstall` avec la configuration `./profile/airootfs/root/user_*.json` - installe arch `archinstall` avec la configuration `./src/profile/airootfs/root/user_*.json`
- quelques ajustements avec `./profile/airootfs/root/post_install.sh` - quelques ajustements avec `./src/profile/airootfs/root/post_install.sh`
- stop une fois la machine virtuelle configurée - stop une fois la machine virtuelle configurée
- exporte la VM au format OVA dans `./output/epitls.ova` - exporte la VM au format OVA dans `./output/epitls.ova`