Kubernetes

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

Kubernetes リソース設定ファイル(英語)のコーディング支援。
Helm(英語) チャートとテンプレートのコーディング支援。詳細については、 Helm 専用ページを参照してください。
カスタムリソース定義（CRD）仕様を使用したカスタムリソースの検証。
カスタマイズする(英語)ファイルのコーディング支援: フィールドおよびローカルファイルパスの補完、クイックドキュメント、Kustomize ファイルとパッチ間のナビゲーション。関連する Kustomize ファイルのリストは、開いている Kustomize パッチの上部にあるエディターに表示されます。
PhpStorm からクラスターとやり取りするには、サービスツールウィンドウを使い、Kubernetes クラスターのすべてのリソースの表示、関連リソース定義へのジャンプ、pods 上で実行中のコンテナーのログ表示などが行えます。

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

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

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

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
Marketplace タブを開き、 Kubernetes プラグインを見つけて、インストールするをクリックします (プロンプトが表示されたら、IDE を再起動します)。

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

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

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

設定ダイアログ（Ctrl+Alt+S ）で、ビルド、実行、デプロイ | Kubernetes を選択します。
kubectl 実行可能ファイルへのパスフィールドに、kubectl 実行可能ファイルへのパスを指定します。
テストをクリックしてファイルの場所を確認してください。見つからない場合は、ファイルの場所を手動で確認するか、インストールするをクリックすると、PhpStorm が不足しているソフトウェアをダウンロードしてインストールします。

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

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

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

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

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

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

設定ダイアログ (Ctrl+Alt+S) で、ビルド、実行、デプロイ | Kubernetes を選択します。
必要に応じて、 Kubernetes API バージョンオプションを更新します。

リソース構成ファイル

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

サポートされている機能

機能	YAML	JSON
自動補完	サポート	サポート
クイックドキュメント	サポート	サポート
インスペクションとクイックフィックス	無効なキー、不足しているキー、重複したキー編集不可能な（読み取り専用の）キーとリソース廃止予定のキーとリソース整数値と列挙型キーの値が無効です	無効なプロパティ、不足しているプロパティ、重複したプロパティ
ライブテンプレート	一般的なリソースタイプの定義済みテンプレート	定義済みライブテンプレートなし
スマート補完	サポート	未サポート
カスタムリソース定義	サポート	未サポート
ラベル定義とセレクタ	ガターアイコンを使用したナビゲーション、使用箇所の検索、名前の変更	未サポート
オリジナルの Kubernetes モデルの強化	該当する場合はプレーン文字列の代わりに列挙型	なし

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

apiVersion: オブジェクト表現のバージョン管理されたスキーマを識別する
kind: リソースタイプを識別します (たとえば、 サービス、 Pod、 Deployment などです。)

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

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

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

プロジェクトツールウィンドウ（Alt+1 ）で、フォルダーを右クリックし、新規を選択するか、 Alt+Insert を押してから、 Kubernetes リソースを選択します。
命名フィールドにリソース名を入力し、リストからファイルテンプレートを選択します。
これにより、選択したファイルテンプレートに基づく内容で新規ファイルが作成されます。

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

kconfigmap: Kubernetes ConfigMap
kcronjob: Kubernetes CronJob
kdeployment: Kubernetes デプロイ
kingress: Kubernetes Ingress
kpod: Kubernetes Pod
kresource: Kubernetes リソースをゼロから構築
kservice: Kubernetes サービス

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

フローティングツールバーでは、以下のことが可能です。
- 現在のクラスターと名前空間を選択します
- 変更を適用し、現在のクラスターに配信します
- リソースを削除する
- クラスターバージョンとの変更点を比較する
- クラスターからコンテンツを再読み込みします
デプロイされたリソースのステータスを確認するためのインレイヒント
参照されたシークレット値の開示・コピーを行うためのインレイヒント
ポートを転送するためのインレイヒント

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

