PhpStorm 2026.1 Help

Kubernetes

Kubernetes(英語) は、デプロイ、スケーリング、コンテナー化されたアプリケーションの管理のためのコンテナーオーケストレーションエンジンです。 PhpStorm 用の Kubernetes プラグインをインストールして有効化すると、Kubernetes クラスター管理のための次の機能が追加されます：

  • Kubernetes リソース設定ファイル(英語)のコーディング支援。

  • Helm(英語) チャートとテンプレートのコーディング支援。 詳細については、 Helm 専用ページを参照してください。

  • カスタムリソース定義（CRD）仕様を使用したカスタムリソースの検証。

  • カスタマイズする(英語)ファイルのコーディング支援: フィールドおよびローカルファイルパスの補完、クイックドキュメント、Kustomize ファイルとパッチ間のナビゲーション。 関連する Kustomize ファイルのリストは、開いている Kustomize パッチの上部にあるエディターに表示されます。

  • PhpStorm からクラスターとやり取りするには、 サービスツールウィンドウを使い、Kubernetes クラスターのすべてのリソースの表示、関連リソース定義へのジャンプ、pods 上で実行中のコンテナーのログ表示などが行えます。

Kubernetes プラグインは、Kubernetes バージョン 1.26 から 1.34 までサポートします (該当するバージョンを選択できます)。

Kubernetes プラグインをインストールする

この機能は、インストールして有効にする必要がある Kubernetes(英語) プラグインに依存しています。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. Marketplace タブを開き、 Kubernetes プラグインを見つけて、 インストール​する​ をクリックします (プロンプトが表示されたら、IDE を再起動します)。

kubectl へのカスタムパスを指定する

PhpStorm は、 PATH 環境変数によって決定されるデフォルトの kubectl（および 使用している場合は helm ）実行可能ファイルを使用します。

kubectl をカスタムディレクトリにインストールする場合は、そのパスを手動で指定できます。

  1. 設定 ダイアログ（Ctrl+Alt+S ）で、 ビルド、実行、デプロイ | Kubernetes を選択します。

  2. kubectl 実行可能ファイルへのパス フィールドに、kubectl 実行可能ファイルへのパスを指定します。

  3. テスト をクリックしてファイルの場所を確認してください。 見つからない場合は、ファイルの場所を手動で確認するか、 インストール​する​ をクリックすると、PhpStorm が不足しているソフトウェアをダウンロードしてインストールします。

Kubernetes 設定ウィンドウ

カスタム Kubernetes 構成ファイルを使用する

クラスター情報は kubeconfig ファイルに保存されます。 PhpStorm は通常 $HOME/.kube/config にあるデフォルトの kubeconfig ファイルを検出します (この場所は KUBECONFIG 環境変数で変更できます)。 PhpStorm でカスタム kubeconfig ファイルからもクラスター情報を取得したい場合は、IDE の設定で指定できます。 グローバルに適用するか、プロジェクトごとに別々のファイルを使うこともできます。

  1. 設定 ダイアログ（Ctrl+Alt+S ）で、 ビルド、実行、デプロイ | Kubernetes を選択します。

  2. 構成 で、 kubeconfig を追加する。 をクリックし、 kubeconfig ファイルへのパスを指定します。

  3. すべてのプロジェクトで構成ファイルを使用する場合は、 スコープ 列で グローバル を選択します。 現在のプロジェクトでのみ使用するには、 プロジェクト スコープを保持します。

ファイルを追加すると、PhpStorm が構文を検証し、エラーがあれば報告します。

Kubeconfig の構成

Kubernetes API バージョンを構成する

PhpStorm は、構成キー値の 補完や、ガターアイコンによる関連セレクターや定義へのナビゲーション、非推奨値や必須キーをチェックする専用のインスペクション、その他の支援機能を提供します。 これらの機能は、使用している API のバージョンによって異なります。 Kubernetes プラグインは、Kubernetes バージョン 1.26 から 1.34 をサポートしています。 デフォルトでは、PhpStorm は最新バージョンを設定します。 ただし、リソースで以前のバージョンを使用している場合は、変更できます。

  1. 設定 ダイアログ (Ctrl+Alt+S) で、 言語 & フレームワーク | Kubernetes を選択します。

  2. 必要に応じて、 Kubernetes API バージョン および Kustomize バージョン オプションを変更します。

