Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Justfile
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ test-connect-interpreter-versions:
helm template ./charts/rstudio-connect \
--set launcher.enabled=false \
--show-only templates/deployment.yaml | \
grep "image\:.*rstudio-connect.*" | \
grep "image\:.*posit/connect\:.*" | \
awk -F": " '{print $2}' | \
xargs)

Expand Down
6 changes: 3 additions & 3 deletions charts/rstudio-connect/Chart.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: rstudio-connect
description: Official Helm chart for Posit Connect
version: 0.9.2
version: 0.20.0
apiVersion: v2
appVersion: 2026.03.1
icon: https://raw.githubusercontent.com/rstudio/helm/main/images/posit-icon-fullcolor.svg
Expand All @@ -17,8 +17,8 @@ dependencies:
repository: https://helm.rstudio.com
annotations:
artifacthub.io/images: |
- name: rstudio-connect
image: rstudio/rstudio-connect:ubuntu2204-2026.03.1
- name: connect
image: posit/connect:2026.03.1-ubuntu-24.04
artifacthub.io/license: MIT
artifacthub.io/links: |
- name: Docker Images
Expand Down
10 changes: 10 additions & 0 deletions charts/rstudio-connect/NEWS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
# Changelog

## 0.20.0

- BREAKING:
- Default images now use `posit/connect` instead of `ghcr.io/rstudio/rstudio-connect`
- Image tag format changed from `{os}{version}` (e.g. `ubuntu2204-2026.03.1`) to `{version}-{os}` (e.g. `2026.03.1-ubuntu-24.04`)
- `image.tagPrefix` replaced by `image.os`; `launcher.defaultInitContainer.tagPrefix` replaced by `launcher.defaultInitContainer.os`
- Remove `launcher.customRuntimeYaml` and `launcher.additionalRuntimeImages`. Use `executionEnvironments` for declarative management of execution environments.
- Remove the bundled `default-runtime.yaml` and `default-runtime-pro.yaml` files.
- Default Quarto executable path for Local Execution updated to `/usr/local/bin/quarto`

## 0.9.2

- Add `events: list` permission to the direct Kubernetes runner Role. Connect 2026.04.0 lists events in the target namespace when a content pod fails to start and the failure reason cannot be determined from pod conditions.
Expand Down
26 changes: 12 additions & 14 deletions charts/rstudio-connect/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Posit Connect

