Skip to main content
Version: 1.22

Release notes

1.22.1​

19 July 2024

This version is compatible with Kubernetes versions 1.26 to 1.29

Improvements​

  • Updated the backend CLI to 2.29.2 to address potential vulnerabilities
  • Improved the backend and installer images to enhance overall security
  • Bumped Buildkit image to v0.12.5-okteto3 to fix critical vulnerabilities

1.22.0​

8 July 2024

This version is compatible with Kubernetes versions 1.26 to 1.29

Breaking Changes​

  • Disabled private registries by default in nodes. Pull secrets, enabled by default since 1.20, are used for deploying pods with private images
  • Removed the automatic binding between cluster-admin cluster role, and every service account created within a namespace managed by Okteto. You can find more information in our Upgrade Guide here.

New Features​

  • Support of AWS IAM Roles to configure Private Registries. Please see the specific documentation page to understand their configuration
  • Add OIDC endpoint to the cluster overview panel in the Admin Dashboard
  • Okteto CLI: Make Preview Environments global by default and allow non-admin users to create them

Improvements​

  • Admin users are now able to perform any operation on any user's namespace via UI, CLI or at the Kubernetes level
  • Added configuration for developer permissions in global preview environments via role binding to the cluster role set by serviceAccounts.roleBindings.previews Helm setting
  • Developers now have read access to global preview environments at the Kubernetes level (after getting Kubernetes context with okteto kubeconfig)
  • Changed Admin Users' role selection label from "User" to "Developer" for consistency
  • Improved Okteto Insights data collection time
  • Reorganized 'user' helm setting to 'serviceAccounts' and include one setting to create a role binding for global previews. Please see our upgrade guide for details on how to adopt the changes
  • Specified the credentials to be removed in the delete credential confirmation dialog
  • Upgraded the Okteto CLI version to 2.29.0
  • Okteto CLI: Admins can now perform operations in any user's namespaces via the CLI context
  • Okteto CLI: Test artifacts defined under the test section are exported even if tests execution fails
  • Okteto CLI: Images defined in your Okteto manifest targeting dev registry (okteto.dev) and using a custom tag will now benefit from Okteto Smart Builds

Bug Fixes​

  • Fixed a rare issue where the Okteto Dashboard would render nothing during loading
  • Fixed an issue in the webhook that was preventing a Virtual Service to keep the specified exportTo field
  • Fixed empty space in the Okteto Dashboard while data is being re-fetched
  • Use globals.nodeSelectors.dev to filter Insights node data
  • Extend support for globals.nodeSelector in the Autoscaler, node readiness and the nodes admin view
  • Fixed panic in private-endpoints handler when deployed standalone and accessed for the first time

1.21.2​

19 July 2024

This version is compatible with Kubernetes versions 1.26 to 1.29

Improvements​

  • Updated the backend CLI to 2.29.2 to address potential vulnerabilities
  • Improved the backend and installer images to enhance overall security
  • Bumped Buildkit image to v0.12.5-okteto3 to fix critical vulnerabilities

1.21.1​

11 June 2024

This version is compatible with Kubernetes versions 1.26 to 1.29

Deprecation Notice​

Bug Fixes​

  • When Istio Virtual Services were enabled, Okteto's webhook no longer removes the property exportTo defined in a virtual service object
  • Fix a view refresh every few minutes in the General tab of the Admin Dashboard

1.21.0​

7 June 2024

This version is compatible with Kubernetes versions 1.26 to 1.29

Deprecation Notice​

New Features​

  • The platform will now only obfuscate variables that are longer than 5 characters
  • We've added the ability to set custom NodeSelectors

Improvements​

  • Show GitHub installations error notifications only when opening GitHub tab on Deploy dialog
  • Handle suspended GitHub installation error on the branch selector in the Okteto UI
  • Enable more error variant feedback on the GitHub BranchSelector in the Okteto UI
  • Handle suspended Github app installation on the repositories selector in the Okteto UI
  • Removed ingress name validation in the mutation webhook for ingress created as part of cert-manager challenges
  • Handle HTTP 5xx errors more gracefully in the Okteto UI
  • Upgraded the Okteto CLI version to 2.28.0.
  • Okteto CLI: Changed .oktetodeployignore files to use .oktetoignore for remote executions of deploy and destroy, which allows more granularity to ignore files. You can add global ignore, but also specific ignores per operation
  • Okteto CLI: Fix to correctly discover the git repository when a manifest is within a subfolder of the repository. This was preventing Smart Builds from detecting when an image was previously built

Bug Fixes​

  • Fix branch selector regression causing "bad-request" error
  • Ignore ingress, virtual services, and routes without hosts
  • Fix installer destroy operation when checking branch existence for private registries using SSH protocol

1.20.1​

28 May 2024

