https://github.com/pdrhlik/msp_tools
Sada nástrojů pro nahrávání R Shiny aplikací a správu uživatelů na serveru.
https://github.com/pdrhlik/msp_tools
Last synced: 4 months ago
JSON representation
Sada nástrojů pro nahrávání R Shiny aplikací a správu uživatelů na serveru.
- Host: GitHub
- URL: https://github.com/pdrhlik/msp_tools
- Owner: pdrhlik
- Created: 2017-09-15T16:21:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-10-24T16:04:23.000Z (over 7 years ago)
- Last Synced: 2025-01-08T15:57:00.250Z (5 months ago)
- Language: Shell
- Homepage:
- Size: 3.91 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Tato sada programů byla vytvořena v rámci miniprojektu na [MTI FM TUL](http://www.fm.tul.cz/ustavy/ustav-mechatroniky-a-technicke-informatiky/o-ustavu). 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](https://www.rstudio.com/products/connect/), který je zpoplatněný. Zdarma se dá využít pouze k nahrávání na [shinyapps.io](http://www.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**](https://git-scm.com/downloads).
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í:
```bash
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í:
```bash
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í:
```bash
msp_deluser username
```
# Kontakt
[Patrik Drhlík](http://www.fm.tul.cz/personal/patrik.drhlik)
[Vratislav Žabka](http://www.fm.tul.cz/personal/vratislav.zabka)