Release notes
1.26.1
12 November 2024
This version is compatible with Kubernetes versions 1.27 to 1.30
Bug Fixes
- Fixed the calculation of the total requested CPU/memory in Resource Manager Admin View by excluding completed pods.
- Fixed an issue when Resource Manager was enabled in Manual mode and
quotas.limitranges.requests.limitRequestRatio
was also set.
1.26.0
9 November 2024
This version is compatible with Kubernetes versions 1.27 to 1.30
Breaking Changes
- Hostname Length Limit: Deploys now fail if a service hostname exceeds 63 characters, showing an error message. Previously, the dev environment deployed successfully even if the endpoint didn’t work. This may affect environments that deployed without issues before
- Helm Release Name Limit: Helm release names are now limited in length. Use
defaultBackend.nameOverride
to shorten the default backend service name if needed. If changing this during an upgrade, follow this guide as it may impact the installation - Private Repository Deploys: Deploying private repositories now uses the Okteto backend as the SSH agent, rather than mounting the local SSH agent. This change ensures feature parity between remote and local deploys but may impact scenarios where private repositories are cloned as part of commands defined in the deploy section during remote execution
- Buildkit Persistence Enabled: Buildkit persistence is now enabled by default, with a 100Gi disk and cache set to 90% of the disk size. If you previously used
buildkit.persistence.cache
, adjust to the new ratio, as this setting is no longer applicable
New Features
- Introducing the Okteto Resource Manager: a new feature that automatically optimizes CPU and memory requests for your environments. By analyzing real-time resource utilization, the Resource Manager dynamically adjusts resource requests to ensure efficient usage, prevent node overload, and improve overall cluster performance. This feature simplifies resource management, reduces manual adjustments, and enhances application stability, especially in larger clusters. The default installation provides recommendations but doesn't apply them automatically. See our docs for details on how to apply these automatically
- Added Okteto Garbage Collector settings to the Admin Dashboard: Admins can now manage sleep and delete periods from the Dashboard, with the ability to set different configurations for Namespaces and Preview Environments
- Remote Execution can now be set as the default in the Okteto Admin Dashboard, allowing admins to enforce consistent remote deploys. Remote deploys also include improvements for feature parity with local deploys, such as the ability to specify the context synchronization folder and private Git repository cloning during deploy commands using SSH keys
- Added additional feature and documentation for running Buildkit at scale
Improvements
- Okteto will now automatically create a Docker secret if one doesn't already exist in the Controller Manager. This prevents a misleading warning that was being displayed in some scenarios when deploying from the UI
- Buildkit cache size is now automatically configured based on its PVC volume size
- Removed Buildkit persistency as an installation step now that it defaults to true
- The Okteto frontend now runs rootless by default, while Buildkit operates without privileges when rootless mode is enabled
- We've released Okteto CLI 3.1.0 with many new improvements
- Okteto CLI 3.1.0: Added support for a
context
field in the Okteto Manifest, allowing you to specify the working directory for commands in thedeploy
anddestroy
sections - Okteto CLI 3.1.0: Added automatic retry for build operations when BuildKit is unavailable due to transient errors. The behavior can be controlled using the environment variables
OKTETO_BUILDKIT_MAX_RETRIES_FOR_TRANSIENT_ERRORS
,OKTETO_BUILDKIT_WAIT_TIMEOUT
, andOKTETO_BUILDKIT_RETRY_INTERVAL
.
Bug Fixes
- Fixed an issue that was preventing Development Environments to be destroyed when the specified manifest doesn't exist
- Fixed a patch operation in the Okteto Insights cronjob that was causing the loss of node labels when there were concurrent operations from external processes
- Resolved an issue where build logs were not displayed in the UI when deploying dev or preview environments, causing the UI to appear frozen. Build logs now display correctly during deployments
1.25.0
7 October 2024
This version is compatible with Kubernetes versions 1.27 to 1.30
New Features
- Announcing Okteto CLI 3.0 - upgrading to chart release 1.25 requires a CLI upgrade to 3.0
- Announcing Cloud Credentials, a central location to manage your cloud provider credentials for
deploy
,destroy
, andtest
remote operations - Added official support for Red Hat OpenShift
- Added support and a new Namespace UI for resource quotas at the individual Namespace level. This allows administrators to set the maximum resources that can be used per Namespace
- Enabling Okteto Insights Dashboards for all SaaS and BYOC users of Okteto
- Added support to allow override of installer security context
Improvements
- Support for
priorityClassName
andaccessMode
for volumes created byokteto up
- Show more actionable feedback upon "failed to deploy okteto pipeline" error
- You can now list your Github App installations under Settings → Integrations
- Implemented a number of UI updates to ensure your Okteto experience stays smooth
- Made a number of improvements to the Okteto Insights Dashboards to display historical build and deploy data, and provide a better experience loading large datasets
Bug Fixes
- Okteto CLI 3.0: Fix in Smart Builds logic to properly calculate when to build a new image if the build context points to a parent folder
- Fixed wrong data parsing error from unknown git urls
- Fixed issue where interactive but hidden elements, such as links in closed deploy log stage, were wrongly accessible via keyboard navigation and screen readers
- Fixed issue preventing password managers from filling in the login token
- Reconfigured GitHub installation to error when trying to be installed by a non-admin
- Fixed external resources not being selectable on Preview Environments
- Fixed sleep namespaces job when statefulset within it is in dev mode
- Fix for Buildkit PVC cleanups in the "okteto" Namespace
- Fix keyboard navigation on Admin → Users actions dropdown menu
- Removed support for "Volumes" on the Admin Nodes view and Autoscaler
1.24.2
9 September 2024
This version is compatible with Kubernetes versions 1.27 to 1.30
Bug Fixes
- Fix high vulnerabilities in backend and pipeline installer images
1.24.1
9 September 2024
This version is compatible with Kubernetes versions 1.27 to 1.30
Bug Fixes
- Fix deploy of development environments from the UI when the git URL is from a self-hosted GitLab instance and it refers to repositories within Groups and Subgroups
1.24.0
9 September 2024
This version is compatible with Kubernetes versions 1.27 to 1.30
New Features
- Announcing the pre-release of CLI 3.0! Please read our blog post for more details and information on breaking changes
- Enable multi-user token authentication
- Added support for BuildKit Bridge Mode to avoid port collisions on parallel builds
Improvements
- Added new Developer Quickstart Guide to the documentation
- Upgraded ingress-nginx to v1.11.2 adding support for gRPC timeout settings via annotations. This update may introduce a breaking change related to an uncommon edge case
- Updated the "Want to know more" links in an empty namespace
- Added tolerations for EventsExporter StatefulSet
- Updated pipeline-runner image to v1.0.5 to update cue to 0.9.2
- Okteto CLI 2.31.0 Upgrade Notice: To upgrade to new ECDSA keys, all active development containers will be recreated on the first okteto up after upgrading to 2.31.0
- Okteto CLI 2.31.0: Replaced RSA with ECDSA for SSH keys. This allows the use of debuggers on Visual Studio with Development Containers
- Okteto CLI 2.31.0: Prevent Syncthing from restarting and activating relay if the Synching configuration is lost
Bug Fixes
- Trimmed .git suffix when extracting repository data
- Fixed Development Environment UI collapse when a nested item is deleted
- Added OKTETO_TOKEN as a reserved variable name in the UI
- Fixed git url parsing for URLs with a trailing slash
- Fixed an overflow issue with long variable values
- Private endpoint cookies now delete upon logout
- Fixed duplicated endpoints in the UI if they're shared by more than one resource
- Fixed GitHub integration configuration issue in Settings view
Removal Notice
- Support for Kubernetes 1.26 has been removed in this release.
1.23.2
16 August 2024
This version is compatible with Kubernetes versions 1.26 to 1.30
Bug Fixes
- Fix deploys for repositories with a trailing slash
1.23.1
14 August 2024
This version is compatible with Kubernetes versions 1.26 to 1.30
Bug Fixes
- Updated the backend CLI to 2.30.1 to fix an error when deploying remotely an Okteto Manifest storing a variable with the symbol
=
on $OKTETO_ENV
1.23.0
12 August 2024
This version is compatible with Kubernetes versions 1.26 to 1.30
Deprecation Notice
- Support for Kubernetes 1.26 has been deprecated and will be removed in the next release.
New Features
- Added a feature flag to enable/disable autowake for Namespaces and Preview Environments on incoming request
- Added support for Kubernetes 1.30
Improvements
- Added support for displaying the correct Dev Environment name when using Groups and Subgroups in GitLab
- Fixed how Gitlab Groups and Subgroups are displayed in the Previews view
- Prevent the usage of reserved variable names
- Updated registry version to return 404 errors for malformed image requests, allowing new builds of the image to be pushed. This resolves issues where improperly stored images prevented successful new builds
- Added a dashboard indicator to show whether the Garbage Collector is enabled
- Bumped daemon to 0.13.0 and cli to 2.30.0
- Okteto CLI 2.30.0: You can now Build images using the
okteto build
command as part of your Okteto commands in the Okteto Manifest when executing a remote deploy/destroy. Previous to this, no image was being built - Okteto CLI 2.30.0: You can now specify hosts to resolve to specific IPs for your tests defined under the
test
section of the Okteto Manifest
Bug Fixes
- Fix to gracefully handle localStorage errors
- Fixed layout shifting upon loading staged logs
- Fix "variables ignored" warning shown on deploy-URL for "Develop On Okteto Button" feature despite not having specified any variables
- Okteto CLI 2.30.0: Fixed a bug that was preventing
okteto test
from exporting artifacts when a folder was specified under theartifacts
key
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.28.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
- Announced deprecation of Okteto Autoscaler. We recommend relying on cpu/memory requests to autoscale your cluster
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
- Announced deprecation of Okteto Autoscaler. We recommend relying on cpu/memory requests to autoscale your cluster
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
- Announced deprecation of compose file detection by name
New Features
- Enable Pull Secrets by default. If you do not wish to manage pull secrets, please see our upgrade guide to disable.
- Added onboarding guides to our documentation on how to get started with Okteto Insights
- Added the ability to assign a PriorityClass to Okteto components
- Added
globals
andbuildkit
tolerations to the Helm Chart and standardize their helm values
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 abuild
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 ofproject: commit
to detect if an image was already built - Add Grafana to Admin UI to support Okteto Insights for SaaS plan users
Breaking Changes
- Okteto CLI:
okteto deploy
will ignore host volumes defined by Docker Compose services. Please see our community post for more details
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
- Implementation of Admin Access Tokens
Improvements
- Added instructions for deploying Okteto with ArgoCD
- Change default value of ingress.forceIngressSubdomain to false. By default, Okteto won't force deployed applications to match Okteto's subdomain
- Enable by default cluster policy for registry. Enables any of your Okteto users to have read access to any image built in other namespaces. To limit this to the previous behavior, set
registry.pullPolicy
tonamespace
- The Okteto CLI used for Pipeline installation has been upgraded to version 2.25.2
- Upgrade BuildKit to
0.12.5
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
- Enable search in namespace resources UI
- Enable admins to transfer namespace ownership
- Add Pod metrics to Okteto Insights
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