Agent-almanac deploy-shiny-app

install

source · Clone the upstream repo

git clone https://github.com/pjt222/agent-almanac

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/de/skills/deploy-shiny-app" ~/.claude/skills/pjt222-agent-almanac-deploy-shiny-app-428c76 && rm -rf "$T"

manifest: i18n/de/skills/deploy-shiny-app/SKILL.md

source content

Shiny-App deployen

Eine Shiny-App auf shinyapps.io, Posit Connect oder als Docker-Container für den Produktionseinsatz deployen.

Wann verwenden

Shiny-App einem breiteren Publikum zugänglich machen (nicht nur lokal)
Produktions-Deployment-Pipeline einrichten
App von einer Plattform auf eine andere migrieren
Deployment-Prozess für Updates automatisieren

Eingaben

Erforderlich: Laufende Shiny-App (lokal getestet)
Erforderlich: Deployment-Plattform:
```
shinyapps.io
```
,
```
posit-connect
```
oder
```
docker
```
Optional: Benutzerdefinierte App-URL/Name
Optional: Ressource-Limits (RAM, CPU für Posit Connect)

Vorgehensweise

Schritt 1: Dependencies verifizieren

Sicherstellen, dass alle App-Dependencies deklariert sind.

# Alle Packages die App verwendet auflisten
renv::dependencies("app.R")
# Oder für golem-Pakete:
renv::dependencies(".")

# renv-Lockfile erstellen/aktualisieren
renv::snapshot()

DESCRIPTION

-Datei (für golem-Pakete) prüfen:

Imports:
    shiny,
    dplyr,
    ggplot2

Erwartet: Alle Dependencies dokumentiert.

renv.lock

oder DESCRIPTION up-to-date.

Bei Fehler: Wenn fehlende Packages nach dem Deployment auftreten,

renv::dependencies()

erneut ausführen und fehlende Packages zur DESCRIPTION hinzufügen.

Schritt 2a: Auf shinyapps.io deployen

rsconnect einrichten und auf shinyapps.io deployen.

install.packages("rsconnect")

# Authentifizierung (von shinyapps.io Dashboard kopieren)
# Account → Tokens → Add Token → Show → Copy to Clipboard
rsconnect::setAccountInfo(
  name = "dein-account-name",
  token = "DEIN_TOKEN",
  secret = "DEIN_SECRET"
)

# Deployen
rsconnect::deployApp(
  appDir = ".",           # App-Verzeichnis
  appName = "meine-app",  # URL-Name (muss eindeutig sein)
  forceUpdate = TRUE      # Bestehende Deployment überschreiben
)

App-URL nach Deployment:

https://dein-account-name.shinyapps.io/meine-app/

Erwartet: Deployment-Logs zeigen erfolgreiche Paket-Installation und App-Start. URL zugänglich im Browser.

Bei Fehler: Wenn Deployment fehlschlägt mit "package not found", das fehlende Package zur App-Verzeichnis-renv.lock hinzufügen. Deployment-Logs für spezifische Package-Fehler prüfen.

Schritt 3: Post-Deployment-Verifikation

Das erfolgreiche Deployment und App-Verhalten prüfen.

# Deployment-Status prüfen
rsconnect::showLogs(appName = "meine-app")

# App-Informationen abfragen
rsconnect::appInfo(appName = "meine-app")

Manuell verifizieren:

App-URL im Browser öffnen
Alle interaktiven Elemente testen (Inputs, Buttons, Downloads)
Browser-Konsole auf JavaScript-Fehler prüfen
App-Logs im Plattform-Dashboard prüfen

Erwartet: App läuft korrekt auf deployed URL. Keine Fehler in Logs.

Bei Fehler: Bei Laufzeitfehlern in Deployment-Logs, fehlende Systembibliotheken oder R-Package-Versions-Konflikte prüfen. Lokale R-Version muss Deployment-Umgebung entsprechen.

Schritt 4: Deployment-Workflow dokumentieren

Deployment-Prozess für zukünftige Updates dokumentieren.

# deploy.R (Deployment-Skript)

# Deployment-Konfiguration
APP_NAME <- "meine-app"
APP_DIR <- "."

# Dependencies prüfen
cat("Checking dependencies...\n")
renv::status()

# Auf shinyapps.io deployen
cat("Deploying to shinyapps.io...\n")
rsconnect::deployApp(
  appDir = APP_DIR,
  appName = APP_NAME,
  forceUpdate = TRUE,
  launch.browser = FALSE
)

cat("Deployment complete!\n")
cat(sprintf("URL: https://account.shinyapps.io/%s/\n", APP_NAME))

Erwartet:

Rscript deploy.R

führt vollständiges Deployment aus.

Bei Fehler: Wenn Skript auf Authentifizierungsfehler stößt, rsconnect-Credentials über

rsconnect::setAccountInfo()

neu setzen.

Validierung

Alle App-Dependencies in renv.lock oder DESCRIPTION dokumentiert
rsconnect-Authentifizierung erfolgreich konfiguriert
App-URL zugänglich und lädt korrekt
Alle interaktiven Features funktionieren auf deployed App
Logs zeigen keine Fehler
Deployment-Skript dokumentiert für zukünftige Updates

Haeufige Stolperfallen

Nicht deklarierte Dependencies: Packages müssen explizit in renv.lock oder DESCRIPTION aufgelistet sein — lokale Paket-Bibliothek wird nicht migriert.
R-Versions-Mismatch: shinyapps.io läuft auf bestimmten R-Versionen. Lokale R-Version abgleichen oder Kompatibilität prüfen.
Secrets in Code: API-Keys oder Passwörter niemals hardcoden. Umgebungsvariablen in Plattform-Dashboard setzen.
App-Größenbeschränkungen: shinyapps.io hat 1-GB-Limit pro App. Große Datendateien extern hosten (z. B. S3, Google Drive).
Inaktivitäts-Timeout: Auf kostenlosem shinyapps.io-Tier gehen Apps nach Inaktivität schlafen. Für produktive Apps upgraden.
Gleichzeitige Verbindungen: Kostenloser Tier erlaubt 5 gleichzeitige Verbindungen. Für mehr Traffic Paid-Plan erforderlich.