リソース構成ファイル

Kubernetes プラグインは、YAML のリソース構成ファイルの豊富なサポートを提供し、JSON 形式の基本的なサポートのみを提供します。

サポートされている機能

機能

YAML

JSON

自動補完

サポート

サポート

クイックドキュメント

サポート

サポート

インスペクションとクイックフィックス

  • 無効なキー、不足しているキー、重複したキー

  • 編集不可能な（読み取り専用の）キーとリソース

  • 廃止予定のキーとリソース

  • 整数値と列挙型キーの値が無効です

  • 無効なプロパティ、不足しているプロパティ、重複したプロパティ

ライブテンプレート

一般的なリソースタイプの定義済みテンプレート

定義済みライブテンプレートなし

スマート補完

サポート

未サポート

カスタムリソース定義

サポート

未サポート

ラベル定義とセレクタ

ガターアイコンを使用したナビゲーション、使用箇所の検索、名前の変更

未サポート

オリジナルの Kubernetes モデルの強化

該当する場合はプレーン文字列の代わりに列挙型

なし

PhpStorm は、以下の必須フィールドを使用して Kubernetes リソース構成ファイルを認識します：

  • apiVersion: オブジェクト表現のバージョン管理されたスキーマを識別する

  • kind: リソースタイプを識別します (たとえば、 サービス、 Pod、 デプロイ などです。)

YAML または JSON ファイルに両方のフィールドがある場合、PhpStorm は該当する Kubernetes アイコンでファイルをマークし、すべての利用可能な機能を有効化します。

リソースファイルを作成する

PhpStorm を使うと、Kubernetes の代表的なリソースの構成ファイルを手早く作成できます。

  1. プロジェクト ツールウィンドウ（Alt+1 ）で、フォルダーを右クリックし、 新規 を選択するか、 Alt+Insert を押してから、 Kubernetes リソース を選択します。

  2. 命名 フィールドにリソース名を入力し、リストからファイルテンプレートを選択します。

    新しい Kubernetes リソースウィンドウ

    これにより、選択した ファイルテンプレートに基づく内容で新規ファイルが作成されます。

また、YAML ファイルでは定義済みの ライブテンプレートも利用できます。例えば：

  • kconfigmap: Kubernetes ConfigMap

  • kcronjob: Kubernetes CronJob

  • kdeployment: Kubernetes デプロイ

  • kingress: Kubernetes Ingress

  • kpod: Kubernetes Pod

  • kresource: Kubernetes リソースをゼロから構築

  • kservice: Kubernetes サービス

Kubernetes ライブテンプレート

エディターで Kubernetes リソースファイルを開くと、PhpStorm は インレイヒントと、最もよく使われるアクションを含むツールバーを表示します：

  1. フローティングツールバーでは、以下のことが可能です。

    • 現在のクラスターと名前空間を選択します

    • 適用アイコン 変更を適用し、現在のクラスターに配信します

    • Delete icon リソースを削除する

    • Compare icon クラスターバージョンとの変更点を比較する

    • Reload icon クラスターからコンテンツを再読み込みします

    フローティングツールバー

  2. デプロイされたリソースのステータスを確認するためのインレイヒント

  3. 参照されたシークレット値の開示・コピーを行うためのインレイヒント

  4. ポートを転送するためのインレイヒント

Kubernetes マニフェストのヒント

フローティングツールバーの外観を設定する

エディターでフローティングツールバーをいつ表示するかを設定できます。

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | Kubernetes を選択します。

  2. エディターにフローティングツールバーを表示する オプションを使用して、フローティングツールバーがいつ表示されるかを選択します。

    • 常に表示

    • マウス移動時に表示

    • 表示しない

    または、フローティングツールバーを右クリックして必要なオプションを選択することもできます。

Kubernetes スキーマの検証を無効にする

PhpStorm は、Kubernetes API スキーマで Kubernetes ファイルを検証します。 これには、必要なキーまたは可能なタイプのリソースのチェックが含まれます。

ファイルに apiVersion と kind が含まれているが、それが Kubernetes ファイルではない場合、そのような検証を無効にすることができます。 インスペクションを抑制し、その範囲と重大度を 設定 | エディター | インスペクション | Kubernetes で変更できます。 または、検証を無効にする特別なディレクティブでファイルをマークすることもできます。

  • ファイルの先頭に # nonk8s を追加します。

  • または、不明なリソースに関する警告がすでにある場合は、 問題 ツールウィンドウでそれを右クリックし、 クイックフィックスの表示 | このファイルを非 Kubernetes にマーク を選択します。