Ctrl+Alt+S を押して設定を開き、ビルド、実行、デプロイ | Kubernetes を選択します。
エディターにフローティングツールバーを表示するオプションを使用して、フローティングツールバーがいつ表示されるかを選択します。
- 常に
- マウス移動時
- 表示しない
または、フローティングツールバーを右クリックして必要なオプションを選択することもできます。

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

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

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

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

クラスターを管理する

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

コンテキストの追加

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
サービスツールウィンドウで Kubernetes ノードを右クリックし、クラスターの追加を選択します。または、をクリックして Kubernetes | コンテキストの追加を選択します。
次に、追加する Kubernetes クラスターのソースを選択します：
- デフォルトディレクトリから: デフォルトの場所 (通常は $HOME/.kube/config) からクラスターを取得します。
- カスタム kubeconfigs から: コンピューターから任意の kubeconfig ファイルを選択します。
- kubeconfig の内容を貼り付け: 開いたテキストエリアに kubeconfig のコンテンツを貼り付けます。
開いたクラスターの追加ウィンドウで、追加するクラスターを選択し、クラスターの追加をクリックします。

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

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

クラスターに接続する

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
サービスツールウィンドウにクラスターがない場合は、クラスターを追加します。
クラスターを右クリックし、クラスターを接続を選択します。

kubeconfig の編集

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
クラスターを選択し、ツールバーの (エディターで kubeconfig ファイルを開く) をクリックします。このアクションは、サービスツールウィンドウで任意の Kubernetes オブジェクトを右クリックした場合にも使用できます。
これにより、エディターの新しいタブで kubeconfig ファイルが開きます。このアクションによって開かれるデフォルトのファイルを変更するには、 kubeconfig ファイルへのパスで別のファイルへのパスを指定できます。

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

名前空間を切り替える

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
クラスターまたは任意のリソースを右クリックし、名前空間を選択し (またはツールバーのをクリックし)、必要な名前空間を選択します。
すべての名前空間のリソースを表示するには、すべての名前空間を選択します。

現在のクラスターを選択

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

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
クラスターを右クリックし、クラスターを現在のクラスターとして設定を選択します。
または、クラスターを選択し、ツールバーのをクリックします。

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

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

必要なリソースファイルをエディターで開きます。現在のクラスターが設定されていない場合は、フローティングツールバーを使用して選択してください。
必要に応じて、リストから名前空間を選択することもできます。
現在のクラスターと名前空間に変更を適用するには、をクリックします。

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
リソースを右クリックし、 YAML の表示を選択します。
選択したリソースのマニフェストがエディターの新しいタブで開きます。フィールドを変更すると、変更された行がガターでハイライト表示されます。ガターのハイライト領域をクリックすると、変更内容をすぐにプレビューしたり、ロールバックしたりできます。
フローティングツールバーで現在のクラスターを選択済みか確認し、をクリックして変更を適用してください。
Kubernetes オブジェクトの一部フィールドを変更すると、新しいオブジェクトが作成される場合があります。例: リソース名を変更した場合、この変更を適用すると新しいリソースが作成されます。また、名前空間を変更した場合、この変更を適用すると、指定された名前空間に新しいリソースが作成されます。

リソースの詳細を表示

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

サービスツールウィンドウで、リソースを選択して詳細を表示します。
PhpStorm は、デプロイ済み Kubernetes リソースのライブステータスをエディターに直接表示します。例: デプロイマニフェストを開くと、 replicas フィールドの横にステータスインジケーターが表示され、現在実行中、保留中、失敗している pods の数が表示されます。
個々の pods およびジョブのステータスは、それぞれのマニフェストの name フィールドの横で確認できます。
エラーが発生しリソースが失敗した場合、PhpStorm はログを開くリンクを表示し、関連するエラー内容のログエントリへすぐ移動できます。

リソースの削除

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

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

ポートの転送

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

