Skip to content

docs: document x-enable-service-links compose field - #1312

Merged
codyjlandstrom merged 2 commits into
mainfrom
docs/compose-x-enable-service-links
Aug 5, 2026
Merged

docs: document x-enable-service-links compose field#1312
codyjlandstrom merged 2 commits into
mainfrom
docs/compose-x-enable-service-links

Conversation

@ekline

@ekline ekline Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

What this documents

Documents the new optional x-enable-service-links service field in the Docker Compose reference, introduced in okteto/okteto#5093.

The field maps to the Kubernetes pod spec's enableServiceLinks. Setting it to false stops Kubernetes from injecting service-link environment variables (<SERVICE>_SERVICE_HOST, <SERVICE>_SERVICE_PORT, <SERVICE>_PORT, and related variants) into a service's containers. It is opt-in and unset by default, preserving current behavior.

Changes

  • Added an x-enable-service-links (boolean, optional) field section in src/content/reference/docker-compose.mdx, alongside the existing x-node-selector and x-okteto-identity-token extensions.
  • Added a row for the field to the Okteto-specific extras summary table.

How to verify

Open the Docker Compose reference page and confirm the new field section and the summary-table row read correctly and match the surrounding x-* field documentation.

Source PR: okteto/okteto#5093


📝 Created with EkLine · View session

ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>

Document the new optional x-enable-service-links service field in the
Docker Compose reference, added in okteto/okteto#5093. It toggles
Kubernetes service-link environment variable injection per service.

ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>

Signed-off-by: ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>
@netlify

netlify Bot commented Jul 22, 2026

Copy link
Copy Markdown

Deploy Preview for okteto-docs ready!

Name Link
🔨 Latest commit 78cdd00
🔍 Latest deploy log https://app.netlify.com/projects/okteto-docs/deploys/6a722ae123812c000826bf0d
😎 Deploy Preview https://deploy-preview-1312--okteto-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@ekline
ekline Bot requested a review from jLopezbarb July 22, 2026 11:53
codyjlandstrom added a commit that referenced this pull request Aug 4, 2026
- 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, CLI CVE bumps,
  and the 3.22.0 bug fixes.
- Move the okteto destroy --all fix from the 1.46 notes to 1.47: the
  fix (okteto/okteto#5072) merged after the 3.21.0 tag and ships with
  CLI 3.22.0, so the 1.46 attribution was incorrect. Removed from both
  the current and version-1.46 release notes.

The x-enable-service-links reference entry is deliberately NOT part of
this PR - it is already 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 codyjlandstrom mentioned this pull request Aug 4, 2026
6 tasks
@codyjlandstrom

Copy link
Copy Markdown
Contributor

@ifbyol Could I get your quick review on this?

codyjlandstrom added a commit that referenced this pull request Aug 4, 2026
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
codyjlandstrom merged commit 568d86a into main Aug 5, 2026
4 checks passed
@codyjlandstrom
codyjlandstrom deleted the docs/compose-x-enable-service-links branch August 5, 2026 15:39
codyjlandstrom added a commit that referenced this pull request Aug 5, 2026
docs: draft 1.47 release notes

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.

Signed-off-by: Cody Landstrom <cody@okteto.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants