diff --git a/Justfile b/Justfile index 434a6652..8991dc34 100644 --- a/Justfile +++ b/Justfile @@ -94,7 +94,7 @@ test-connect-interpreter-versions: # find the default image image=$( helm template ./charts/rstudio-connect \ - --set launcher.enabled=false \ + --set backends.kubernetes.enabled=false \ --show-only templates/deployment.yaml | \ grep "image\:.*rstudio-connect.*" | \ awk -F": " '{print $2}' | \ @@ -103,12 +103,12 @@ test-connect-interpreter-versions: for lang in "Python" "Quarto" "R" do echo "Testing $lang" - + # print the default connect config file for local execution in ini format # print the section and grep for the Executables to find each interpreter executables=$( helm template ./charts/rstudio-connect \ - --set launcher.enabled=false \ + --set backends.kubernetes.enabled=false \ --show-only templates/configmap.yaml | \ sed -n -e "/\[$lang\]/,/\[*\]/ p" | \ grep Executable | awk -F= '{print $2}' | \ diff --git a/charts/rstudio-connect/Chart.yaml b/charts/rstudio-connect/Chart.yaml index f1730cbe..0ddac157 100644 --- a/charts/rstudio-connect/Chart.yaml +++ b/charts/rstudio-connect/Chart.yaml @@ -1,6 +1,6 @@ name: rstudio-connect description: Official Helm chart for Posit Connect -version: 0.9.5 +version: 0.10.0 apiVersion: v2 appVersion: 2026.04.1 icon: https://raw.githubusercontent.com/rstudio/helm/main/images/posit-icon-fullcolor.svg diff --git a/charts/rstudio-connect/NEWS.md b/charts/rstudio-connect/NEWS.md index 9db3699f..1d257ce6 100644 --- a/charts/rstudio-connect/NEWS.md +++ b/charts/rstudio-connect/NEWS.md @@ -1,5 +1,13 @@ # Changelog +## 0.10.0 + +- BREAKING: `backends.kubernetes.enabled` now defaults to `true` and `launcher.enabled` now defaults to `false`. + - New installations use the new implementation for Off-Host Execution by default. + - For existing installations, see the [upgrade guide](https://docs.posit.co/helm/examples/connect/upgrade-launcher-to-kubernetes/launcher-to-kubernetes.html) for details on transitioning to the new implementation. + - To continue using the Launcher implementation, set `launcher.enabled: true` and `backends.kubernetes.enabled: false` in your values.yaml. + - **IMPORTANT** When `backends.kubernetes.enabled=true`, service accounts used for content execution require the `connect.posit.co/service-account` label. + ## 0.9.5 - Bump Connect version to 2026.04.1 diff --git a/charts/rstudio-connect/README.md b/charts/rstudio-connect/README.md index 524951b7..b2de48dc 100644 --- a/charts/rstudio-connect/README.md +++ b/charts/rstudio-connect/README.md @@ -1,6 +1,6 @@ # Posit Connect -![Version: 0.9.5](https://img.shields.io/badge/Version-0.9.5-informational?style=flat-square) ![AppVersion: 2026.04.1](https://img.shields.io/badge/AppVersion-2026.04.1-informational?style=flat-square) +![Version: 0.10.0](https://img.shields.io/badge/Version-0.10.0-informational?style=flat-square) ![AppVersion: 2026.04.1](https://img.shields.io/badge/AppVersion-2026.04.1-informational?style=flat-square) #### _Official Helm chart for Posit Connect_ @@ -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.5: +To install the chart with the release name `my-release` at version 0.10.0: ```{.bash} helm repo add rstudio https://helm.rstudio.com -helm upgrade --install my-release rstudio/rstudio-connect --version=0.9.5 +helm upgrade --install my-release rstudio/rstudio-connect --version=0.10.0 ``` To explore other chart versions, look at: @@ -45,6 +45,13 @@ helm search repo rstudio/rstudio-connect -l ## Upgrade guidance +### 0.10.0 + +- Chart version 0.10.0 changes the default execution backend to use a new Off-Host Execution implementation: `backends.kubernetes.enabled` now defaults to `true` and `launcher.enabled` now defaults to `false`. +New installations use the new implementation by default. To continue using the Launcher, set `launcher.enabled: true` and `backends.kubernetes.enabled: false` in your values.yaml. +See the [upgrade guide](https://docs.posit.co/helm/examples/connect/upgrade-launcher-to-kubernetes/launcher-to-kubernetes.html) for details on transitioning to the new implementation. + - **IMPORTANT** When `backends.kubernetes.enabled=true`, service accounts used for content execution require the `connect.posit.co/service-account` label. + ### 0.9.0 - Chart version 0.9.0 adds support for the direct Kubernetes runner via `backends.kubernetes.enabled`. See the [upgrade guide](https://docs.posit.co/helm/examples/connect/upgrade-launcher-to-kubernetes/launcher-to-kubernetes.html) for details on transitioning from `launcher.enabled`. @@ -275,7 +282,7 @@ The Helm `config` values are converted into the `rstudio-connect.gcfg` service c | backends.kubernetes.defaultInitContainer.tagPrefix | string | `"ubuntu2204-"` | A tag prefix for the Content InitContainer image (common selections: jammy-, ubuntu2204-). Only used if tag is not defined | | backends.kubernetes.defaultResourceJobBase | object | `{}` | defaultResourceJobBase is an optional Kubernetes Job definition used as the base when launching content jobs. The chart automatically adds the init container and runtime volume when backends.kubernetes.defaultInitContainer.enabled is true. Only set this if you need to customize the job (e.g., add sidecars, node selectors, tolerations). https://kubernetes.io/docs/concepts/workloads/controllers/job/ | | backends.kubernetes.defaultResourceServiceBase | object | `{}` | defaultResourceServiceBase contains the Kubernetes Service definition which is used as an overlay "base" when creating a content job's Service in Kubernetes. Conceptually this is similar to a Kustomize base. Connect then applies any required Service configuration on-top of the overlay base to produce a final Service definition. https://kubernetes.io/docs/concepts/services-networking/service/ https://kubernetes.io/docs/tasks/manage-kubernetes-objects/kustomization/#bases-and-overlays | -| backends.kubernetes.enabled | bool | `false` | Whether to enable off-host execution for running content-jobs in remote Kubernetes pods. | +| backends.kubernetes.enabled | bool | `true` | Whether to enable off-host execution for running content-jobs in remote Kubernetes pods. | | backends.kubernetes.namespace | string | `""` | The namespace to launch connect-content jobs into. Uses the Release namespace by default | | chronicleAgent.agentEnvironment | string | `""` | An environment tag to apply to all metrics reported by this agent ([reference](https://docs.posit.co/chronicle/appendix/library/advanced-agent.html#environment)) | | chronicleAgent.autoDiscovery | bool | `true` | If true, the chart will attempt to lookup the Chronicle Server address and version in the cluster | @@ -322,7 +329,7 @@ The Helm `config` values are converted into the `rstudio-connect.gcfg` service c | 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.enabled | bool | `false` | 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 | | launcher.includeTemplateValues | bool | `true` | whether to include the templateValues rendering process | diff --git a/charts/rstudio-connect/README.md.gotmpl b/charts/rstudio-connect/README.md.gotmpl index bb511abd..57a502ef 100644 --- a/charts/rstudio-connect/README.md.gotmpl +++ b/charts/rstudio-connect/README.md.gotmpl @@ -10,6 +10,13 @@ ## Upgrade guidance +### 0.10.0 + +- Chart version 0.10.0 changes the default execution backend to use a new Off-Host Execution implementation: `backends.kubernetes.enabled` now defaults to `true` and `launcher.enabled` now defaults to `false`. +New installations use the new implementation by default. To continue using the Launcher, set `launcher.enabled: true` and `backends.kubernetes.enabled: false` in your values.yaml. +See the [upgrade guide](https://docs.posit.co/helm/examples/connect/upgrade-launcher-to-kubernetes/launcher-to-kubernetes.html) for details on transitioning to the new implementation. + - **IMPORTANT** When `backends.kubernetes.enabled=true`, service accounts used for content execution require the `connect.posit.co/service-account` label. + ### 0.9.0 - Chart version 0.9.0 adds support for the direct Kubernetes runner via `backends.kubernetes.enabled`. See the [upgrade guide](https://docs.posit.co/helm/examples/connect/upgrade-launcher-to-kubernetes/launcher-to-kubernetes.html) for details on transitioning from `launcher.enabled`. diff --git a/charts/rstudio-connect/values.yaml b/charts/rstudio-connect/values.yaml index a1c67fa9..c579ff8d 100644 --- a/charts/rstudio-connect/values.yaml +++ b/charts/rstudio-connect/values.yaml @@ -306,7 +306,7 @@ chronicleAgent: backends: kubernetes: # -- Whether to enable off-host execution for running content-jobs in remote Kubernetes pods. - enabled: false + enabled: true # -- The namespace to launch connect-content jobs into. Uses the Release namespace by default namespace: "" defaultInitContainer: @@ -347,7 +347,7 @@ backends: launcher: # -- Whether to enable the launcher - enabled: true + enabled: false # -- The namespace to launch sessions into. Uses the Release namespace by default namespace: "" # -- Deprecated, use `executionEnvironments` instead. Optional. The runtime.yaml definition of Kubernetes runtime containers.