gateway

Runs and supervises Kurtosis gateway Kubernetes engine port-forwarding from localhost to pods.

547|97|Updated Feb 14, 2023
One-click install
npx skills add https://github.com/kurtosis-tech/kurtosis --skill gateway-kurtosis-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gateway
Source: https://github.com/kurtosis-tech/kurtosis/tree/main/skills/gateway
Command: npx skills add https://github.com/kurtosis-tech/kurtosis --skill gateway-kurtosis-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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.

Core Features & Use Cases

  • Ensure reliable connectivity to a Kurtosis engine inside a Kubernetes cluster by establishing port-forwarding from localhost to engine and service pods.
  • Manage the gateway lifecycle with simple start, verify, and stop commands; diagnose common issues when the engine appears unreachable.

Quick Start

Run kurtosis gateway to start the gateway and verify engine connectivity with kurtosis engine status.

Frequently Asked Questions about gateway

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I port-forward to a Kurtosis engine running inside a Kubernetes cluster?

Use the Kurtosis gateway to establish port-forwarding from localhost to the engine and service pods within your Kubernetes cluster. Verify connectivity by running kurtosis engine status after starting the gateway.

Why does kurtosis engine status show nothing when running on Kubernetes?

Kurtosis engine status shows nothing on Kubernetes when local connectivity to the cluster is not established. Start the Kurtosis gateway to manage port-forwarding and bridge localhost to the engine and service pods.

How do I manage the Kurtosis gateway lifecycle for Kubernetes locally?

Manage the Kurtosis gateway lifecycle using simple start, verify, and stop commands. These commands supervise the gateway process and maintain port-forwarding from localhost to the Kubernetes engine and service pods.

When do I need to start a gateway for Kurtosis on Kubernetes?

You need to start the Kurtosis gateway when using Kurtosis with Kubernetes, especially if services aren't reachable or the engine status is unreachable. It facilitates local access by forwarding ports to the cluster.

Can I diagnose Kurtosis gateway port-forwarding issues when the engine is unreachable?

Yes, the Kurtosis gateway implements common troubleshooting guidance to diagnose connectivity issues when the engine appears unreachable. It supervises port-forward management to ensure secure and reliable local access to Kubernetes.

Does the Kurtosis gateway work with services running in a Kubernetes cluster?

Yes, the Kurtosis gateway forwards local ports to both the Kurtosis engine and services running in a Kubernetes cluster. It applies Kubernetes-aware commands to ensure reliable local connectivity to all relevant pods.