クラスターを管理する

サービスツールウィンドウを使用して、クラスターを表示し、名前空間を切り替え、クラスターリソースを変更します。

コンテキストの追加

Kubernetes クラスターと対話するには、 サービス ツールウィンドウでクラスターを追加します。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. サービス ツールウィンドウで Kubernetes ノードを右クリックし、 クラスターの追加 を選択します。 または、 追加ボタン をクリックして Kubernetes | コンテキストの追加 を選択します。

    次に、追加する Kubernetes クラスターのソースを選択します：

    • デフォルトディレクトリから: デフォルトの場所 (通常は $HOME/.kube/config) からクラスターを取得します。

    • カスタム kubeconfigs から: コンピューターから任意の kubeconfig ファイルを選択します。

    • kubeconfig の内容を貼り付け: 開いたテキストエリアに kubeconfig のコンテンツを貼り付けます。

    Kubernetes コンテキストソースを選択

  3. 開いた クラスターの追加 ウィンドウで、追加するクラスターを選択し、 クラスターの追加 をクリックします。

    クラスターの追加ウィンドウ

追加された Kubernetes クラスターは、 サービス ツールウィンドウで利用できるようになります。 クラスターを右クリックして 新規タブで開く を選択すると、それぞれを別のタブで開くことができます。

クラスターリソースをリアルタイムで監視するには、 クラスターに接続します。

クラスターに接続する

IDE でクラスターに接続すると、ログ追跡・リソースプレビュー・構成ファイルの表示・変更時のライブ更新などが可能になります。 クラスターと未接続でも、エディターで リソースを編集できます。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. サービス ツールウィンドウにクラスターがない場合は、 クラスターを追加します。

  3. クラスターを右クリックし、 クラスターを接続 を選択します。

クラスターを接続

kubeconfig の編集

kubeconfig ファイルには、クラスター、ユーザー、名前空間、認証に関する情報が含まれています。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. クラスターを選択し、ツールバーの エディターで kubeconfig ファイルを開く (エディターで kubeconfig ファイルを開く) をクリックします。 このアクションは、 サービス ツールウィンドウで任意の Kubernetes オブジェクトを右クリックした場合にも使用できます。

    これにより、エディターの新しいタブで kubeconfig ファイルが開きます。 このアクションによって開かれるデフォルトのファイルを変更するには、 kubeconfig ファイルへのパスで別のファイルへのパスを指定できます。

kubeconfig ファイルを変更すると、構成が自動的に再ロードされます。 クラスターまたは任意の Kubernetes オブジェクトを右クリックして 詳細 | 構成を自動的に再ロード を選択することにより、手動で再ロードするか、自動再ロードを無効にすることもできます。

構成の再読み込み

名前空間を切り替える

Kubernetes 名前空間を使用すると、クラスター内のリソースを論理的に分離できます。 PhpStorm を使うと、名前空間をすばやく切り替えられます。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. クラスターまたは任意のリソースを右クリックし、 名前空間 を選択し (またはツールバーの 名前空間アイコン をクリックし)、必要な名前空間を選択します。

    すべての名前空間のリソースを表示するには、 すべての名前空間 を選択します。

    名前空間のコンテキストメニュー

現在のクラスターを選択

現在のクラスターとは、エディターおよび プロジェクト ツールウィンドウでリソースと対話するためのデフォルトとして設定されているクラスターを指します。

リソースファイルをローカルで変更または作成する場合、 コンテキストを選択 をクリックするか、 フローティングツールバーを使用して、リソースを適用するクラスターを選択できます。 また、事前に選択しておくこともできます。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. クラスターを右クリックし、 クラスターを現在のクラスターとして設定 を選択します。

    現在のクラスターを設定

    または、クラスターを選択し、ツールバーの をクリックします。

この設定は、IDE 設定の 言語 & フレームワーク | Kubernetes でも使用できます。

クラスターにリソースを作成する

