pdrhlik / msp_tools

Sada nástrojů pro nahrávání R Shiny aplikací a správu uživatelů na serveru.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Tato sada programů byla vytvořena v rámci miniprojektu na MTI FM TUL. Cílem je usnadnění nahrávání R Shiny aplikací na vlastní server.

Oficiální možnost nahrávání je k dispozici pouze skrze RStudio Connect, který je zpoplatněný. Zdarma se dá využít pouze k nahrávání na shinyapps.io, ale ne na vlastní server.

Jediná alternativa nahrávání na vlastní server, která je zdarma, je ruční kopírování souborů.

Instalace

Programy se nainstalují stažením jednotlivých skriptů. Nejjednodušším způsobem je instalace klonováním tohoto git repozitáře. Na systémech s operačním systémem Linux stačí mít nainsalovaný program git. Pro použití programu git na počítačích se systémem Windows doporučujeme stažení programu Git Bash.

Příkaz k instalaci programů do aktuální složky je git clone https://github.com/pdrhlik/msp_tools.git.

Program msp_upload je potřeba volat z kořenového adresáře Shiny aplikace.

msp_upload

Program nahraje R Shiny aplikaci na vlastní server. Program se volá z kořenového adresáře Shiny aplikace, která musí obsahovat konfigurační soubor config.cfg.

Příklad použití:

cd $SHINY_APP_DIRECTORY
msp_upload
# $USERNAME@$SERVER's password:
# $USERNAME@$SERVER's password:
# image.jpg	100%	400		0.4KB/s   00:00
# app.R	    100%    1579    1.5KB/s   00:00
# Project at: http://$SERVER/users/$USERNAME/$PROJECT_NAME

Konfigurační soubor

Každý Shiny projekt musí mít vyplněný konfigurační soubor config.cfg v kořenovém adresáři. Repozitář obsahuje šablonu, kterou je potřeba vyplnit.

  • SERVER: URL adresa serveru.
  • USERNAME: Uživatelské jméno, jehož účet je na serveru registrovaný.
  • REMOTE_DIR: Adresář, do kterého se složka s aplikací nahraje. Defaultně je nastavený na /home/$USERNAME/ShinyApps
SERVER=""
USERNAME=""
REMOTE_DIR=/home/$USERNAME/ShinyApps

msp_adduser

Program je určen pouze pro administrátory serveru.

Program vytvoří uživatele, vygeneruje mu heslo a správnou adresářovou strukturu pro nahrávání Shiny aplikací. Program se musí volat ze stejného adresáře, v kterém je soubor template.html. Ten slouží k vygenerování html šablony stránky nově vytvořeného uživatele.

Příklad použití:

msp_adduser username

msp_deluser

Program je určen pouze pro administrátory serveru.

Program kompletně smaže uživatele včetně domácího adresáře.

Příklad použití:

msp_deluser username

Kontakt

Patrik Drhlík

Vratislav Žabka

About

Sada nástrojů pro nahrávání R Shiny aplikací a správu uživatelů na serveru.


Languages

Language:Shell 94.7%Language:HTML 5.3%