Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:manager [2017/11/02 21:11] – aleajactaest
+++ fr:manager [2021/12/03 18:19] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
 ====== Manager ======
-Présentation d'un outil pour manipuler/gérer les process du serveur khaganat
+{{ :fr:realization-of-video-771412_640.jpg?direct&450 |}}
+Présentation d'un outil python pour manipuler/gérer les process du serveur de jeu Ryzom Core pour Khanat.
@@ Ligne 9: / Ligne 11: @@
   * python3
+On récupère les scripts
+<WRAP center round important 90%>
+Attention, dans la version de test on pointe sur mon repo khanat-code, a terme on sera sur la branche officielle
+</WRAP>
+<code>
+git clone https://git.khaganat.net/aleajactaest/khanat-code.git
+cd khanat-code; git checkout feature/19-package-server-in-a-Docker-container; cd ..
+</code>
 ===== programme =====
@@ Ligne 36: / Ligne 50: @@
 ==== Création d'un certificat ====
-La communication entre le client et le serveur s’effectue via une clef et un certificat.
+Pour la création du certificat, nous utilisons la version TLS1.2.
-Cela sécurise la communication entre ce deux modules.
+Vous retrouver dans le code un script python pour générer (pour le test) les certificats
 <code>
-openssl req -nodes -x509 -newkey rsa:2048 -keyout "crt/key.pem" -out "crt/cert.pem" -days 365  -subj "/C=FR/ST=France/L=Paris/O=khaganat/CN=khaganat.org"
+khanat-code/code/khaganat/tools/create_certificate.py
 </code>
-On aura deux fichier :
+Il génère (en autre) :
-  * key.pem : clef
+  * ca/private/cakey.pem           : la clef de notre certificat racine
-  * cert.pem : certificat
+  * ca/certs/cacert.pem            : le certificat racine
+  * ca/appli/certs/applicert.pem   : le certificat utilisé par tous les composant du Manager
+  * ca/appli/certs/cachaincert.pem : concaténation du certificat racine & application
+  * ca/appli/private/serverkey.pem : la clef du certificat du serveur (manager)
+  * ca/appli/certs/servercert.pem  : le certificat du serveur (manager)
+  * ca/appli/private/clientkey.pem : la clef du certificat du client
+  * ca/appli/certs/clientcert.pem  : le certificat du client
 ==== Configuration ====
@@ Ligne 56: / Ligne 78: @@
 # Define port listen (default 8000)
 port = 8000
-# Generate key
-# openssl req -nodes -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -subj "/C=FR/ST=France/L=Paris/O=khaganat/CN=khaganat.org"
 # key
-keyfile = /home/gameserver/khanat/key.pem
+keyfile = /home/gameserver/ca/appli/private/serverkey.pem
 # certificate
-certfile = /home/gameserver/khanat/cert.pem
+certfile = /home/gameserver/ca/appli/certs/servercert.pem
+# certification to check signature
+ca_cert = /home/gameserver/ca/appli/certs/cachaincert.pem
 # address listen (default all port)
@@ Ligne 86: / Ligne 108: @@
 path = /home/gameserver/khanat/server/
-# size buffer log for each program launched
+# size buffer log for each program launched (number line stdout)
-sizelog = 1000
+logsize = 1000
+# buffer size (define value bufsize on subprocess.Popen, this buffer is use before read by manager)
+bufsize = 100
 # Define other program
@@ Ligne 107: / Ligne 132: @@
 contrôle l'état de tous les programmes (retourne "started" ou "stopped")
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="STATUSALL"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="STATUSALL"
 </code>
@@ Ligne 113: / Ligne 138: @@
 Démarre tous les programmes (retourne "started", "already-started" ou "crashed")
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="STARTALL"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="STARTALL"
 </code>
@@ Ligne 119: / Ligne 144: @@
 Arrête tous les programmes (retourne "stopped")
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="STOPALL"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="STOPALL"
 </code>
@@ Ligne 125: / Ligne 150: @@
 Arrête le manager (ainsi que tous les programmes)
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="SHUTDOWN"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="SHUTDOWN"
 </code>
@@ Ligne 131: / Ligne 156: @@
 Retourne la liste de tous les programmes disponible (démarré ou arrêté)
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="LIST"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="LIST"
 </code>
@@ Ligne 137: / Ligne 162: @@
 contrôle l'état de d'un programme (retourne "started" ou "stopped")
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="STATUS" --program="aes"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="STATUS" --program="aes"
 </code>
@@ Ligne 143: / Ligne 168: @@
 Démarre un programme (retourne "started" ou "stopped")
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="START" --program="aes"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="START" --program="aes"
 </code>
@@ Ligne 149: / Ligne 174: @@
 Arrête un programme (retourne "stopped")
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="STOP" --program="aes"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="STOP" --program="aes"
 </code>
@@ Ligne 157: / Ligne 182: @@
 firstline: première ligne que vous souhaitez récupérer
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="LOG" --program="aes" --firstline=0
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="LOG" --program="aes" --firstline=0
 </code>
@@ Ligne 164: / Ligne 189: @@
 <code>
-/home/gameserver/ext/khaganat/tools/client.py --key="/home/gameserver/khanat/key.pem" --cert="/home/gameserver/khanat/cert.pem" --log="info" --show-log-console --command="ACTION" --program="aes" --action="help all"
+/home/gameserver/ext/khaganat/tools/client.py --key /home/gameserver/ca/appli/private/clientkey.pem --cert /home/gameserver/ca/appli/certs/clientcert.pem --ca_cert /home/gameserver/ca/appli/certs/cachaincert.pem --log="info" --show-log-console --command="ACTION" --program="aes" --action="help all"
-</code
+</code>
 Souvent utilisé avec la commande "LOG" qui permet de voir le résultat.
+===== Fonctionnement =====
+Le serveur "manager" se met en écoute "style" https.
+Il attend les commandes et les envoient à ces fils (chaque fils gère un programme)
+Nous utilisons le format REST pour communiquer avec le serveur (les données envoyées au format json).