リソースファイルを作成したら、クラスター内に対応するリソースを作成できます。

  1. 必要なリソースファイルをエディターで開きます。 現在のクラスターが設定されていない場合は、 フローティングツールバーを使用して選択してください。

    現在のクラスターを設定

    必要に応じて、リストから名前空間を選択することもできます。

  2. 現在のクラスターと名前空間に変更を適用するには、 適用アイコン をクリックします。

クラスタリソースを変更する

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. リソースを右クリックし、 YAML の表示 を選択します。

    選択したリソースのマニフェストがエディターの新しいタブで開きます。 フィールドを変更すると、変更された行がガターでハイライト表示されます。 ガターのハイライト領域をクリックすると、変更内容をすぐにプレビューしたり、ロールバックしたりできます。

  3. フローティングツールバーで現在のクラスターを選択済みか確認し、 適用アイコン をクリックして変更を適用してください。

リソースの詳細を表示

PhpStorm を使えば、コマンドを手動で実行せずに Kubernetes リソースの詳細をすばやく確認できます。

  • サービス ツールウィンドウで、リソースを選択して詳細を表示します。

  • PhpStorm は、デプロイ済み Kubernetes リソースのライブステータスをエディターに直接表示します。 例: デプロイマニフェストを開くと、 replicas フィールドの横にステータスインジケーターが表示され、現在実行中、保留中、失敗している pods の数が表示されます。

    Kubernetes デプロイファイル内の Pod ステータス

    個々の pods およびジョブのステータスは、それぞれのマニフェストの 名前 フィールドの横で確認できます。

    エラーが発生しリソースが失敗した場合、PhpStorm は ログを開く リンクを表示し、関連するエラー内容のログエントリへすぐ移動できます。

    ログリンクを開く

リソースの削除

次のいずれかの方法でリソースを削除できます：

  • サービス ツールウィンドウでリソースを右クリックし、 削除 を選択します。

  • サービス ツールウィンドウでリソースを選択し、ツールバーの リソースを削除 (リソースの削除) をクリックします。

  • リソース YAML ファイルがエディターで開かれている場合は、フローティングツールバーで現在のクラスターを選択し、 リソースを削除 をクリックします。

  • リソース YAML ファイルが開いている場合は、エディター内の任意の場所を右クリックし、フローティングツールバーでクラスターが選択されていない場合は 削除（現在のクラスターは構成されていません） を選択し、クラスターが選択されている場合は クラスター「cluster_name」と名前空間「namespace_name」から削除する を選択します。

ポートの転送

Kubernetes のポート転送を使うと、コンピューター上のローカルポートから Kubernetes Pod 上のポートへトラフィックをリダイレクトできます。 PhpStorm ではポート転送の管理が行えます。ローカルポートからリモートポートへの転送、アクティブな転送セッションの一覧表示 (クラスター内で確立されたもの、PhpStorm 上)、転送セッションの停止・再開などが可能です。

  1. 次のいずれかの方法でポート転送を設定できます。

    • Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押してください。 ターゲット pod を右クリックして ポートの転送 を選択します。

    • Kubernetes マニフェストで ポートの転送 インレイヒントをクリックします。 宛先ポートが指定されている場合 (例: containerPort の値として)、PhpStorm はインレイヒントを表示します。

      転送ポートインレイヒント

  2. ポートの転送 ダイアログで:

    • 住所 フィールドに、リッスンするアドレスをリストします。 複数の値を入力する場合は、コンマで区切ってください。

    • ポート フィールドでは、 <local port>:<remote port> 形式でポートを指定します。 例: 8888:5000 はローカルポート 8888 をリッスンし、リモートポート 5000 との間でデータを転送します。

      PhpStorm は対応する Kubernetes マニフェストの値に基づき、ポートマッピングを自動提案します。 マニフェストで既にローカルマシンで使用中のポートが指定された場合、PhpStorm は使用可能なポートが見つかるまで提案値を順次増やします。

      指定された値が 1024 より小さい場合、推奨されるローカルポート値に 8000 が追加されます。

      今現在ビジーなローカルポートを手動で指定すると、転送開始前に PhpStorm から通知されます。

  3. 進む をクリックしてください。

ポートの転送

ポート転送セッションを管理する

  • すべてのアクティブなポート転送セッションを表示するには、 サービス ツールウィンドウで、Kubernetes クラスターの ネットワーク | ポート転送 を展開します。

    ポート転送セッションのリスト

  • ポート転送セッションを終了するには、それを右クリックして ポート転送を停止する を選択するか、ツールバーの ポート転送の停止 をクリックします。

  • ポート転送セッションを再開するには、それを右クリックして ポート転送を再開する を選択するか、ツールバーの ポート転送の停止 をクリックします。

秘密を作成する

PhpStorm を使うと、Kubernetes Secrets をすばやく作成できます。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. クラスターを選択し、 構成 を展開します。

  3. シークレット ノードを右クリックし、 新規シークレットの作成 を選択します。 または、 シークレット ノードを選択し、ツールバーの ブックマークに追加 をクリックします。

  4. 開いた 新規シークレットの作成 ウィンドウで、シークレットの名前、タイプ、名前空間を指定します。 シークレット作成を高速化するため、PhpStorm は選択された シークレットタイプに応じて必要なデータやアノテーションキーを追加します。

  5. データ および アノテーション セクションで、 値 をクリックして既存のキーの値を入力するか、 アイコンを追加 をクリックして値を指定する方法を選択します。

    • 手動で追加 を使用して値を手動で入力します。

    • ファイルデータの使用 を使用してファイル (たとえば、SSH 鍵ファイルまたは Docker config.json ) を選択し、ファイルの内容を値として使用します。

    新しいシークレットウィンドウを作成する

すべてのシークレットは、 サービス ツールウィンドウの 構成 に表示できます。 シークレットを編集するには、シークレットを右クリックして シークレットを編集 を選択するか、ツールバーの をクリックします。

Secret が作成されると、Pod 構成ファイルの secretName フィールドにその名前を入力できるようになります。 これにより、クラスターまたはプロジェクトで使用可能な Secret 名の補完が呼び出されます。

YAML ファイルでシークレット参照時、PhpStorm はシークレット値の確認・再利用に役立つアクションを備えた インレイヒントを提供します。

  • 表示: 参照されたシークレットのデコードされた値をポップアップに表示します。

  • コピー: デコードされた秘密の値を一時的に使用するためにクリップボードにコピーします。

Kubernetes の秘密を暴露しコピーするためのインレイヒント

どちらのアクションも、YAML でエンコードされたテキストやプレースホルダーテキストではなく、シークレットで定義された実際の値にアクセスして表示します。

アカウントに十分な権限がない場合、ボタンをクリックすると対応するツールチップが表示されます。 これにより、制限されたデータが誤って公開されることを防ぎます。

クラスター情報を最新の状態に保つ

PhpStorm をクラスターと同期させるには、次のアクションを使用します：

  • 構成の再読み込みを実行して kubeconfig ファイルの最新内容を取得してください。

  • リソースのリフレッシュを使用すると、Kubernetes リソースの最新の変更を取得できます。 必要な権限があれば、通常は自動的に実行されます。

構成の再ロード

デフォルトでは、kubeconfig ファイルを変更すると、構成は自動的に再読み込みされます。 手動で再読み込みすることもできます。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. クラスターを右クリックし、 詳細 | 構成の再ロード を選択します。

自動再ロードを無効にする場合は、 構成を自動的に再ロード オプションをクリアします。

この設定は、 ビルド、実行、デプロイ | Kubernetes | 構成を自動的に再ロード の IDE 設定 (Ctrl+Alt+S) でも確認できます。

クラスターリソースを手動でリフレッシュする

クラスターに接続している場合、そのリソースに加えた変更は IDE に自動的に反映されます。 リソースが自動的にリフレッシュされない場合 (クラスターロール(英語)の権限が不足しているため)、 サービス ツールウィンドウに自動リフレッシュが禁止されていることを示すメッセージが表示されます。 この場合、リソースを手動でリフレッシュできます。

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. リソースグループを右クリックして リフレッシュ を選択するか、 Ctrl+F5 をクリックします。

ログを表示

PhpStorm を使えば、クラスターのログや選択リソースのログを表示できます。 ログメッセージ内の日付、ソース、特定の値でフィルター処理できます。

エディターでリソースログを開く

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. 次のいずれかの方法でログソースを選択します：

    • すべてのリソースのログを表示するには、Kubernetes クラスターを選択し、 サービス ツールウィンドウのツールバーで ログ追跡アイコン (ログの追跡) をクリックします。

      ログを表示

    • 特定のリソースのログを表示するには、リソースを選択し、 サービス ツールウィンドウのツールバーで ログ追跡アイコン (ログの追跡) をクリックします。 または、リソースを右クリックして ログの追跡 を選択します。

      pod に複数のコンテナーが存在する場合は、表示されるコンテナーのリストからログを追跡したいコンテナーを選択します。

      ログを表示

