Nastavení serveru

Požadavky

Chcete-li spustit reQual jako Shiny aplikaci na serveru, je třeba nejprve připravit prostředí. Konkrétní kroky nastavení se mohou lišit v závislosti na operačním systému. Podle příslušných pokynů níže nainstalujte na serveru požadované systémové závislosti (konkrétní příklad postupu instalace je v Discussion):

• R
• RStudio Server
• Shiny Server
• PostgreSQL
• volitelné: Pandoc (instalace Pandocu umožní export ve formátu html).

Nastavení aplikace Shiny

• Vytvořte databázi PostgreSQL, která bude sloužit jako úložiště dat pro requal. V této fázi stačí databázi pouze vytvořit. Aplikace requal bude definovat schéma databáze při svém prvním spuštění.
• Vytvořte adresář v rámci cesty k serveru Shiny (např. /srv/shiny-server/requal). Ten bude domovským adresářem vaší aplikace. Tento adresář otevřete jako projekt R nebo do něj přejděte pomocí příkazu setwd("/srv/shiny-server/requal") v R.
• Pro správu instalace requal doporučujeme použít balíček renv. Tento přístup umožňuje izolovat každou instanci aplikace requal a provozovat více verzí na stejném serveru.
• Pro instalaci balíčku requal použijte následující skript:

# install.packages("renv")
renv::install("RE-QDA/requal")
renv::snapshot(prompt = FALSE)
renv::isolate()

• Chcete-li aktualizovat requal, spusťte výše uvedený skript.
• V adresáři vaší aplikace vytvořte soubor R s názvem app.R.
• Soubor app.R naplňte následujícími údaji:

requal::run_app(
  mode = "server",
  dbname = "YOUR_DATABASE_NAME",
  dbusername = "YOUR_DATABASE_OWNER",
  dbpassword = "YOUR_DATABASE_PASSWORD",
  credentials_path = "USER_DATABASE_NAME.sqlite",
  credentials_pass = "USER_DATABASE_PASSWORD".
)

• Po instalaci requal a konfiguraci aplikace restartujte službu Shiny Server pomocí terminálového příkazu:

sudo systemctl restart shiny-server

Vaše instance aplikace requal by nyní měla být přístupná prostřednictvím serveru Shiny Server.

Zabezpečení

Jako správce instalace můžete určit úroveň správy přístupu k aplikaci (např. omezení přístupu na VPN chráněnou firewallem).

Chcete-li dodat hesla z vašeho úložiště tajných informací, použijte balíček keyring. Další informace naleznete v keyring documentation.

Zpracování uživatelských přihlašovacích jmen a hesel pomocí balíčku requal je vysvětleno v dokumentaci k balíčku shinymanager. Podrobnější informace naleznete v ní.