Configuration nécessaire

• Le site doit être adapté à un déploiement sous Linux. Notamment, l'option "Activer les erreurs de compilation pour la compatibilité Linux" doit être active. Cette option est disponible dans l'onglet "Compatibilité" de la fenêtre de description de la configuration courante.
• La distribution Linux utilisée n'a pas d'importance. Cependant, pour utiliser le conteneur Docker contenant le serveur d'application WEBDEV, il est nécessaire de maîtriser Docker et notamment il est nécessaire de :
  • savoir installer un nouveau conteneur à partir de l'image Docker du serveur d'application WEBDEV,
  • gérer au moins un volume nécessaire à la persistance des données,
  • gérer la configuration réseau à l'intérieur de Docker. Par exemple, il faut pouvoir gérer le cas où un ou plusieurs conteneurs avec l'image du serveur d'application WEBDEV doivent accéder à des données hébergées par un serveur HFSQL Client/Serveur.

Exécution de l'image (création du conteneur)

• Le nom de l'image prédéfinie est :
  
  "windev/webdev:<Version>"
• Il faut activer le serveur d'application en transmettant le numéro de série sur la ligne de commande. Le paramètre à transmettre est de la forme :
  
  --configuration="<Numéro de série>-<Clé d'activation>"
  Si ce paramètre n'est pas indiqué, le serveur d'application utilisé sera un Serveur d'application 10 connexions.
• Pour avoir une persistance des applications et de leurs données (par exemple en cas changement de l'image), il faut :
  • Utiliser un volume. La commande de création d'un volume :
    
    "docker volume create <NomVolume>"
  • Monter le volume dans le conteneur sur
    
    "/var/lib/WEBDEV/<Version majeure.mineure>/"
• Un compte WEBDEV et un compte Linux (les deux) nommés "webdevuser" seront créés :
  • Un mot de passe sera généré et leur sera affecté.
  • Il est important de consulter la sortie du conteneur :
    • soit en effectuant un lancement interactif avec "-it",
    • soit en consultant les logs du conteneur avec la syntaxe :
      
      "docker logs <ID du conteneur>"

Notes (important)

• Un nouveau conteneur utilise les données d'un volume existant. Par exemple, le nouveau conteneur utilise les données d'un précédent conteneur suite à une mise à jour de l'image (changement de version (mineure) de WEBDEV). Dans ce cas :
  • Cette opération est possible uniquement avec une même version majeure.
  • Attention ! Un nouveau mot de passe est créé, ce mot de passe est appliqué au compte WEBDEV et un compte Linux (les deux) nommés "webdevuser", il faut donc changer le mot de passe lors des futurs déploiements de sites.
• Pour se connecter à l'administrateur distant "http[s]://<serveur>/WDAdminWeb" :
  • Le compte WEBDEV de déploiement :
    webdevuser/<Mot de passe généré et affiché>
• La bibliothèque libqtgui5 est installée : les images générées et les impressions sont disponibles. En revanche une seule police est installée.
• Rappel des commandes de base de docker :
  • Arrêt d'un conteneur :
    
    "docker stop <ID>"
  • Redémarrage d'un conteneur :
    
    "docker start <ID>"
  • Attention ! Pas de relancement interactif :
    
    "docker start -i <ID>"
    En effet, cela déclenche l'envoi du signal SIGWINCH que Apache interprète comme une commande d'arrêt.