![Version: 0.9.2](https://img.shields.io/badge/Version-0.9.2-informational?style=flat-square) ![AppVersion: 2026.03.1](https://img.shields.io/badge/AppVersion-2026.03.1-informational?style=flat-square)
![Version: 0.20.0](https://img.shields.io/badge/Version-0.20.0-informational?style=flat-square) ![AppVersion: 2026.03.1](https://img.shields.io/badge/AppVersion-2026.03.1-informational?style=flat-square)

#### _Official Helm chart for Posit Connect_

Expand Down Expand Up @@ -30,11 +30,11 @@ To ensure reproducibility in your environment and insulate yourself from future

## Installing the chart

To install the chart with the release name `my-release` at version 0.9.2:
To install the chart with the release name `my-release` at version 0.20.0:

```{.bash}
helm repo add rstudio https://helm.rstudio.com
helm upgrade --install my-release rstudio/rstudio-connect --version=0.9.2
helm upgrade --install my-release rstudio/rstudio-connect --version=0.20.0
```

To explore other chart versions, look at:
Expand Down Expand Up @@ -199,8 +199,8 @@ can be set and the release can be upgraded to include the new value.

This chart supports [declarative management of execution environments](https://docs.posit.co/connect/admin/appendix/off-host/execution-environments/#declarative-management)
via `ExecutionEnvironments.ConfigFilePath`. Requires Connect version 2026.03.0 or later.
Unlike the legacy `launcher.customRuntimeYaml`, changes to `executionEnvironments`
take effect on every `helm upgrade` without requiring a pod restart or database reset.
Changes to `executionEnvironments` take effect on every `helm upgrade` without
requiring a pod restart or database reset.

When `executionEnvironments` is set, the chart renders the list into a dedicated
ConfigMap and mounts it into the Connect pod. Connect only manages the execution
Expand Down Expand Up @@ -297,31 +297,29 @@ The Helm `config` values are converted into the `rstudio-connect.gcfg` service c
| command | list | `[]` | The pod's run command. By default, it uses the container's default |
| config | object | [Posit Connect Configuration Reference](https://docs.posit.co/connect/admin/appendix/off-host/helm-reference/) | A nested map of maps that generates the rstudio-connect.gcfg file |
| deployment.annotations | object | `{}` | Additional annotations to add to the rstudio-connect deployment |
| executionEnvironments | list | `[]` (disabled) | Optional list of execution environments to manage declaratively. Requires Connect version 2026.03.0 or later. When set, the chart renders these into a ConfigMap, mounts it into the Connect pod, and sets ExecutionEnvironments.ConfigFilePath in the Connect configuration. Unlike launcher.customRuntimeYaml, changes take effect on every helm upgrade without requiring a pod restart or database reset. |
| executionEnvironments | list | `[]` (disabled) | Optional list of execution environments to manage declaratively. Requires Connect version 2026.03.0 or later. When set, the chart renders these into a ConfigMap, mounts it into the Connect pod, and sets ExecutionEnvironments.ConfigFilePath in the Connect configuration. Changes take effect on every helm upgrade without requiring a pod restart or database reset. |
| extraObjects | list | `[]` | Extra objects to deploy (value evaluated as a template) |
| fullnameOverride | string | `""` | The full name of the release (can be overridden) |
| image | object | `{"imagePullPolicy":"IfNotPresent","imagePullSecrets":[],"repository":"ghcr.io/rstudio/rstudio-connect","tag":"","tagPrefix":"ubuntu2204-"}` | Defines the Posit Connect image to deploy |
| image | object | `{"imagePullPolicy":"IfNotPresent","imagePullSecrets":[],"os":"ubuntu-24.04","repository":"posit/connect","tag":""}` | Defines the Posit Connect image to deploy |
| image.imagePullPolicy | string | `"IfNotPresent"` | The imagePullPolicy for the main pod image |
| image.imagePullSecrets | list | `[]` | an array of kubernetes secrets for pulling the main pod image from private registries |
| image.repository | string | `"ghcr.io/rstudio/rstudio-connect"` | The repository to use for the main pod image |
| image.os | string | `"ubuntu-24.04"` | The OS version for the image tag (e.g. ubuntu-24.04, ubuntu-22.04). Only used if tag is not defined |
| image.repository | string | `"posit/connect"` | The repository to use for the main pod image |
| image.tag | string | `""` | Overrides the image tag whose default is the chart appVersion. |
| image.tagPrefix | string | `"ubuntu2204-"` | A tag prefix for the server image (common selections: jammy-, ubuntu2204-). Only used if tag is not defined |
| ingress.annotations | object | `{}` | |
| ingress.enabled | bool | `false` | |
| ingress.hosts | string | `nil` | |
| ingress.ingressClassName | string | `""` | The ingressClassName for the ingress resource. Only used for clusters that support networking.k8s.io/v1 Ingress resources |
| ingress.tls | list | `[]` | |
| initContainers | bool | `false` | The initContainer spec that will be used verbatim |
| launcher.additionalRuntimeImages | list | `[]` | Deprecated, use `executionEnvironments` instead. Optional. Additional images to append to the end of the "launcher.customRuntimeYaml" (in the "images" key). If `customRuntimeYaml` is a "map", then "additionalRuntimeImages" will only be used if it is a "list". |
| launcher.customRuntimeYaml | string | `""` | Deprecated, use `executionEnvironments` instead. Optional. The runtime.yaml definition of Kubernetes runtime containers. If set to "base", will pull in the default runtime.yaml file. If set to "pro", will pull in the "pro" versions of the default runtime images (i.e. including the pro drivers at the cost of a larger image). Starting with Connect v2023.05.0, this configuration is used to bootstrap the initial set of execution environments the first time the server starts. If any execution environments already exist in the database, these values are ignored; execution environments are not created or modified during subsequent restarts. |
| launcher.defaultInitContainer | object | `{"enabled":true,"imagePullPolicy":"","repository":"ghcr.io/rstudio/rstudio-connect-content-init","resources":{},"securityContext":{},"tag":"","tagPrefix":"ubuntu2204-"}` | Image definition for the default Posit Connect Content InitContainer |
| launcher.defaultInitContainer | object | `{"enabled":true,"imagePullPolicy":"","os":"ubuntu-24.04","repository":"posit/connect-content-init","resources":{},"securityContext":{},"tag":""}` | Image definition for the default Posit Connect Content InitContainer |
| launcher.defaultInitContainer.enabled | bool | `true` | Whether to enable the defaultInitContainer. If disabled, you must ensure that the session components are available another way. |
| launcher.defaultInitContainer.imagePullPolicy | string | `""` | The imagePullPolicy for the default initContainer |
| launcher.defaultInitContainer.repository | string | `"ghcr.io/rstudio/rstudio-connect-content-init"` | The repository to use for the Content InitContainer image |
| launcher.defaultInitContainer.os | string | `"ubuntu-24.04"` | The OS version for the image tag (e.g. ubuntu-24.04, ubuntu-22.04). Only used if tag is not defined |
| launcher.defaultInitContainer.repository | string | `"posit/connect-content-init"` | The repository to use for the Content InitContainer image |
| launcher.defaultInitContainer.resources | object | `{}` | Optional resources for the default initContainer |
| launcher.defaultInitContainer.securityContext | object | `{}` | The securityContext for the default initContainer |
| launcher.defaultInitContainer.tag | string | `""` | Overrides the image tag whose default is the chart appVersion. |
| launcher.defaultInitContainer.tagPrefix | string | `"ubuntu2204-"` | A tag prefix for the Content InitContainer image (common selections: jammy-, ubuntu2204-). Only used if tag is not defined |
| launcher.enabled | bool | `true` | Whether to enable the launcher |
| launcher.extraTemplates | object | `{}` | extra templates to render in the template directory. |
| launcher.includeDefaultTemplates | bool | `true` | whether to include the default `job.tpl` and `service.tpl` files included with the chart |
Expand Down
4 changes: 2 additions & 2 deletions charts/rstudio-connect/README.md.gotmpl
Original file line number Diff line number Diff line change
Expand Up @@ -139,8 +139,8 @@ can be set and the release can be upgraded to include the new value.

This chart supports [declarative management of execution environments](https://docs.posit.co/connect/admin/appendix/off-host/execution-environments/#declarative-management)
via `ExecutionEnvironments.ConfigFilePath`. Requires Connect version 2026.03.0 or later.
Unlike the legacy `launcher.customRuntimeYaml`, changes to `executionEnvironments`
take effect on every `helm upgrade` without requiring a pod restart or database reset.
Changes to `executionEnvironments` take effect on every `helm upgrade` without
requiring a pod restart or database reset.

When `executionEnvironments` is set, the chart renders the list into a dedicated
ConfigMap and mounts it into the Connect pod. Connect only manages the execution
Expand Down
98 changes: 0 additions & 98 deletions charts/rstudio-connect/default-runtime-pro.yaml

This file was deleted.

98 changes: 0 additions & 98 deletions charts/rstudio-connect/default-runtime.yaml

This file was deleted.

35 changes: 0 additions & 35 deletions charts/rstudio-connect/lint/launcher-advanced-values.yaml

This file was deleted.

38 changes: 0 additions & 38 deletions charts/rstudio-connect/lint/launcher-advanced2-values.yaml

This file was deleted.

Loading
Loading