メニュー
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.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/kurtosis-tech/kurtosis --skill port-forwardコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
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.
SOC 職業分類に基づく
SKILL.md を表示中
| name | port-forward |
| description | 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. |
| compatibility | Requires kurtosis CLI with a running engine and at least one enclave. |
| metadata | {"author":"ethpandaops","version":"1.0"} |
View and manage port mappings for Kurtosis services.
kurtosis port print <enclave-name> <service-name> <port-id>
This prints the local URL for a specific port.
The easiest way to see all port mappings is enclave inspect:
kurtosis enclave inspect <enclave-name>
Output shows mappings like:
rpc: 8545/tcp -> 127.0.0.1:61817
ws: 8546/tcp -> 127.0.0.1:61813
The right side (127.0.0.1:61817) is how you access the service locally.
Port IDs are defined in the Starlark ServiceConfig:
plan.add_service(
name="my-service",
config=ServiceConfig(
image="ethereum/client-go:latest",
ports={
"rpc": PortSpec(number=8545), # port ID: "rpc"
"ws": PortSpec(number=8546), # port ID: "ws"
"metrics": PortSpec(number=9001), # port ID: "metrics"
},
),
)
If you ran with --no-connect, ports won't be forwarded locally:
# Ports not forwarded
kurtosis run --no-connect ./my-package
# Ports forwarded (default)
kurtosis run ./my-package
On Kubernetes, port forwarding goes through the gateway. If ports stop working, restart the gateway:
pkill -f "kurtosis gateway"
kurtosis gateway &
When a port is unreachable, follow this diagnostic workflow:
# 1. Verify the enclave is running and check port mappings
kurtosis enclave inspect <enclave-name>
# 2. Confirm the specific service is running (not STOPPED)
kurtosis service inspect <enclave-name> <service-name>
# 3. If service is running but port fails, check service logs for errors
kurtosis service logs <enclave-name> <service-name>
# 4. On Kubernetes, verify the gateway is running
kurtosis gateway
| Symptom | Cause | Fix |
|---|---|---|
| Port not accessible | Service not running or port not exposed | Check step 1-2 above |
| Connection refused | Service crashed or wrong interface | Check service logs (step 3) |
| No port mapping shown | Ran with --no-connect | Re-run without --no-connect |
| K8s ports unreachable | Gateway not running | Restart gateway (step 4) |