my_webapp_ynh/doc/ADMIN_fr.md
Antoine Lima 9c6143df27
Add NodeJS server as an alternative to PHP
This adds:
- Two entries in the manifest:
    - A choice for the NodeJS version
    - A port (provisionned in any case due to ynh limitations, but this should not matter)
- Services and configs:
    - Systemctl configs to run the NodeJS server
    - A watcher service and path to restart NodeJS upon file update
    - A custom NGinx config because it is incompatible with the default one
- Docs:
    - More info in the description and admin

The install/remove/backup/restore have been adapted and tested.
The upgrade script is updated but not tested
The change_url script does not change

It is not possible to have both PHP and NodeJS to keep the scripts simple.
2024-03-10 14:43:30 +01:00

2.3 KiB

Cette app est uniquement un squelette : il vous appartient d'ajouter vos propre pages HTML, CSS, PHP, ... à l'intérieur de __INSTALL_DIR__/www/. Une manière de procéder est d'utiliser SFTP.

Connexion avec SFTP

Une fois installée, rendez-vous sur l'URL choisie pour connaître le nom d'utilisateur, le domaine et le port que vous devrez utiliser pour l'accès SFTP.

  • Hôte: __DOMAIN__
  • Nom d'utilisateur: __ID__
  • Mot de passe: mot de passe défini lors de l'installation
  • Port: 22 (à moins que vous ayez changé le port SSH)

Pour vous connecter, vous devrez utiliser une application SFTP tel que Filezilla pour Windows, Mac ou Linux. Vous pouvez aussi directement utiliser votre gestionnaire de fichiers sous Linux ou Mac.

Oubli du mot de passe SFTP

Si vous avez oublié votre mot de passe SFTP, vous pouvez le changer dans la webadmin de Yunohost dans Applications > Votre webapp > My Webapp configuration. Vous pourrez aussi vérifier que SFTP est activé pour votre app.

Connexion par le terminal

A partir de YunoHost v11.1.21, vous pouvez lancer sudo yunohost app shell __APP__ dans un terminal pour vous connecter en tant que l'utilisateur gérant l'app.

La commande php pointera vers la version de PHP installée pour l'app.

Ajouter ou modifier les fichiers

Après vous être connecté, sous le répertoire Web vous verrez un dossier www qui contient les fichiers publics servis par cette application. Vous pouvez mettre tous les fichiers de votre application Web personnalisée à l'intérieur.

Personnaliser la configuration nginx

Si vous souhaitez ajuster la configuration nginx pour cette app, il est recommandé d'éditer /etc/nginx/conf.d/__DOMAIN__.d/__ID__.d/WHATEVER_NAME.conf (assurez-vous que le fichier a l'extension .conf) puis rechargez nginx après vous être assuré que la configuration est valide à l'aide de nginx -t.

Écouter le bon port dans NodeJS

Le port d'écoute est accessible par le processus node au travers de la variable d'environment PORT. Veillez à ce que votre fichier .js principal le récupère bien avec process.env.PORT car sa valeur n'est pas prédictible.