docs: 1.47 release notes by codyjlandstrom · Pull Request #1320 · okteto/docs

codyjlandstrom · 2026-08-04T15:24:24Z

What

Drafts the release notes for Chart 1.47 / CLI 3.22.0. Draft until the release cut — see open items below.

1.47.0 release notes entry

Important Notes: BuildKit 0.29 → 0.31 upgrade — oci-mediatypes now defaults to true for pushes via okteto build (pulls unaffected), with the OKTETO_BUILD_OCI_MEDIATYPES=false opt-out for registries without OCI media type support (already documented in the feature flags reference). Wording per Nacho (DEV-1427, chore(buildkit): bump buildkit fork to v0.31.0-okteto1 okteto#5067).
New Features: x-enable-service-links for Docker Compose services (PROD-495, feat(compose): allow disabling kubernetes service links per service okteto#5093 + merge fix fix(compose): propagate x-enable-service-links across merged compose files okteto#5097).
Improvements: Okteto skill shortcut in the Namespace view (DEV-1434).
Bug Fixes: BuildKit port-forward deadlock (DEV-1441, fix(build): prevent deadlock on buildkit port forward failure okteto#5083).

Changes from review (ifbyol)

okteto destroy --all fix stays under 1.46 — it shipped in CLI 3.21.0 as a backport ([Backport release-3.21] Fix "okteto destroy --all" hanging on sleeping namespaces okteto#5073); the 1.46 entry is restored untouched (a source comment now records the backport PR). The 1.47 re-listing is dropped.
Routine dependency CVE bumps (Go/kubectl/helm/syncthing) removed — not listed in release notes by convention.
Sleep-job HTTPRoute fix (DEV-1440) omitted — Gateway API is not yet open to all customers; tracked internally on the release page.

Relationship to #1312

The x-enable-service-links reference entry is intentionally not part of this PR — #1312 (open) already adds it to the Docker Compose reference. The release-notes bullet links to the page level for now; a TODO comment marks where to switch to the #x-enable-service-links-boolean-optional anchor once #1312 merges. Two facts worth adding to #1312 during its review: the field requires Okteto CLI 3.22.0+, and it applies to the pod spec whether the service runs as a Deployment, StatefulSet, or Job.

Open items before marking ready

Set the exact release date (currently August 2026 + TODO comment)
Merge docs: document x-enable-service-links compose field #1312, then switch the x-enable-service-links link to the section anchor
Confirm the final UI copy for the Namespace-view skill button with Frontend (DEV-1434)
Verify the compose-merge fix (fix(compose): propagate x-enable-service-links across merged compose files okteto#5097) is in the final 3.22.0 tag — it merged after beta.2
Pending decisions: GHCR image hosting (DEV-1220) scope, Okteto AI tab removal (DEV-1451) comms, Gateway API BYOC public mention (DEV-1329)
Re-run relo against the final CLI tag and chart PRs at cut for anything the sprint missed

yarn build passes (Node 22).

🤖 Generated with Claude Code

netlify · 2026-08-04T15:24:33Z

✅ Deploy Preview for okteto-docs ready!

Name	Link
🔨 Latest commit	`6294955`
🔍 Latest deploy log	https://app.netlify.com/projects/okteto-docs/deploys/6a722c567eba5e00082209cb
😎 Deploy Preview	https://deploy-preview-1320--okteto-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

ifbyol · 2026-08-04T17:38:21Z

-### Bug Fixes {#bug-fixes-1.46}
-
- [Okteto CLI 3.21.0](https://github.com/okteto/okteto/releases/tag/3.21.0): Fixed `okteto destroy --all` hanging until it timed out, and reporting a false error, when run against a Sleeping Namespace. The command now completes and leaves the Namespace in its previous status <!-- okteto/okteto#5072 -->
-


This should be kept. The fix was included in 3.21.0 as a backport once the release was cut, but it went out in that version

Confirmed — the fix is in the 3.21.0 tag history as a backport: commit 20be1c9b, "Fix "destroy all" hanging when namespace is sleeping (#5072) (#5073)". I'd only checked the 3.21.0...3.22.0-beta.1 compare range, which lists the master merge SHA but not the cherry-picked twin. Restored the 1.46 entry — this PR no longer touches the versioned docs; the only change is a source comment on the current-docs entry recording the #5073 backport.

ifbyol · 2026-08-04T17:39:07Z

+
+### New Features {#new-features-1.47}
+
+- **Disabling Kubernetes service links in Docker Compose**: Docker Compose services now support a per-service [`x-enable-service-links`](reference/docker-compose.mdx) field. <!-- TODO: link the #x-enable-service-links-boolean-optional anchor once okteto/docs#1312 merges --> Set it to `false` to stop Kubernetes from injecting service link environment variables such as `<SERVICE>_SERVICE_HOST` and `<SERVICE>_PORT` into the service's containers, which can break applications that expect a plain port number — or no value — under those names. This brings Docker Compose deployments to parity with `enableServiceLinks: false` in Kubernetes manifests. The field is opt-in and requires Okteto CLI 3.22.0 or later <!-- PROD-495, DEV-1449, okteto/okteto#5093, okteto/okteto#5097 -->


Just a explicit message for the TODO comment, to remember to be filled before merging it

Tracked in the PR checklist ("Merge #1312, then switch the x-enable-service-links link to the section anchor"). The link stays page-level for now because onBrokenAnchors: 'throw' would fail the build against an anchor that only exists in the unmerged #1312.

ifbyol · 2026-08-04T17:39:56Z

+### Improvements {#improvements-1.47}
+
+- **Okteto skill setup from the Namespace view**: The Namespace view now includes a shortcut to set up the Okteto skill, making [Agentic Workflows](agentic/index.mdx) easier to discover <!-- DEV-1434 · TODO: confirm final UI copy with Frontend before release -->
+- [Okteto CLI 3.22.0](https://github.com/okteto/okteto/releases/tag/3.22.0): Upgraded the Go toolchain and the bundled `kubectl`, `helm`, and `syncthing` binaries to address known CVEs <!-- okteto/okteto#5098, okteto/okteto#5100 -->


We usually don't include this in the release notes, as this is something we do mostly in all the releases

Removed. Checked 1.44–1.46 and routine dependency bumps indeed aren't listed — the ingress-nginx entries were specific high-severity CVEs, which is a different case.

ifbyol · 2026-08-04T17:40:35Z

+### Bug Fixes {#bug-fixes-1.47}
+
+- [Okteto CLI 3.22.0](https://github.com/okteto/okteto/releases/tag/3.22.0): Fixed the CLI hanging without output — or crashing with a goroutine deadlock error — when the connection to BuildKit through the port-forward failed. The CLI now reports the connection error <!-- DEV-1441, okteto/okteto#5083 -->
+- [Okteto CLI 3.22.0](https://github.com/okteto/okteto/releases/tag/3.22.0): Fixed `okteto destroy --all` hanging until it timed out, and reporting a false error, when run against a Sleeping Namespace. The command now completes and leaves the Namespace in its previous status. This fix was previously listed under 1.46, but it ships with Okteto CLI 3.22.0 <!-- okteto/okteto#5072 -->


This was done in previous release, so we could remove it from here

Removed — same conclusion as the thread on the versioned file: the fix shipped in 3.21.0 via the #5073 backport, so the 1.46 entry stands and there's nothing to list under 1.47.

ifbyol · 2026-08-04T17:41:23Z

+
+- [Okteto CLI 3.22.0](https://github.com/okteto/okteto/releases/tag/3.22.0): Fixed the CLI hanging without output — or crashing with a goroutine deadlock error — when the connection to BuildKit through the port-forward failed. The CLI now reports the connection error <!-- DEV-1441, okteto/okteto#5083 -->
+- [Okteto CLI 3.22.0](https://github.com/okteto/okteto/releases/tag/3.22.0): Fixed `okteto destroy --all` hanging until it timed out, and reporting a false error, when run against a Sleeping Namespace. The command now completes and leaves the Namespace in its previous status. This fix was previously listed under 1.46, but it ships with Okteto CLI 3.22.0 <!-- okteto/okteto#5072 -->
+- Fixed the Namespace sleep job intermittently failing with a conflict error while updating HTTPRoutes, which could leave endpoints of a Sleeping Namespace returning a 503 error instead of waking the environment. This only affects clusters with the Gateway API enabled <!-- DEV-1440 -->


I have doubts about this, should we include it? It is not a feature completely open to all the customers

Removed from the public notes. Gateway API is staying out of 1.47 customer comms (it's tracked as an internal workstream on the release page), so a public bullet naming HTTPRoutes would get ahead of the rollout. The fix stays documented internally and we can surface it when Gateway API is announced.

Add the 1.47.0 release notes entry: BuildKit 0.31 upgrade with the oci-mediatypes default change and its OKTETO_BUILD_OCI_MEDIATYPES opt-out, x-enable-service-links for Docker Compose, the Okteto skill shortcut in the Namespace view, and the BuildKit port-forward deadlock fix. Per review (ifbyol): the okteto destroy --all fix stays under 1.46 - it shipped in CLI 3.21.0 as a backport (okteto/okteto#5073); routine dependency CVE bumps are not listed per convention; the sleep-job HTTPRoute fix is omitted since Gateway API is not yet open to all customers. The x-enable-service-links reference entry is covered by the open #1312; the release-notes link points at the page level until that PR merges. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Cody Landstrom <cody@okteto.com>

codyjlandstrom force-pushed the release-notes-1.47 branch from 6d1ca0f to b81afae Compare August 4, 2026 16:09

ifbyol reviewed Aug 4, 2026

View reviewed changes

codyjlandstrom changed the title ~~docs: 1.47 release notes + x-enable-service-links reference~~ docs: 1.47 release notes Aug 4, 2026

codyjlandstrom force-pushed the release-notes-1.47 branch from b81afae to 6294955 Compare August 4, 2026 18:15

codyjlandstrom marked this pull request as ready for review August 4, 2026 19:05

codyjlandstrom requested review from pchico83 and rlamana as code owners August 4, 2026 19:05

ifbyol approved these changes Aug 5, 2026

View reviewed changes

codyjlandstrom merged commit 5ff154b into main Aug 5, 2026
4 checks passed

codyjlandstrom deleted the release-notes-1.47 branch August 5, 2026 15:40

Navigation Menu

Uh oh!

docs: 1.47 release notes - #1320

docs: 1.47 release notes#1320
codyjlandstrom merged 1 commit into
mainfrom
release-notes-1.47

codyjlandstrom commented Aug 4, 2026 •

edited by atlassian Bot

Loading

Uh oh!

netlify Bot commented Aug 4, 2026 •

edited

Loading

Uh oh!

ifbyol Aug 4, 2026

Uh oh!

codyjlandstrom Aug 4, 2026

Uh oh!

ifbyol Aug 4, 2026

Uh oh!

codyjlandstrom Aug 4, 2026

Uh oh!

ifbyol Aug 4, 2026

Uh oh!

codyjlandstrom Aug 4, 2026

Uh oh!

ifbyol Aug 4, 2026

Uh oh!

codyjlandstrom Aug 4, 2026

Uh oh!

ifbyol Aug 4, 2026

Uh oh!

codyjlandstrom Aug 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		### Bug Fixes {#bug-fixes-1.46}

		- [Okteto CLI 3.21.0](https://github.com/okteto/okteto/releases/tag/3.21.0): Fixed `okteto destroy --all` hanging until it timed out, and reporting a false error, when run against a Sleeping Namespace. The command now completes and leaves the Namespace in its previous status <!-- okteto/okteto#5072 -->


		### New Features {#new-features-1.47}

		- Disabling Kubernetes service links in Docker Compose: Docker Compose services now support a per-service [`x-enable-service-links`](reference/docker-compose.mdx) field. <!-- TODO: link the #x-enable-service-links-boolean-optional anchor once okteto/docs#1312 merges --> Set it to `false` to stop Kubernetes from injecting service link environment variables such as `<SERVICE>_SERVICE_HOST` and `<SERVICE>_PORT` into the service's containers, which can break applications that expect a plain port number — or no value — under those names. This brings Docker Compose deployments to parity with `enableServiceLinks: false` in Kubernetes manifests. The field is opt-in and requires Okteto CLI 3.22.0 or later <!-- PROD-495, DEV-1449, okteto/okteto#5093, okteto/okteto#5097 -->

Uh oh!

Conversation

codyjlandstrom commented Aug 4, 2026 • edited by atlassian Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

1.47.0 release notes entry

Changes from review (ifbyol)

Relationship to #1312

Open items before marking ready

Uh oh!

netlify Bot commented Aug 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for okteto-docs ready!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

codyjlandstrom commented Aug 4, 2026 •

edited by atlassian Bot

Loading

netlify Bot commented Aug 4, 2026 •

edited

Loading