これにより、選択したリソースのライブテールログが --follow=true フラグ付きで表示され、新しいエディタータグで開きます。

ログを管理する

クラスターログまたは選択したリソースのログを表示する際は、メインツールバー（1）またはフローティングツールバー（2）を使用してログ出力を操作できます。 フローティングツールバーを使用すると、頻繁に使用するアクションにすばやくアクセスできます。

Kubernetes ログの表示

  • Scroll to End icon (末尾までスクロール): ログ出力の末尾に移動します。

  • Soft-Wrap icon (ソフトラップ): エディターのサイズが変更されたときに、ログエントリのソフトラッピングを有効にします。

  • ログダウンロードアイコン (フィルターされたログのダウンロード): 適用されているフィルターを考慮して、エディターで現在開いているログをダウンロードします。

  • Clear Logs icon (表示されたログをクリアする): エディターに表示されているログエントリをクリアします。 このアクションは現在のビューにのみ影響します。 同じリソースのログを再度開くと、エントリが再表示されます。

ログをフィルタリングする

ログを開いたら、エディターの上部にある次のフィルターを使用してログリストを絞り込むことができます。

  • (オープンパターンマッチング): ログデータと一致させる値またはパターンを入力または選択します。 例: ログにレベル情報が存在する場合は、 warn、 error 、またはその他のレベル値を選択して、これらのレベルに対応するログのみを表示できます。

  • (ログソースを選択): ログを表示するクラスターリソースを選択します。

  • (日付と時刻でフィルター): ログを表示する時間範囲を選択します。

  • (ログフィールドを選択): ログのタイムスタンプ、ソース、メッセージを表示するかどうかを選択します。

  • エディタータブの上部にある入力フィールドに、ログメッセージの値を入力します。 正規表現を使用するには をクリックし、大文字と小文字を区別して検索するには をクリックします。

    • ログをフィルタリングする

  • (すべてのログフィルターをクリア): 適用されたすべてのフィルター (ソースを除く) を破棄し、すべてのログを表示します。

単一のコンテナーのログをダウンロードする

  1. Servicesツールウィンドウを開きます。 表示 | Tool Windows | サービス​ を選択、または Alt+8 を押します。

  2. リソースを選択し、右側のツールバーの ログダウンロードアイコン (ログのダウンロード) をクリックして、ログファイルを保存します。

ログ保存オプションを設定する

