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
10 changes: 5 additions & 5 deletions charts/rstudio-workbench/Chart.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: rstudio-workbench
description: Official Helm chart for Posit Workbench
version: 0.11.0
version: 0.20.0
apiVersion: v2
appVersion: 2026.01.2
icon:
Expand All @@ -18,10 +18,10 @@ dependencies:
repository: https://helm.rstudio.com
annotations:
artifacthub.io/images: |
- name: rstudio-workbench
image: rstudio/rstudio-workbench:ubuntu2204-2026.01.2
- name: r-session-complete
image: rstudio/r-session-complete:ubuntu2204-2026.01.2
- name: workbench
image: posit/workbench:2026.01.2-ubuntu-24.04
- name: workbench-session
image: posit/workbench-session:R4.5.2-python3.14.3-ubuntu-24.04
artifacthub.io/license: MIT
artifacthub.io/links: |
- name: Docker Images
Expand Down
24 changes: 13 additions & 11 deletions charts/rstudio-workbench/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Posit Workbench

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

#### _Official Helm chart for Posit Workbench_

Expand All @@ -24,11 +24,11 @@ To ensure a stable production deployment:

## Installing the chart

To install the chart with the release name `my-release` at version 0.11.0:
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-workbench --version=0.11.0
helm upgrade --install my-release rstudio/rstudio-workbench --version=0.20.0
```

To explore other chart versions, look at:
Expand Down Expand Up @@ -601,12 +601,12 @@ Use of [Sealed secrets](https://github.com/bitnami-labs/sealed-secrets) disables
| chronicleAgent.workbenchApiKey.value | string | `""` | Workbench API key as a raw string to set as the `CHRONICLE_WORKBENCH_APIKEY` environment variable (not recommended) |
| chronicleAgent.workbenchApiKey.valueFrom | object | `{}` | Workbench API key as a `valueFrom` reference (ex. a Kubernetes Secret reference) to set as the `CHRONICLE_WORKBENCH_APIKEY` environment variable (recommended) |
| command | list | `[]` | command is the pod container's run command. By default, it uses the container's default. However, the chart expects a container using `supervisord` for startup |
| components | object | `{"enabled":true,"positron":{"image":{"repository":"rstudio/workbench-positron-init","tag":""},"version":""},"sessionInit":{"image":{"repository":"rstudio/workbench-session-init","tag":""}}}` | Session component delivery via init containers. When enabled (default), the chart configures rserver.conf so the launcher injects init containers into session pods at startup. Set `enabled: false` and change `session.image.repository` to `rstudio/r-session-complete` to use the classic all-in-one session image instead. |
| components | object | `{"enabled":true,"positron":{"image":{"repository":"posit/workbench-positron-init","tag":""},"version":""},"sessionInit":{"image":{"repository":"posit/workbench-session-init","tag":""}}}` | Session component delivery via init containers. When enabled (default), the chart configures rserver.conf so the launcher injects init containers into session pods at startup. Set `enabled: false` and change `session.image.repository` to `rstudio/r-session-complete` to use the classic all-in-one session image instead. |
| components.enabled | bool | `true` | Enable session component delivery via init containers. When false, no init containers are configured and session.image must be a self-contained image like r-session-complete. |
| components.positron.image.repository | string | `"rstudio/workbench-positron-init"` | The image repository for the Positron init container |
| components.positron.image.repository | string | `"posit/workbench-positron-init"` | The image repository for the Positron init container |
| components.positron.image.tag | string | `""` | A tag override for the Positron init container image. Defaults to the positron version |
| components.positron.version | string | `""` | A Positron version to enable the Positron init container for session pods. When set, configures rserver.conf with the Positron init container settings and attaches a Positron init container to the Workbench server pod. |
| components.sessionInit.image.repository | string | `"rstudio/workbench-session-init"` | The repository for the session init container image |
| components.sessionInit.image.repository | string | `"posit/workbench-session-init"` | The repository for the session init container image |
| components.sessionInit.image.tag | string | `""` | A tag override for the session init container. Default tag is the chart appVersion (or versionOverride) |
| config.database | object | `{"conf":{"existingSecret":"","value":""}}` | a map of database connection config files. Mounted to `/mnt/secret-configmap/rstudio/database.conf` with 0600 permissions |
| config.database.conf.existingSecret | string | `""` | Secret for database connection config. Will take precedence over `config.database.conf.value`. Key: 'database.conf' |
Expand Down Expand Up @@ -651,9 +651,9 @@ Use of [Sealed secrets](https://github.com/bitnami-labs/sealed-secrets) disables
| homeStorage.volumeName | string | `""` | the volumeName passed along to the persistentVolumeClaim. Optional |
| 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 | `"rstudio/rstudio-workbench"` | 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/workbench"` | 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 selection: ubuntu2204-). Only used if tag is not defined |
| ingress.annotations | object | `{}` | |
| ingress.enabled | bool | `false` | |
| ingress.hosts | string | `nil` | |
Expand Down Expand Up @@ -735,9 +735,11 @@ Use of [Sealed secrets](https://github.com/bitnami-labs/sealed-secrets) disables
| session.defaultConfigMount | bool | `true` | Whether to automatically mount the config.session configuration into session pods. If launcher.namespace is different from Release Namespace, then the chart will duplicate the session configmap in both namespaces to facilitate this |
| session.defaultHomeMount | bool | `true` | Whether to automatically add the homeStorage PVC to the session (i.e. via the `launcher-mounts` file) |
| session.defaultSecretMountPath | string | `"/mnt/session-secret/"` | The path to mount the sessionSecret (from `config.sessionSecret`) onto the server and session pods |
| session.image.repository | string | `"rstudio/workbench-session"` | The repository to use for the session image |
| session.image.tag | string | `""` | A tag override for the session image. Overrides the "tagPrefix" above, if set. Default tag is `{{ tagPrefix }}{{ version }}` |
| session.image.tagPrefix | string | `"ubuntu2204-"` | A tag prefix for session images (common selections: ubuntu2204-). Only used if tag is not defined |
| session.image.os | string | `"ubuntu-24.04"` | The OS version for the session image tag (e.g. ubuntu-24.04, ubuntu-22.04). Only used if tag is not defined |
| session.image.pythonVersion | string | `"3.14.3"` | The Python version for the session image tag. Only used if tag is not defined |
| session.image.rVersion | string | `"4.5.2"` | The R version for the session image tag. Only used if tag is not defined |
| session.image.repository | string | `"posit/workbench-session"` | The repository to use for the session image |
| session.image.tag | string | `""` | A tag override for the session image. Overrides rVersion, pythonVersion, and os. Default tag is `R{{ rVersion }}-python{{ pythonVersion }}-{{ os }}` |
| shareProcessNamespace | bool | `false` | whether to provide `shareProcessNamespace` to the pod. |
| sharedStorage.accessModes | list | `["ReadWriteMany"]` | accessModes defined for the storage PVC (represented as YAML) |
| sharedStorage.annotations | object | `{"helm.sh/resource-policy":"keep"}` | Define the annotations for the Persistent Volume Claim resource |
Expand Down
2 changes: 1 addition & 1 deletion charts/rstudio-workbench/templates/_helpers.tpl
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ If release name contains chart name it will be used as a full name.
containers:
- name: rstudio
{{- $defaultVersion := .Values.versionOverride | default $.Chart.AppVersion }}
{{- $imageTag := .Values.image.tag | default (printf "%s%s" .Values.image.tagPrefix $defaultVersion )}}
{{- $imageTag := .Values.image.tag | default (printf "%s-%s" $defaultVersion .Values.image.os )}}
image: "{{ .Values.image.repository }}:{{ $imageTag }}"
{{- with .Values.pod.lifecycle }}
lifecycle:
Expand Down
22 changes: 13 additions & 9 deletions charts/rstudio-workbench/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -21,11 +21,15 @@ session:
# -- The path to mount the sessionSecret (from `config.sessionSecret`) onto the server and session pods
defaultSecretMountPath: /mnt/session-secret/
image:
# -- A tag prefix for session images (common selections: ubuntu2204-). Only used if tag is not defined
tagPrefix: ubuntu2204-
# -- The OS version for the session image tag (e.g. ubuntu-24.04, ubuntu-22.04). Only used if tag is not defined
os: "ubuntu-24.04"
# -- The R version for the session image tag. Only used if tag is not defined
rVersion: "4.5.2"
# -- The Python version for the session image tag. Only used if tag is not defined
pythonVersion: "3.14.3"
# -- The repository to use for the session image
repository: "rstudio/workbench-session"
# -- A tag override for the session image. Overrides the "tagPrefix" above, if set. Default tag is `{{ tagPrefix }}{{ version }}`
repository: "posit/workbench-session"
# -- A tag override for the session image. Overrides rVersion, pythonVersion, and os. Default tag is `R{{ rVersion }}-python{{ pythonVersion }}-{{ os }}`
tag: ""

# -- Session component delivery via init containers. When enabled (default), the chart
Expand All @@ -39,7 +43,7 @@ components:
sessionInit:
image:
# -- The repository for the session init container image
repository: "rstudio/workbench-session-init"
repository: "posit/workbench-session-init"
# -- A tag override for the session init container. Default tag is the chart appVersion (or versionOverride)
tag: ""
positron:
Expand All @@ -49,7 +53,7 @@ components:
version: ""
image:
# -- The image repository for the Positron init container
repository: "rstudio/workbench-positron-init"
repository: "posit/workbench-positron-init"
# -- A tag override for the Positron init container image. Defaults to the positron version
tag: ""

Expand Down Expand Up @@ -218,9 +222,9 @@ homeStorage:

image:
# -- the repository to use for the main pod image
repository: rstudio/rstudio-workbench
# -- A tag prefix for the server image (common selection: ubuntu2204-). Only used if tag is not defined
tagPrefix: ubuntu2204-
repository: posit/workbench
# -- The OS version for the image tag (e.g. ubuntu-24.04, ubuntu-22.04). Only used if tag is not defined
os: "ubuntu-24.04"
# -- Overrides the image tag whose default is the chart appVersion.
tag: ""
# -- the imagePullPolicy for the main pod image
Expand Down
Loading