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

Installation de 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
# docker-compose -f docker-compose.dev.yml 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.

Enregistrer un serveur comme client

Instancier une image OpenNebula (ex: aca.scribe-2.6.2-instance-AvecImport)

  • Sur le serveur client, activer le service salt-minion et changer l’adresse du service salt-master
# sed -i "s/#master: salt/master: eolebase/" /etc/salt/minion
# systemctl unmask salt-minion
# service salt-minion start
  • Sur la serveur Zéphir (Eolebase), lancer le script suivant pour accepter la clé du serveur client
# docker-compose -f docker-compose.dev.yml exec saltmaster sh epic1

Test de l’exécution d’une commande sur le serveur client via l’API

Sur le serveur Zéphir, lancer :

# curl -v -X 'POST' -d '{"kwargs":{"servername":"*", "salt_command":"cmd.run","salt_args":"ls /"}}' http://localhost:30005/api/v1/exec.salt

Architecture

_images/vue_globale.png