Voir la source de Shiny server isig-apps

== Généralités ==
L'infrastructure est décomposée en 2 instances : une dev et une prod. La demande de création d'un environnement doit être adressée à [[Utilisateur:Sdunesme|l'administrateur]]. L'environnement peut être lié à une personne nommée ou à un projet.

L'instance de dev est équipée d'un [https://rstudio.evs.ens-lyon.fr RStudio Server] qui permet de développer directement dessus. On s'y connecte via les identifiants de l'environnement. Les applications sont ensuite accessibles '''en intranet''' à l'adresse <code><nowiki>https://isig-apps-dev.evs.ens-lyon.fr/apps/</nowiki><environnement>/</code>

La mise en prod peut être effectuée via [https://jenkins.evs.ens-lyon.fr Jenkins]. Il faut d'abord demander des identifiants à [[Utilisateur:Sdunesme|l'administrateur]]. Une fois son appli fonctionnelle en dev, on peut alors lancer la copie vers la prod grâce au job "Mise en production ISIG-App par copie". L'application sera ensuite accessible '''sur internet''' à l'adresse <code><nowiki>https://isig-apps.ens-lyon.fr/apps/</nowiki><environnement>/</code>

La version R actuellement installée est la 4.3.1. Chaque mise à jour est notifiée à tous les utilisateurs en amont. Elle est appliquée d'abord sur l'instance de dev, puis avec un délai sur l'instance de prod.

== Conception de l'appli ==

=== Un dossier=une appli ===

Pour une '''appli classique''', mettre à la racine de ce dossier '''app.R''' ou '''ui.R+server.R'''...

=== Cas particulier d'un tutoriel learnr ===

Exemple d''''entête yaml''' pour le .Rmd:<syntaxhighlight lang="yaml">
--- 
title: "Exos shiny" 
output: 
  learnr::tutorial: 
    progressive: true 
    allow_skip: true 
runtime: shiny_prerendered 
css: "www/style_tuto_learnr.css" 
---
</syntaxhighlight>

== Connection au serveur (pour le développeur) ==

Serveur '''gn-evs.ens-lyon.fr'''.

=== en ssh (par un terminal) ===

(pour installs de packages, git-clonage, consultation de logs, etc.)

Ouverture d'un terminal puis:<syntaxhighlight lang="bash">
ssh lvaudor@gn-evs.ens-lyon.fr
</syntaxhighlight>(fournir password ENS)

'''Installation de packages R''':

par ligne de commande en '''lançant R depuis le terminal''' puis<syntaxhighlight lang="r">
install.packages("nom_package")
</syntaxhighlight>

=== en sftp (par FileZilla par exemple) ===

(plus pratique pour noobs pour transferts de fichiers)

'''Nom d'hôte''' gn-evs.ens-lyon.fr:

* login: lvaudor
* mdp: mdp ENS

Accès à home/lvaudor/

'''Applis''' dans ShinyApps/ (un dossier=une appli)
Packages installés dans R/

== Accès aux applis (pour les utilisateurs)==

Page d'accueil: https://isig-apps.ens-lyon.fr/shiny/

Accès aux applis d'un développeur donné (par exemple lvaudor):

http://isig-apps.ens-lyon.fr/shiny/lvaudor/

Ici il y a un document index.html à la racine qui permet d'afficher l'ensemble des applis disponibles. Dans le cas contraire, chercher l'appli directement:

http://isig-apps.ens-lyon.fr/shiny/lvaudor/Restart_exos_base/

== Problèmes éventuels ==

=== Pour redémarrer une appli ===
Simplement recharger la page ne redémarre pas forcément l'appli. Pour forcer le restart, il faut créer (ou modifier) un fichier restart.txt dans le dossier de l'appli. Peu importe le contenu du fichier, ce qui compte est sa date et heure de modification. 

=== pour appli learnr ===

Attention `learnr` (et a fortiori `gradethis`) sont des packages "jeunes". => MAJ fréquentes et assez radicales... Bien '''mettre à jour les packages''' à la fois '''localement''' (tricotage de tuto.Rmd => tuto.html) et '''sur le serveur''' car learnr va de pair avec du shiny "prerendered" (i.e. il faut fournir le fichier html comme "pseudo-ui").

=== Debugging ===
 
La solution la plus basique pour enrichir un peu les logs est de rajouter <syntaxhighlight lang="bash">
cat(file=stderr(), "message", "\n")
</syntaxhighlight>

qui équivaut à un "print message dans le log"

=== Monitoring ===

Sur demande, possibilité de mettre en place un monitoring qui redémarre les applis en cas de plantage:

'''Processus:'''

# '''test de l'url''' de l'appli
# si il y a un '''problème''' (test renvoie autre chose qu'un code 200 (succès de la requête), alors
# '''modif du fichier restart.txt''' dans le dossier (causant un '''redémarrage de R''')

En l'état actuel des choses, sur lvaudor, quatre applis sont monitorées:

* Restart_exos_base
* Restart_exos_tableaux
* Restart_exos_graphiques
* shiny_exos
[[Catégorie:Tutoriel]]