문서 실행

개요

Shiny 인터랙티브 문서를 실행하는 방법은 여러 가지가 있습니다.

이 섹션에서 모두 자세히 다룹니다. 인터랙티브 Shiny 문서를 실행하려면 최신 버전의 rmarkdown 패키지(v2.10)를 설치해야 합니다. 다음과 같이 설치할 수 있습니다.

install.packages("rmarkdown")

인터랙티브 문서를 개발할 때는 RStudio에서 실행하는 것이 가장 편리합니다.

Quarto 인터랙티브 문서를 실행하려면 RStudio v2022.07 이상이 필요합니다. 최신 릴리스는 https://posit.co/download/rstudio-desktop/에서 다운로드할 수 있습니다.

Shiny 인터랙티브 문서를 편집하는 동안 Run Document 버튼을 클릭하면 IDE 안에서 문서를 렌더링하고 확인할 수 있습니다.

변경 사항을 반영하려면 다시 Run Document를 클릭하세요.

Run on Save와 Preview in Viewer Pane 옵션을 활성화하는 것도 고려해볼 만합니다(기본값은 외부 창에서 미리보기). 이 옵션은 편집기 도구 모음에서 접근할 수 있습니다.

quarto serve를 사용해 명령줄에서도 Shiny 인터랙티브 문서를 실행할 수 있습니다. 예를 들어 다음과 같습니다.

Terminal

quarto serve document.qmd

serve 명령에는 문서 서버의 포트와 호스트를 제어하는 옵션, 실행 중인 문서를 브라우저에서 자동으로 열지 여부를 결정하는 옵션 등이 있습니다. quarto serve help로 자세히 확인하세요.

R 세션 안에 있다면 quarto R 패키지를 사용해 문서를 실행할 수도 있습니다.

library(quarto)
quarto_serve("document.qmd")

Shiny 인터랙티브 문서를 ShinyApps 호스팅 서비스에 배포할 수 있습니다. 이를 위해 다음이 필요합니다.

ShinyApps 계정(계정 생성은 가입 폼 사용)
최신 버전의 rsconnect 및 quarto R 패키지(다음과 같이 설치)
```
install.packages("rsconnect")
install.packages("quarto")
```

그다음 quarto 패키지의 quarto_publish_app() 함수로 인터랙티브 문서를 배포할 수 있습니다. 문서가 있는 디렉터리에서 다음을 실행하세요.

library(quarto)
quarto_publish_app(server = "shinyapps.io")

RStudio를 사용하는 경우 인터랙티브 문서를 작업할 때 사용할 수 있는 Publish 버튼 을 사용할 수도 있습니다.

문서를 배포하기 전에 항상 로컬에서 Run Document를 실행해야 합니다(ShinyApps에서 제공되는 .html 파일이 생성되기 때문입니다).

HuggingFace Spaces는 Shiny for R 애플리케이션 배포를 위한 SDK를 제공합니다. Shiny for R과 함께 HuggingFace를 사용하는 방법은 https://huggingface.co/docs/hub/spaces-sdks-docker-shiny#shiny-for-r에서 확인하세요.

Posit Connect는 애플리케이션, 보고서, 플롯을 안전하게 공유하기 위한 Posit의 서버 제품입니다. Shiny 인터랙티브 문서는 위의 ShinyApps와 유사한 방식으로 Posit Connect에 배포할 수 있습니다.

먼저 최신 개발 버전의 rsconnect 및 quarto R 패키지를 설치하세요.

install.packages("rsconnect")
install.packages("quarto")

그다음 quarto 패키지의 quarto_publish_app() 함수로 인터랙티브 문서를 배포합니다. server 파라미터에 Posit Connect 설치의 도메인 이름 또는 IP 주소를 제공하세요. 문서가 있는 디렉터리에서 다음을 실행합니다.

library(quarto)
quarto_publish_app(server = "rsc.example.com")

RStudio를 사용한다면 ShinyApps 문서에서 설명한 대로 Publish 버튼 을 사용할 수도 있습니다.

ShinyApps와 마찬가지로 문서를 배포하기 전에 항상 로컬에서 Run Document를 실행해야 합니다(Posit Connect에서 제공되는 .html 파일이 생성되기 때문입니다).