ログ保存オプションは、 ビルド、実行、デプロイ | Kubernetes | ログ の IDE 設定 (Ctrl+Alt+S) で設定できます。

  • スクラッチ以外の場所にログを保存する場合は、 ログをダウンロードするパス にディレクトリを指定します。 または、 ダウンロードする前にログの保存場所を確認する を選択すると、ログを保存するたびに場所の入力を求められます。

  • ファイル名にログのタイムスタンプを含める場合は、 ログファイル名にタイムスタンプを付加する を選択します。

    カスタムリソース定義のサポート

    Kubernetes クラスターを カスタムリソースで拡張した場合、PhpStorm で カスタムリソース定義 （CRD）仕様を使って検証できます。

    CRD 仕様へのパスを指定する

    1. Ctrl+Alt+S を押して設定を開き、 言語 & フレームワーク | Kubernetes を選択します。

    2. 追加ボタン をクリックしてローカルの CRD ファイルを選択するか URL を指定します。 次に OK をクリックします。

    CRD ファイル一覧を並べ替えるには 上ボタン と 下ボタン を使います。 これは競合定義時の優先順位を定義します。複数ファイルに定義がある場合、PhpStorm は最も順位が低いものを採用します。

    デフォルトでは、CRD は現在のプロジェクトにのみ適用されます。 この IDE インスタンスで開くプロジェクトで特定の CRD を使用できるようにする場合は、 スコープ: オプションを IDEA に変更します。

    実行中の Kubernetes クラスターから CRD を読み込むには、 可能な場合にアクティブなクラスターの API スキーマを使用 を有効にします。

    サービスツールウィンドウの Kubernetes ノードに、現在のクラスターの CRD（適用されているすべてのリソースを含む）を表示できます。

    Kubernetes プラグインは、次のタイプの CRD ファイルをサポートしています：

    YAML の CustomResourceDefinition ファイル

    次の例は、 CronTab 種類のカスタムリソース stable.example.com/v1 用のシンプルな CustomResourceDefinition 仕様を示します。 リソースを識別するための必須フィールドは metadata.name、 spec.group、 spec.versions、 spec.names です。

    apiVersion: apiextensions.k8s.io/v1beta1 kind: CustomResourceDefinition metadata: name: crontabs.stable.example.com # Obligatory field to identify the resource spec: group: stable.example.com # Obligatory field to identify the resource versions: # Obligatory field to identify the resource - name: v1 served: true storage: true scope: Namespaced names: # Obligatory field to identify the resource plural: crontabs singular: crontab kind: CronTab shortNames: - ct validation: openAPIV3Schema: # Schema for validating custom objects properties: spec: properties: cronSpec: type: string pattern: '^(\d+|\*)(/\d+)?(\s+(\d+|\*)(/\d+)?){4}$' # not supported for validation replicas: type: integer minimum: 1 # not supported for validation maximum: 10 # not supported for validation

    JSON での OpenAPI v2.0 スキーマ

    次の例は、 Config 種類のカスタムリソース sample/v1 の CRD 仕様を含んだシンプルな OpenAPI v2.0 スキーマを示します。 カスタムリソースのルート定義には、指定されたグループ、バージョン、種類を持つ x-kubernetes-group-version-kind フィールドを含める必要があります。 この例では、 root.Definition オブジェクトは build プロパティを使用して some.Definition オブジェクトを参照しています。

    { "swagger": "2.0", "info": { "title": "Sample Schema", "version": "sample/v1" }, "paths": {}, "definitions": { "some.Definition": { "description": "Example of a definition.", "properties": { "someProperty": { "type": "string" } } }, "root.Definition": { "description": "This is the root definition for the resource", "properties": { "build": { "$ref": "#/definitions/some.Definition" } }, "x-kubernetes-group-version-kind": [ { "group": "sample", "kind": "Config", "version": "v1" } ] } } }

    CRD 検証の制限

    PhpStorm は次の OpenAPI v3 スキーマ機能をサポートしていません：

    • multipleOf

    • maximum

    • exclusiveMaximum

    • minimum

    • exclusiveMinimum

    • maxLength

    • minLength

    • パターン

    • maxItems

    • minItems

    • uniqueItems

    • maxProperties

    • minProperties

    • allOf

    • oneOf

    • anyOf

    • not

    • フォーマット

    • デフォルト

    • nullable

    • readOnly

    • writeOnly

    • xml

    • externalDocs

    • example

    • deprecated

    生産性のヒント

    ここに記載された機能を頻繁に使う場合、次のヒントが役立つかもしれません：

    ショートカットの割り当て

    Kubernetes アクションにキーボードショートカットを割り当て可能です。

    1. 設定 ダイアログ (Ctrl+Alt+S) で、 キーマップ を選択します。

    2. 検索フィールドに kubernetes と入力してから、アクションをダブルクリックしてショートカットを設定します。

    または、 アクションの検索 ダイアログ Ctrl+Shift+A を使用して、必要なアクションを入力し、 Alt+Enter を押すこともできます。

    例: クラスターとの対話 にショートカットを割り当てて、リソース構成ファイルの 変更中にコンテキストメニューをすばやく開くことができます。

    コードの折りたたみを構成する

    デフォルトでは、PhpStorm は コード折りたたみを使い、Helm テンプレートや Kubernetes 構成ファイルの値参照や定義を実際の値として表示します。 値をクリックして展開するか、 Ctrl+NumPad + と Ctrl+NumPad - を押して折りたたみを切り替えることができます。 参照と定義がデフォルトで展開されていることを確認するには、次のようにします。

    1. 設定 ダイアログ (Ctrl+Alt+S) で、 エディター | 一般 | コードの折りたたみ を選択します。

    2. コードの折りたたみ ページで、必要なチェックボックスをオフにします。

      • Kubernetes: Helm テンプレート内の値参照

      • Kubernetes: YAML ファイル内の EnvVar 定義

      • Kubernetes: YAML ファイル内の ExecAction 定義

    2026 年 5 月 22 日
    WSL​ Helm