KERHOST

Solution d'auto-hébergement simple est libre !

Outils pour utilisateurs

Outils du site


kerhost:spi

LES SITES PRÉ-INSTALLÉS (SPI)

01-Présentation

Les SPI (Sites Pré-Installé) sont des applications web développées par des tiers issus du logiciel libre que KerHost intègre en tant que déploiement semi-automatique pour les sites web persos des utilisateurs. En choisissant un SPI, l'utilisateur s’affranchit d'une installation parfois compliquée et fastidieuse (téléchargement de l'archive, upload FTP, changement de droits…). La liste des SPI disponibles par défaut est :

  • Dolibarr
  • Dokuwiki
  • Dotclear
  • Drupal
  • Doorgets
  • Zenphoto
  • Fluxbb
  • Galette
  • Joomla
  • Oscommerce
  • Piwigo
  • Prestashop
  • Spip
  • BlogoText
  • DropCenter
  • FreshRSS
  • Pluxml
  • Shaarli

Vous pouvez obtenir le descriptif de chaque SPI de la manière suivante :
 MON ⇒ Mes sites web ⇒ Liste de mes sites web perso hébergés sur l'instance ⇒ Actions : ⇒ Paramétrer ce site web perso ⇒ Configuration SitePré Installé ⇒ Descriptifs et versions des SPI disponibles .
Il est également possible de faire une demande de mise à jour d'un SPI. Les SPI sont mis à jour automatiquement à chaque nouvelles mises à jour de KerHost.

02-Liste des SPI

 ADMIN ⇒ Gérer les sites persos ⇒ Sites pré-installés ⇒ Liste des SPI disponibles dans la base 
A aprtir de ce bloc, il est possible de :

  • Activer/désactive un SPI. Si désactivé, il n'est plus disponible au déploiement
  • spi compatible avec le chroot
  • spi non compatible avec le chroot
  • affiche les infos relatives au spi au survol de la souris
  • permet d'accéder au site de mise à jour du spi
  • permet de modifier le spi
  • permet de supprimer le spi

kerhost:admin:swp_admin_spi_liste.png

03-Ajouter un spi

 ADMIN ⇒ Gérer les sites persos ⇒ Sites pré-installés ⇒ Ajouter un site pré-installé 
Pour ajouter un SPI, il vous faut au préalable confectionner l'archive de déploiement et renseigner les éléments suivants :

  • Le nom spi doit être en un seul mot, sans espaces ni caractères spéciaux, sans majuscule et de préférence court (ex : nextcloud).
  • La version ne doit contenir que des chiffres, des points et des lettres (ex : 5.2.36b).
  • La catégorie (type de SPI)
  • L'archive doit être impérativement au format tar.gz, avec comme nom nom_spi.tar.gz (ex : nextcloud.tar.gz), sans le numéro de version. Elle ne doit pas pouvoir s'extraire d'un dossier ou sous-dossier. Elle nécessite donc au préalable un certain traitement (en ligne de commande, se déplacer dans le dossier principal de l'application et taper : tar cvzf nom_spi.tar.gz *)
  • L'url maj (de mise à jour) doit contenir l'adresse de téléchargement du SPI sur le site officiel
  • L'url d'installation est le chemin où va pointer la configuration du SPI une fois qu'il est déployé. (exemple : /admin/install.php)
  • Ajouter un descriptif de l'application, un rapide aperçu de cette application
  • Une procédure d'installation détaillée qui sera affichée quand l'utilisateur aura déployé son SPI. En gros il s'agit de détailler assez précisément la procédure de configuration du SPI
  • Définir si ce SPI nécessite une base de données ou non
  • Choisir de l'activer ou non. L'activer le rendra disponible dans la liste des SPI pour l'utilisateur
  • La compatibilité chroot. Si ce n'est pas compatible et que le chroot est imposé, alors le SPI ne sera pas disponible au déploiement
  • Le chemin du fichier conf. Permet à KerHost de modifier automatiquement la configuration du spi en cas de changement de mot de passe SQL, ou de changement de propriétaire
  • Variable login SQL à détectée. Si le SPI nécessite une base de donnée SQL, indiquez le nom de la variable contenant le login SQL pour se connecter à la base de donné du fichier conf. Exemple : DC_LOGIN. N'indiquez pas les charactères $ ' “ Si celle-ci en contient un !
  • Variable password SQL à détectée. Si ce SPI nécessite une base de donnée SQL, indiquez le nom de la variable contenant le password SQL pour se connecter à la base de donné du fichier conf. Exemple : DC_DBPASSWORD. N'indiquez pas les charactères $ ' ” si celle-ci en contient un !
  • Chaîne de remplacement du login SQL. Si ce SPI nécessite une base de donnée SQL, indiquez la ligne complète du fichier conf contenant la variable du login SQL pour se connecter à la base de donné. Exemple : define('DC_LOGIN','LOGIN_SQL'); (remplacez bien le nom du login par la chaîne LOGIN_SQL !). Si la ligne contient un des caractères $ ' “ vous devez le saisir.
  • Chaîne de remplacement du password SQL. Si ce SPI nécessite une base de donnée SQL, indiquez la ligne complète du fichier conf contenant la variable du password SQL pour se connecter à la base de donné. Exemple : define('DC_PASSWORD','PASSWORD_SQL'); (remplacez bien le password par la chaîne PASSWORD_SQL !) Si la ligne contient un des caractères $ ' ” vous devez le saisir.

kerhost:admin:swp_spi_add.png

04-Gérer les catégories de spi

 ADMIN ⇒ Gérer les sites persos ⇒ Sites pré-installés ⇒ Gérer les catégories de SPI 
Il est également possible de gérer la liste des catégories de SPI. kerhost:admin:swp_spi_cat_liste.png

05-Ajouter une catégorie de spi

 ADMIN ⇒ Gérer les sites persos ⇒ Sites pré-installés ⇒ Ajouter une catégorie de SPI 
Et également d'ajouter une catégorie de SPI. kerhost:admin:swp_spi_cat_add.png

kerhost/spi.txt · Dernière modification: 2022/03/18 10:18 (modification externe)