KAZ
/
kaz-vagrant
2
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1 Commit
1 Branch
1 Tag
861 KiB
 
 
 
 
Tree: 2477cdfbe9
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '2477cdfbe9'
${ noResults }
kaz-vagrant/DETAILS.md

6.7 KiB
Raw Blame History

kaz-vagrant

Kaz est un CHATONS du Morbihan. Nous proposons ici un moyen de le répliquer dans d'autres lieux. Il y a des éléments de configuration à définir avant d'initialiser ce simulateur.

Le principe est de faire fonctionner un simulateur de notre CHATONS dans une VirtualBox pour mettre au point nos différents services.

Nous utilisons :

  • Vagrant pour automatiser la création de la Machine Virtuelle
  • VirtualBox pour simuler notre serveur
  • Docker pour chaque service de notre serveur

Pré-requis

Dans la suite, on imagine que vous disposer d'une machine sous Linux (par exemple dernière version de Debian)

Vous devez disposer d'un minimum de paquets :

wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | apt-key add -
wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | apt-key add -
apt install software-properties-common
add-apt-repository "deb [arch=amd64] http://download.virtualbox.org/virtualbox/debian $(lsb_release -cs) contrib"
apt update
apt install git vagrant virtualbox-6.1 linux-image
vagrant plugin install vagrant-disksize

Lancez VirtualBox et vérifiez les mises à jours.

Par la suite, si vous ne disposez pas d'un bon débit, il est conseiller d'installer approx et squid pour ne pas recharger systématiquement tous les paquets depuis l'internet.

pour approx, vous pouvez choisir une partition de stockage /mnt/big/approx

apt-get install approx
netstat -ant | grep 9999
mkdir /mnt/big/approx
chown -R approx : /mnt/big/approx
rmdir /var/cache/approx
ln -s /mnt/big/approx/ /var/cache/
cd /etc/apt/
grep -E "^[^#]" sources.list | cut -d " " -f2 | sort -u >> /etc/approx/approx.conf

Pour squid, vous pouvez choisir une partition de stockage /mnt/big/squid

apt-get install squid
emacs /etc/squid/squid.conf

mkdir /mnt/big/squid
chown -R proxy: /mnt/big/squid
rmdir  /var/spool/squid/
ln -s /mnt/big/squid/ /var/spool/squid/

/etc/init.d/squid restart

Si vous utilisez un ordinateur portable, votre adresse IP changera sûrement au grè de vos connexions à l'Internet. Dans ce cas il est préférable d'utiliser une adresse stable pour designer votre mandataire. Après vous êtes connecté, il faudra ajouter une adresse à la carte réseaux qui est active. Dans l'exemple suivant, nous imaginons que la connexion utilise le wifi wlo1̀ que nous utilisons une classe privée locale 192.168.128.0/25̀ et que notre machine utilisera la première adresse.

/sbin/ifconfig
/sbin/ifconfig wlo1:0 192.168.128.1/25
/sbin/ifconfig wlo1:0 up
/sbin/ifconfig

Installation

  • Télécharger le dépôt kaz-vagrant ou utilisez la commande :
git clone https://git.kaz.bzh/KAZ/kaz-vagrant.git # pour essayer
git clone git+ssh://git@git.kaz.bzh:2202/KAZ/kaz-vagrant.git # pour contribuer
cd kaz-vagrant/
  • Personalisez votre simulateur avec la commande (au besoin ajustez la mémoire et les cpus utilisés dans Vagrantfile) :
vagrant plugin install vagrant-disksize
init.sh
  • Personnalisez le miroir des paquets Debian si vous en avez un (sinon ignorez cette étape).
    Pour cela créez un fichier qui défini des variables d'environnements qui pointent vers l'hôte et le port (dans l'exemple suivant on prend (machine : mirror-host, port : mirror-port) dans un fichier files/.apt-mirror-config comme ci-dessous
APT_MIRROR_DEBIAN=mirror-host:mirror-port
APT_MIRROR_SECURITY=mirror-host:mirror-port

VirtualBox utilise un réseau privé 172.17.X.X

Pour pouvoir désigner dans conflit votre PC comme mirror, vous pouvez déclarer un autre réseau (par exemple 172.19.X.X)

/sbin/ifconfig (eno2) add 172.19.1.1 netmask 255.255.255.0

Dans ce cas, il faut refaire le init.sh pour mettre à jour l'adresse IP du serveur mirroir.

  • Pour créer tout l'univers Kaz il faut se placer dans le répertoire et lancer la commande :
vagrant up

Il faudra répondre "docker0" à la question "Which interface should the network bridge to?"

Il est possible d'interrompre la création à la coquille vide (sans les services) pour des question de mise au point avec la commande :

NOKAZ="true" vagrant up

Il se peut que le répertoire /vagrant ne soit pas monté. Dans ce cas. Quittez la VM et relancez vagrant up.

Il est possible de choisir de tester une autres branche de développement du dépôt de Kaz.

KAZBRANCH="develop" vagrant up

  • Une fois la commande de création de l'univers, il faut patienter...

  • Après il faut patienter encore un peu si on a pas la fibre ...

La fenêtre de virtualbox va se lancer et l'installation va se poursuivre

La progression est visible dans la fenêtre où la commande vagrant est lancée.

Utilisation

Les utilisateurs créés sont

  • debian/debian
  • root/root.

Si vous avec laissé la création des dockers, il faut bien attendre la fermeture automatique de la fenêtre et l'apparition de l'écran de connexion (on vous a dit que c'était long).

Vous pouvez alors démarrer le client de messagerie clawsmail dans lequel 4 comptes ont été paramétrés (contact1@kaz.local, contact2@kaz.local, contact3@kaz.local, contact4@kaz.local)

Il y a un aperçu de l'état des services avec l'url https://kaz.local/status/allServices.html

status

Les erreurs 502 correspondent à des fonctions en cours de développement. Les message "Can't open this page" correspond au fait que le services refuse pour des raison de sécurité de de fonctionner embarqué dans une page.

Vous pouvez également démarrer firefox avec les URL suivantes:

Il vous faudra accepter les alertes de sécurité pour certificat absent (web et messagerie)

Echanges avec la machine virtuelle

En cas de nouvelle re-création, la clef privée sera mise à jour. Il faudra effacer l'ancienne pour ne pas avoir le message :

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Pour cela il faut supprimer l'entrée des hôtes connus :

ssh-keygen -f ~/.ssh/known_hosts -R "[127.0.0.1]:2222"

Pour copier des fichiers vers la machine virtuelle :

rsync -rlptDEHAX --no-o -e "ssh -p 2222 -i ~/git/kaz-vagrant/.vagrant/machines/default/virtualbox/private_key"  src vagrant@127.0.0.1:/dst