Prise en main (Getting Started)

Présentation du projet Zéphir

Nom du projet:Zéphir
URL du projet:https://dev-eole.ac-dijon.fr/git/zephir.git
version:alpha

Installer l’application sur un serveur Eolebase

Installation des outils Docker / Docker-compose :

Récupérer l’application Zéphir

# git clone https://username@dev-eole.ac-dijon.fr/git/zephir.git && cd zephir

(username est pour l’accès en écriture au projet, nécessite un compte développeur sur la forge EOLE)

Se placer sur la version en cours de développement et créer les images Docker

# git checkout develop
# ouvre.firewall (arrêt du service de gestion du pare-feu)
# service docker restart
# ./bin/zephir-compose -b dev -- up --build

(utiliser up -d pour lancer l’application en arrière plan)

La commande docker-compose va tirer les dockers suivants :

  • kong = un docker
  • crossbar = un docker
  • bdd = un docker
  • salt master + controlleur = un docker

La liste complète des services est visible dans le répertoire services du dépôt.

Appairer un serveur

Instancier une image OpenNebula (ex: aca.eolebase-2.6.2.1-Daily)

  • Se connecter au serveur client
# ssh root@scribe.ac-test.fr
  • Depuis l’interface web du Zéphir :

Créer le serveur sur le Zéphir

Dans le menu serveur choisir le serveur et aller dans « Appairage du serveur » et télécharger le fichier de configuration.

  • Sur le serveur à enregistrer :

Placer la configuration du serveur reçue depuis le Zéphir dans un fichier (au format json)

# vi /root/peer_conf.json

Puis y coller {"pub_key": "-----BEGIN [...] , "serverid": "1"} et sauvegarder.

  • Installation des paquets nécessaires
# apt install git make
  • Cloner les sources
# git clone http://dev-eole.ac-dijon.fr/git/zephir-connect.git && cd zephir-connect && git checkout develop
  • Builder
# make install
  • Installer le minion
# install_zephir_minion

La commande est dans le PATH.

  • Connecter le module à Zéphir
# zephir-connect /root/peer_conf.json

La “passphrase” fournie lors de la création du serveur sur le Zéphir est demandée.

  • Vérifier l’état du minion
# service salt-minion status

Architecture

_images/vue_globale.png