菜单
Start and manage the Kurtosis gateway for Kubernetes. The gateway forwards local ports to the Kurtosis engine and services running in a k8s cluster. Required when using Kurtosis with Kubernetes. Use when kurtosis engine status shows nothing on k8s or services aren't reachable.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build and test the Kurtosis CLI from source. Compile the CLI binary locally, run it against Docker or Kubernetes engines, and iterate on CLI changes without creating a release. Use when developing or debugging CLI commands.
Manage Kurtosis contexts for connecting to different Kurtosis instances. Add, list, switch, and remove contexts. Use when working with multiple Kurtosis environments (local, remote, team shared).
Inspect and manage Kurtosis enclaves. List enclaves, view services and ports, examine file artifacts, dump enclave state for debugging, and clean up. Use when you need to understand what's running inside an enclave or export its state.
Inspect, download, upload, and debug Kurtosis file artifacts. View artifacts in an enclave, download them locally for inspection, upload local files, and troubleshoot file mounting issues. Use when services can't find expected files or configs are wrong.
Lint and format Kurtosis Starlark files. Check syntax, validate docstrings, and auto-format .star files. Use when writing or reviewing Starlark packages to ensure code quality.
View and manage port mappings for Kurtosis services. Check which local ports map to service ports and troubleshoot connectivity. Use when services aren't reachable or you need to find the right port.
| name | gateway |
| description | Start and manage the Kurtosis gateway for Kubernetes. The gateway forwards local ports to the Kurtosis engine and services running in a k8s cluster. Required when using Kurtosis with Kubernetes. Use when kurtosis engine status shows nothing on k8s or services aren't reachable. |
| compatibility | Requires kurtosis CLI with Kubernetes cluster access. |
| metadata | {"author":"ethpandaops","version":"1.0"} |
The Kurtosis gateway creates local port forwards to the engine and services running in a Kubernetes cluster.
The gateway is required when running Kurtosis on Kubernetes. Without it, the local CLI cannot reach the engine pod in the cluster.
Not needed when using Docker backend.
# Run in the background
kurtosis gateway &
# Or in a separate terminal
kurtosis gateway
kurtosis engine status
If this returns engine info, the gateway is working. If it says "No Kurtosis engine is running" but you know the engine pod is up, the gateway isn't running.
pkill -f "kurtosis gateway"
The gateway:
kurtosis-engine-* namespacekurtosis enclave inspect point to localhost via the gateway| Symptom | Fix |
|---|---|
No engine running but engine pod is up | Start the gateway: kurtosis gateway & |
| Gateway crashes or disconnects | Restart: pkill -f "kurtosis gateway"; kurtosis gateway & |
| Port conflicts | Kill old gateway first: pkill -f "kurtosis gateway" |
| Services unreachable after gateway restart | Re-inspect enclave for new port mappings |