次のいずれかの方法でポート転送を設定できます。
- Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押してください。ターゲット pod を右クリックしてポートの転送を選択します。
- Kubernetes マニフェストでポートの転送インレイヒントをクリックします。宛先ポートが指定されている場合 (例: containerPort の値として)、PhpStorm はインレイヒントを表示します。
ポートの転送ダイアログで:
- 住所フィールドに、リッスンするアドレスをリストします。複数の値を入力する場合は、コンマで区切ってください。
- ポートフィールドでは、 <local port>:<remote port> 形式でポートを指定します。例: 8888:5000 はローカルポート 8888 をリッスンし、リモートポート 5000 との間でデータを転送します。
  PhpStorm は対応する Kubernetes マニフェストの値に基づき、ポートマッピングを自動提案します。マニフェストで既にローカルマシンで使用中のポートが指定された場合、PhpStorm は使用可能なポートが見つかるまで提案値を順次増やします。
  指定された値が 1024 より小さい場合、推奨されるローカルポート値に 8000 が追加されます。
  今現在ビジーなローカルポートを手動で指定すると、転送開始前に PhpStorm から通知されます。
進むをクリックしてください。

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

すべてのアクティブなポート転送セッションを表示するには、サービスツールウィンドウで、Kubernetes クラスターのネットワーク | ポート転送を展開します。
各ポート転送セッションの横に、PhpStorm が現在の状態を示すバッジを表示します。
ポート転送セッションを終了するには、それを右クリックしてポート転送を停止するを選択するか、ツールバーのをクリックします。
ポート転送セッションを再開するには、それを右クリックしてポート転送を再開するを選択するか、ツールバーのをクリックします。

秘密を作成する

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
クラスターを選択し、構成を展開します。
シークレットノードを右クリックし、新規シークレットの作成を選択します。または、シークレットノードを選択し、ツールバーのをクリックします。
開いた新規シークレットの作成ウィンドウで、シークレットの名前、タイプ、名前空間を指定します。シークレット作成を高速化するため、PhpStorm は選択されたシークレットタイプに応じて必要なデータやアノテーションキーを追加します。
データおよびアノテーションセクションで、値をクリックして既存のキーの値を入力するか、をクリックして値を指定する方法を選択します。
- 手動で追加を使用して値を手動で入力します。
- ファイルデータの使用を使用してファイル (たとえば、SSH 鍵ファイルまたは Docker config.json ) を選択し、ファイルの内容を値として使用します。

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

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

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

表示: 参照されたシークレットのデコードされた値をポップアップに表示します。
コピー: デコードされた秘密の値を一時的に使用するためにクリップボードにコピーします。

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

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

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

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

構成の再読み込みを実行して kubeconfig ファイルの最新内容を取得してください。
リソースのリフレッシュを使用すると、Kubernetes リソースの最新の変更を取得できます。必要な権限があれば、通常は自動的に実行されます。

構成の再ロード

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
クラスターを右クリックし、詳細 | 構成の再ロードを選択します。

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

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

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

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
リソースグループを右クリックしてリフレッシュを選択するか、 Ctrl+F5 をクリックします。

ログを表示

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

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
次のいずれかの方法でログソースを選択します：
- すべてのリソースのログを表示するには、Kubernetes クラスターを選択し、サービスツールウィンドウのツールバーで (ログの追跡) をクリックします。
- 特定のリソースのログを表示するには、リソースを選択し、サービスツールウィンドウのツールバーで (ログの追跡) をクリックします。または、リソースを右クリックしてログの追跡を選択します。
  pod に複数のコンテナーが存在する場合は、表示されるコンテナーのリストからログを追跡したいコンテナーを選択します。

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

ログを管理する

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

(末尾までスクロール): ログ出力の末尾に移動します。
(ソフトラップ): エディターのサイズが変更されたときに、ログエントリのソフトラッピングを有効にします。
(フィルターされたログのダウンロード): 適用されているフィルターを考慮して、エディターで現在開いているログをダウンロードします。
(表示されたログをクリアする): エディターに表示されているログエントリをクリアします。このアクションは現在のビューにのみ影響します。同じリソースのログを再度開くと、エントリが再表示されます。

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

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