This version is compatible with Kubernetes versions 1.26 to 1.29

Bug Fixes​

  • Updated the backend CLI to version 2.27.3 to resolve a panic issue that occurred when using Docker Compose with Okteto Manifests, specifically when the image field in a compose service referred to an environment variable

1.20.0​

21 May 2024

This version is compatible with Kubernetes versions 1.26 to 1.29

Deprecation Notice​

New Features​

Improvements​

  • Namespaces without an owner will now be picked up by the Garbage Collector
  • Removed ingress TLS validation to allow more flexibility in deploying your own ingress objects
  • Renamed Variables to "Admin Variables" in the Admin section for clarity
  • Included license issue warning badges on Admin and sidebar menu items
  • Made error handling and feedback messages more consistent and actionable throughout the UI
  • In the UI, we renamed all /cluster/* routes to /admin/*
  • Updated CLI version in the backend to 2.27.2
  • Okteto CLI: Changed the heuristic to mask variables in logs and comments that are longer that 5 characters
  • Okteto CLI: Added support for variables expansion on manifest.build.dockerfile
  • Okteto CLI: Added support for variable expansion in variables defined in .env - for example "VAR1=${VAR2:-default}"

Bug Fixes​

  • Fixed branch selector behavior in UI when Github fails to fetch branches
  • Fixed a GitHub integration issue where the dialog state wasn't updated after reconfiguring access through the popup for suspended installations
  • Fixed an issue where personal tokens set to never expire were changed to a 180-day expiration by the next migration job
  • Trial licenses are now recognized in the onboarding checklist

Removal Notice​

  • Support for Kubernetes 1.25 has been removed in this release.

1.19.4​

28 May 2024

This version is compatible with Kubernetes versions 1.25 to 1.29

Bug Fixes​

  • Updated the backend CLI to version 2.26.2 to resolve a panic issue that occurred when using Docker Compose with Okteto Manifests, specifically when the image field in a compose service referred to an environment variable

1.19.3​

15 May 2024

This version is compatible with Kubernetes versions 1.25 to 1.29

Deprecation Notice​

  • Support for Kubernetes 1.25 has been deprecated and will be removed in the next release.

Bug Fixes​

  • Fix pulling images from the okteto registry after sharing a namespace when pull secrets is enabled.

1.19.2​

10 May 2024

This version is compatible with Kubernetes versions 1.25 to 1.29

Deprecation Notice​

  • Support for Kubernetes 1.25 has been deprecated and will be removed in the next release.

Bug Fixes​

  • Fix pulling images from ECR private registries in dev namespaces when pull secrets is enabled.

1.19.1​

26 April 2024

This version is compatible with Kubernetes versions 1.25 to 1.29

Deprecation Notice​

  • Support for Kubernetes 1.25 has been deprecated and will be removed in the next release.

Improvements​

  • Okteto CLI: the scope of the breaking change introduced in 1.19.0 has been reduced. okteto deploy will ignore host volumes of Docker Compose services only if the service defines a build section. Please see our community post for more details

Bug Fixes​

  • Resolved a bug with migrations occurring during every Okteto upgrade. Tokens that were set to never expire were inadvertently being modified to expire in 180 days. This fix ensures that token expiration times are not altered during Okteto upgrades

1.19.0​

16 April 2024

This version is compatible with Kubernetes versions 1.25 to 1.29

Deprecation Notice​

  • Support for Kubernetes 1.25 has been deprecated and will be removed in the next release.

New Features​

  • Okteto Insights: Pod v2, Build, Deploy, User, Namespace, and Preview metrics are now available
  • Smart Builds now uses build: context instead of project: commit to detect if an image was already built
  • Add Grafana to Admin UI to support Okteto Insights for SaaS plan users

Breaking Changes​

Improvements​

  • Update buildkit to v0.12.5
  • maxNamespaces quota doesn't apply to the okteto-bot user
  • Introduced the OKTETO_IS_PREVIEW_ENVIRONMENT variable to identify when a deployment is happening in a preview environment
  • Hide passwords when creating new private registry credentials
  • Add CLI environment variable to enable or disable local Docker credentials when building images. This setting defaults to true
  • Support for the compose.yml and compose.yaml file extensions

Bug Fixes​

  • Okteto CLI: Add CORS PNA to support browser logins from the Okteto CLI
  • Fix endpoint links in the UI that span the full width of container and break layout
  • OKTETO_COMPOSE_VOLUME_AFFINITY_ENABLED feature flag variable to disable the "force node" behavior when pods share the same PVC
  • Allow okteto-bot to use GitHub integration when deploying repositories
  • Fix a wrong redirect when a preview doesn't exist
  • Make docker config static a pull secret
  • Translate compose annotations into Kubernetes labels. We had been translating compose labels into k8s annotations but not viceversa

1.18.2​

20 March 2024

This version is compatible with Kubernetes versions 1.25 to 1.28.

Bug Fixes​

  • Dev environments and preview environments deployed from private repositories using Admin Access Tokens were not able to clone the repository even when the GitHub App had access to it.

1.18.1​

12 March 2024

This version is compatible with Kubernetes versions 1.25 to 1.28.

Features​

  • Support a feature flag to disable the logic that forces pods with a shared volume to be scheduled on the same node (unsupported.forceNodeToPodsWithSamePVCs: false).

1.18.0​

27 February 2024

This version is compatible with Kubernetes versions 1.25 to 1.28.

Features​

Improvements​

Bug Fixes​

  • Hide clear button if namespace search input is empty
  • In deploy dialog, fix wrong filter when canceling current repository on SelectRepository
  • Fix filtered namespace view where parent resources were not expanded
  • Fix closing create access token dialog from keyboard
  • Fix Scale to Zero Period showing wrong value in Previews UI
  • Fix wrong "Waking Up" status when switching to a "Sleeping" namespace
  • Properly render code nodes as inline elements inside a list item
  • Fix BuildKit configuration behind our ingress-controller not working when BuildKit had more than 1 replica

1.17.0​

23 January 2024

This version is compatible with Kubernetes versions 1.25 to 1.28.

Features​

Improvements​

  • Hoist Personal Access Tokens menu from Setup to Settings
  • Rename Launch to Deploy in the Okteto UI
  • Rename Secrets to Variables under both Settings and Admin sections. This rename is for consistency in the UI and delivers no change in functionality
  • Support for multi-line secrets
  • Improve buildkit cache reloading on helm upgrades. Please note this upgrade will imply a restart in the build cache

Bug Fixes​

  • Surface buildkit errors through our ingress controller. Will result in better build error messages
  • The Okteto Insights endpoint was not exposing build metrics when the Helm release name included the word "okteto"
  • Fixed a scenario where the runtime of node containers could restart if the Okteto daemon pod were to be recreated, potentially impacting active 'okteto up' sessions

1.16.2​

17 January 2024

This version is compatible with Kubernetes versions 1.25 to 1.28.

Bugfixes​

  • Fixed a scenario where node container runtimes could restart if the Okteto daemon pod were to be recreated, potentially impacting active 'okteto up' sessions.

1.16.1​

10 January 2024

This version is compatible with Kubernetes versions 1.25 to 1.28.

Bugfixes​

  • The Okteto CLI used for Pipeline installation has been upgraded to version 2.23.3. It includes a fix for scenarios where image builds were failing because an image was not being found in the global registry.
  • The Okteto Insights endpoint was not exposing build metrics when the Helm release name included the word "okteto"

1.16.0​

20 December 2023

This version is compatible with Kubernetes versions 1.25 to 1.28.

Features​

  • Add okteto_usage_build_duration_seconds build metrics to okteto insights. More info here
  • A diagnostics tool is now provided to help troubleshoot installations. More info here
  • The Okteto CLI used for Pipeline installation has been upgraded to version 2.23.1
  • Move garbage collection of okteto up based on last synced file behind a feature flag. More info here
  • Okteto now runs in ARM architecture. This is currently in beta.

Improvements​

  • Okteto garbage collector cronjob now resolves buildkit and ingress hosts to their internal IPs
  • Registry Credentials cronjob only update dockerconfig secret if the credentials change.
  • Okteto Daemon now update kubelet docker config.json file in nodes reactively when the static docker config secret changes. Bumps okteto/daemon to 0.5.1
  • Fix network policies configuration to limit buildkit access to the nginx controller
  • Add Okteto Insights Token to the Admin UI
  • Updated documentation structure to make content easier to navigate and find. Release notes can now be found at https://www.okteto.com/docs/release-notes, and chart values reference can be found at https://www.okteto.com/docs/reference/helm-chart-values/. All documentation changes are listed here.

1.15.1​

1 December 2023

This version is compatible with Kubernetes versions 1.25 to 1.27.

Bugfixes​

  • Fix okteto daemon restart when AWS ECR private registry credentials are defined

1.15.0​

22 November 2023

This version is compatible with Kubernetes versions 1.25 to 1.27.

Removal Notice​

Kubernetes 1.24 is no longer supported

Improvements​

  • Upgrade ingress-nginx to 1.9.4 (Helm chart version 4.8.3)
  • Enabled chroot mode by default in both ingress-nginx controllers managed by Okteto.
  • okteto up sessions are now garbage collected if no files have been synced for an hour

Bug Fixes​

  • Fallback to default branch for destroy installer jobs
  • Smart builds work on repositories using .gitmodules containing submodules cloned via ssh key
  • Fix wrong "Scale to Zero Period" value in the UI of Admin → Namespaces

Features​

  • The Okteto CLI used for Pipeline installation has been upgraded to version 2.22.3

1.14.3​

1 December 2023

This version is compatible with Kubernetes versions 1.25 to 1.27.

Bugfixes​

  • Fix okteto daemon restart when AWS ECR private registry credentials are defined

1.14.2​

8 November 2023

This version is compatible with Kubernetes versions 1.24 to 1.27.

Bugfixes​

  • Fix private registry credentials integration for registries with custom ports (other that the default 443)

1.14.1​

27 October 2023

This version is compatible with Kubernetes versions 1.24 to 1.27.

Improvements​

  • Okteto internal registry is now resolved in private credentials exchange

Bugfixes​

  • Namespace list in the UI is now scrollable and displays all namespaces.
  • Fix login with openid through the okteto CLI with custom "audience" and "resource"

1.14.0​

25 October 2023

This version is compatible with Kubernetes versions 1.24 to 1.27.

Deprecation Notice​

Features​

  • Added a new /metrics endpoint to expose prometheus node metrics data. More info here.
  • Added native support for Private Registry Credentials, configurable directly in the Okteto UI. More info here.
  • The Okteto CLI used for Pipeline installation has been upgraded to version 2.21.0
  • Add support for Kubernetes 1.27

Improvements​

  • Upgrade ingress-nginx to 1.8.2 (Helm chart version 4.7.2)

Bugfixes​

  • Reduce file permission for okteto-ca-pemstore certificate file in jobs
  • Reduce expiration threshold for trial licenses from 60 to 7 days

1.13.0​

27 September 2023

This version is compatible with Kubernetes versions 1.24 to 1.26.

Breaking Changes​

Okteto requires you to use a valid license as part of the installation. If you were running a previous version of Okteto and you don't have a valid license, signup for our 30 day free trial or reach out to us.

Improvements​

  • Updates to Cloud Secret now take immediate effect
  • The Okteto CLI used for Pipeline installation has been upgraded to version 2.20.0
  • Pipeline installations now use dynamic kubernetes tokens to talk to the kubernetes api via the ClientAuthentication API.

Bugfixes​

  • Documentation now links the exact version version in the docs
  • During installation/upgrade the current version of Okteto is no longer tied to Helm .Chart.Version and .Chart.AppVersion
  • Improve platform and kubernetes version attributes resolution in Telemetry cronjob

1.12.1​

14 September 2023

This version is compatible with Kubernetes versions 1.24 to 1.26.

Bugfixes​

1.12.0​

31 August 2023

This version is compatible with Kubernetes versions 1.24 to 1.26.

Breaking changes​

  • Kubeconfigs downloaded from the Okteto web UI now require Okteto CLI 2.15 or higher to use dynamic tokens for authenticating against Kubernetes.

Features​

  • The Okteto CLI has been upgraded to version 2.19.2.
  • The Admin view has been redesigned with a new vertical tab column.
  • Added "Registry Credentials" to the Admin view to display configured private registry information. This provides visibility into the private registries in use for your Okteto instance (username/password and AWS Access/Secret only for now)

Improvements​

  • The Preview list in the Admin view now shows time units in the Garbage Collector settings description.
  • When waking a Namespace from the Namespace, Preview, or Admin views, the UI now provides feedback for the request.
  • When a GitHub user does not belong to the allowed GitHub organization and attempts to log in, a specific error is now shown.
  • When using a GitHub App for authentication that is not yet installed in the GitHub organization and an allowed GitHub organization filter is set, a specific error is now shown.
  • Resources for Nodes in the Admin view are now correctly aligned.
  • Priority Classes can now be specified via priorityClassName sub-property for the following components: api, buildkit, defaultBackend, frontend, registry and webhook.

1.11.1​

8 August 2023

Bugfixes​

  • When deploying compose files, Okteto built-in environment variables (e.g OKTETO_BUILD_XXX) were not expanded correctly.

1.11.0​

2 August 2023

Improvements​

  • Upgraded buildkit to v0.11.6.
  • Upgraded ingress-nginx to 4.7.1.
  • Underlying Kubernetes cluster version is now shown in the Admin section.
  • When a GitHub App private key is not valid, a warning message is now shown in a components' logs and when attempting to authenticate or perform a GitHub-related action.
  • Okteto Web UI documentation links now point to the same version used by the platform instead of the latest version.
  • Automatic role binding for service accounts can now be disabled.
  • Added configuration setting in the daemonset to disable the configuration of private registry credentials in the nodes

Bugfixes​

  • When hovering over logs in the Okteto Web UI, a wrong timestamp was shown.
  • Istio's Virtual Service now show only their own dedicated endpoints when using "dev.okteto.com/endpoints" annotation.