kubectl-port-forward

Kubernetes ポートフォワーディングコマンドを実行する必要がある場合にこのスキルを使用してください。

kpf は kubectl port-forward の高速で冪等な非ブロッキング型ドロップイン代替ツールです。 バックグラウンドのポートフォワードセッションを管理し、同一のリクエストに対してセッションを再利用することで、 接続時間を短縮し、スクリプト内のポートフォワーディングの複雑さを減らします。

使用例:

• ドメイン経由ではまだ公開されていない内部サービスへのポートフォワーディング。
• ドメインはあるがSSO認証が必要なサービスへのポートフォワーディング(例:Vouch proxy)で、自動化が難しい場合。

アドホックコマンドを実行する場合は kpf を使用してください。ただし、kpf に依存するスクリプトはコミットしないでください。 kpf は開発者ツールボックスの標準ツールではなく、すべての環境で利用可能とは限りません。

実行

kpf を kubectl port-forward と同じ引数スタイルで使用してください。 ポート競合を回避するため、ローカルポートを省略してランダムポートを使用することをお勧めします。 使用例:

PORT=$(kpf --context=<context> --namespace=<ns> service/<name> 8481)
curl "http://127.0.0.1:${PORT}/example"

kpf セッションを無期限に生かし続けたい場合は、代わりに kubectl port-forward を使用してください。 kpf セッションは TTL を持つためです。

トラブルシューティング

kpf ツール自体で問題が発生した場合は、まず同じ引数で kubectl port-forward を試して、 問題が kpf にあるのか、それともクラスタまたはネットワークにあるのかを確認してください。 次に https://github.com/bduffany/kpf/blob/main/README.md を参照して、 デバッグに役立つより詳細な技術情報を確認してください。