Off-Host Execution Installation & Configuration

Advanced

Overview

Posit Connect supports an off-host execution model in which environments are built and content is executed in containers using Kubernetes. The choice to leverage container-based infrastructure can ease management of resource constraints and server costs, maximize process isolation, improve reproducibility, and simplify the maintenance of R and Python environments and system dependencies.

In local execution mode, the Connect application service and all published content execute on the same host. When using off-host execution with Kubernetes, published content is executed in an off-host container that is completely isolated from the Posit Connect service. For more detail on the available execution models, see the Architecture Overview.

Posit requires use of the Connect Helm chart to install and execute Connect in off-host execution mode.

For help with any other topology or deployment options, please speak to your dedicated Posit Customer Success contact or Posit Support () and request an architecture review session with Posit Solutions Engineering.

After completing the steps outlined within this document, you should have a Connect deployment on Kubernetes. Client requests for content execution will be served by pods running in the cluster.

Note

Download and/or use of Posit Connect is governed under the terms of the Posit End User License Agreement. By downloading you agree to the terms posted there.

Important

This guide is not necessarily suitable for all environments. Some instances might require you to deviate from the guide. In particular, if your organization has strict requirements about certificate management, storage, or ingress that prevent you from following some of these steps. If this is the case, review these examples to see if there is one that better matches your requirements.

Use of the off-host execution feature (in new or existing installations) on Connect requires the following steps:

Important

The off-host sections of this guide assume that the reader has a working knowledge of Kubernetes and Helm.

Feature requirements

  • Posit Connect >= v2023.05.0
  • A Posit Connect license permitting off-host execution
  • Kubernetes
  • PostgreSQL
  • StorageClass backed by POSIX-compliant PersistentVolume storage that supports symlinks and ReadWriteMany access.
Note

If your existing Posit Connect installation uses SQLite, follow the steps under the Changing Database Provider workflow to migrate to PostgreSQL.

To switch from using server-local storage to a networked file-system, follow the Migration to NFS workflow.

Note

To request an evaluation license, speak to your dedicated Posit Customer Success contact or email Posit Sales(). Mention that you are trialing off-host execution.