From 83c18860a840f54cd535c48289dc0263d1292698 Mon Sep 17 00:00:00 2001 From: Adham Kiwan Date: Thu, 19 Nov 2026 01:35:33 +0200 Subject: [PATCH] Docs: state that WASM function support was removed Update the --allow-alpha-wasm flag reference for fn eval and fn render, and add a note to the alpha wasm page that says running WASM functions was removed and why. Regenerate the embedded CLI docs. Fixes #4883 Assisted-by: Claude Code (claude-opus-5-5) Co-Authored-By: Claude Opus 5.5 Signed-off-by: Adham Kiwan --- .../content/en/reference/cli/alpha/wasm/_index.md | 9 +++++++++ .../content/en/reference/cli/fn/eval/_index.md | 6 +++--- .../content/en/reference/cli/fn/render/_index.md | 5 ++--- internal/docs/generated/fndocs/docs.go | 11 +++++------ 4 files changed, 19 insertions(+), 12 deletions(-) diff --git a/documentation/content/en/reference/cli/alpha/wasm/_index.md b/documentation/content/en/reference/cli/alpha/wasm/_index.md index d4d5ac1433..e0705ba175 100644 --- a/documentation/content/en/reference/cli/alpha/wasm/_index.md +++ b/documentation/content/en/reference/cli/alpha/wasm/_index.md @@ -17,4 +17,13 @@ menu: The `wasm` command group contains subcommands for managing WASM modules as OCI images. + +{{% alert title="WASM functions are no longer supported" color="warning" %}} +kpt used to be able to run KRM functions compiled to WASM, with the `--allow-alpha-wasm` flag of +`kpt fn eval` and `kpt fn render`. That alpha feature has been removed: the runtimes it relied on are +no longer maintained, and the feature saw little use. The flag is still accepted, but any function run +with it fails with an error. Run your functions as container images or executables instead. See +[#4881](https://github.com/kptdev/kpt/issues/4881) for background. +{{% /alert %}} + {{< listdocs >}} diff --git a/documentation/content/en/reference/cli/fn/eval/_index.md b/documentation/content/en/reference/cli/fn/eval/_index.md index d88f88ba32..e287736ae2 100644 --- a/documentation/content/en/reference/cli/fn/eval/_index.md +++ b/documentation/content/en/reference/cli/fn/eval/_index.md @@ -60,9 +60,9 @@ fn-args: ```shell --allow-alpha-wasm: - Allow alpha wasm functions to be run. If true, you can specify a wasm image - with --image flag or a path to a wasm file (must have the .wasm file - extension) with --exec flag. Defaults to false. + Deprecated. Support for WASM functions has been removed from kpt. If set, + running a function given with --image, or a .wasm file given with --exec, + fails with an error. Defaults to false. --as-current-user: Use the `uid` and `gid` of the kpt process for container function execution. diff --git a/documentation/content/en/reference/cli/fn/render/_index.md b/documentation/content/en/reference/cli/fn/render/_index.md index 1100eff522..367e53ae59 100644 --- a/documentation/content/en/reference/cli/fn/render/_index.md +++ b/documentation/content/en/reference/cli/fn/render/_index.md @@ -52,9 +52,8 @@ PKG_PATH: ```shell --allow-alpha-wasm: - Allow wasm to be used during pipeline execution. When enabled, function - images that are wasm modules will be executed using the wasm runtime - instead of a container runtime. Defaults to false. + Deprecated. Support for WASM functions has been removed from kpt. If set, + every function in the pipeline fails with an error. Defaults to false. --allow-exec: Allow executable binaries to run as function. Note that executable binaries diff --git a/internal/docs/generated/fndocs/docs.go b/internal/docs/generated/fndocs/docs.go index f605d93a20..3265a98e56 100644 --- a/internal/docs/generated/fndocs/docs.go +++ b/internal/docs/generated/fndocs/docs.go @@ -59,9 +59,9 @@ Args: Flags: --allow-alpha-wasm: - Allow alpha wasm functions to be run. If true, you can specify a wasm image - with --image flag or a path to a wasm file (must have the .wasm file - extension) with --exec flag. Defaults to false. + Deprecated. Support for WASM functions has been removed from kpt. If set, + running a function given with --image, or a .wasm file given with --exec, + fails with an error. Defaults to false. --as-current-user: Use the ` + "`" + `uid` + "`" + ` and ` + "`" + `gid` + "`" + ` of the kpt process for container function execution. @@ -304,9 +304,8 @@ Args: Flags: --allow-alpha-wasm: - Allow wasm to be used during pipeline execution. When enabled, function - images that are wasm modules will be executed using the wasm runtime - instead of a container runtime. Defaults to false. + Deprecated. Support for WASM functions has been removed from kpt. If set, + every function in the pipeline fails with an error. Defaults to false. --allow-exec: Allow executable binaries to run as function. Note that executable binaries