Overview
R users typically publish Shiny apps and other content via a push button deploy mechanism in the IDE. That mechanism calls R functions that can also be used outside the IDE in an R console. However, there are times where you may want to deploy content in Posit Connect without using the R console. In that case you can deploy content via the Posit Connect APIs.
Deployment Process
1. Create a content bundle
Typically, the R programmer will create the content bundle that will be deployed. The content bundle contains the application code (e.g. app.R), other files required by the application (e.g. data), and a manifest that describes the content requirements (e.g. manifest.json).
- Create a manifest
> rsconnect::writeManifest()
- Create a content bundle
$ tar czf bundle.tar.gz app.R data manifest.json
2. Deploy content bundle
You can use the Posit Connect API to deploy your content programmatically. Typically IT or engineering will set up the deployment process. The deployment process might involve a number of external systems such as Git or Jenkins; however, every process at some point should connect to the following API calls. Every content bundle is deployed with a globally unique identifier (guid).
- Create a new content placeholder (which also generates a new guid).
$ curl [options] POST \
-H "Authorization: Key ${CONNECT_API_KEY}" \
--data "${DATA}" \
"[api]/content/"
- Upload the bundle to Connect
$ curl [options] POST \
-H "Authorization: Key ${CONNECT_API_KEY}" \
--data-binary @"bundle.tar.gz" \
"[api]/content/[guid]/upload"
- Deploy the bundle in Connect
$ curl [options] POST \
-H "Authorization: Key ${CONNECT_API_KEY}" \--data "${DATA}"\
"[api]/content/[guid]/deploy"