(オープンパターンマッチング): ログデータと一致させる値またはパターンを入力または選択します。例: ログにレベル情報が存在する場合は、 warn、 error 、またはその他のレベル値を選択して、これらのレベルに対応するログのみを表示できます。
(ログソースを選択): ログを表示するクラスターリソースを選択します。
(日付と時刻でフィルター): ログを表示する時間範囲を選択します。
(ログフィールドを選択): ログのタイムスタンプ、ソース、メッセージを表示するかどうかを選択します。
ビルド、実行、デプロイ | Kubernetes | ログ | デフォルトのログフィールドの IDE 設定 (Ctrl+Alt+S) で、ログフィールドの可視性をグローバルに構成できます。
エディタータブの上部にある入力フィールドに、ログメッセージの値を入力します。正規表現を使用するにはをクリックし、大文字と小文字を区別して検索するにはをクリックします。

(すべてのログフィルターをクリア): 適用されたすべてのフィルター (ソースを除く) を破棄し、すべてのログを表示します。
ログエントリーに対して正規表現ベースのハイライトルールを定義することで、エラー、警告、情報イベントなどの重要なメッセージを特定し区別できます。 IDE 設定 (Ctrl+Alt+S) のビルド、実行、デプロイ | Kubernetes | ログで、フィルターテーブルを使ってルールを作成・管理できます。各フィルターごとに正規表現パターンを指定し、太字、斜体、有効化や色の選択で見た目をカスタマイズできます。

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

Servicesツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択、または Alt+8 を押します。
リソースを選択し、右側のツールバーの (ログのダウンロード) をクリックして、ログファイルを保存します。

ログオプションを構成する

ログオプションは、IDE 設定（Ctrl+Alt+S ）のビルド、実行、デプロイ | Kubernetes | ログで設定できます：

スクラッチ以外の場所にログを自動保存したい場合は、ログをダウンロードするパスにディレクトリを指定します。または、ダウンロードする前にログの保存場所を確認するを選択すると、ログを保存するたびに場所の指定を求められます。
ファイル名にログのタイムスタンプを含める場合は、ログファイル名にタイムスタンプを付加するを選択します。
Kubernetes ログから ANSI の色やフォーマットコードを削除してプレーンテキストで表示したい場合は、ログから ANSI コードを除去を選択します。
クラスターイベントの出力先オプションを使うと、ログ出力の表示先としてエディターまたはサービスツールウィンドウを選択できます。
デフォルトのログキャッシングサイズは 300 MB です。この上限を超えると、IDE から通知されます。これらの通知のしきい値を変更したい場合は、ログキャッシングが上限を超えたら警告するに希望の値を入力してください。
エディターでのログ更新頻度を調整したい場合は、ログエディターの更新遅延 (ミリ秒) でミリ秒単位の遅延を指定します。

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

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

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

Ctrl+Alt+S を押して設定を開き、ビルド、実行、デプロイ | Kubernetes | スキーマを選択します。
CRD および OpenAPI の仕様テーブルでをクリックし、ローカルの 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
pattern
maxItems
minItems
uniqueItems
maxProperties
minProperties
allOf
oneOf
anyOf
not
format
デフォルト
nullable
readOnly
writeOnly
xml
externalDocs
example
deprecated

生産性のヒント

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

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

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

設定ダイアログ (Ctrl+Alt+S) で、キーマップを選択します。
検索フィールドに kubernetes と入力してから、アクションをダブルクリックしてショートカットを設定します。

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

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

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

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

設定ダイアログ (Ctrl+Alt+S) で、エディター | 一般 | コードの折りたたみを選択します。
コードの折りたたみページで、必要なチェックボックスをオフにします。
- Kubernetes: Helm テンプレート内の値参照
- Kubernetes: YAML ファイル内の EnvVar 定義
- Kubernetes: YAML ファイル内の ExecAction 定義

2026 年 7 月 14 日