既存のアプリケーションの使用

既存のプロジェクトにすでに Kubernetes マニフェスト、Dockerfile、またはイメージをビルドする Jib が構成されている場合は、それを開いてプラグインで使用できます。追加で構成が必要となるのは Skaffold YAML ファイルのみですが、これは自動で生成されるか、提供されたテンプレートから作成できます。

Skaffold YAML の構成が完了したら、プロジェクト イメージを push しようとしているコンテナ イメージの保存場所を指定してください。

自動プロジェクト ブートストラップ

Cloud Code が既存の Skaffold 構成を検出しない場合、構成の支援を求めるメッセージが表示されます。

  • プロジェクトが Dockerfile を含んでいるか、Jib 用に構成されていて、Buildpacks を使用したビルドが可能で、かつ Kubernetes リソースがある場合は、skaffold.yaml ファイル(存在していない場合)と必要な実行構成を作成するよう Cloud Code から通知されます。

    Cloud Code Kubernetes の実行構成を作成するためのリンクを含む通知

  • この通知をクリックすると、自動的に構成が作成されます(可能な場合)。

    複数のイメージまたはビルダーが検出されたために Skaffold の構成を自動的に作成できない場合、Cloud Code から、検出されたイメージとビルダー間のマッピングの提供を求めるダイアログが表示されます。

    Skaffold 構成で使用するビルド設定を指定する

または、[Add Kubernetes Support] メニュー オプションを使用して Skaffold 構成を設定することもできます。

  • [Tools] > [Cloud Code] > [Kubernetes] に移動し、[Add Kubernetes Support] を選択します。このオプションは、プロジェクトの Kubernetes リソースを分析し、skaffold.yaml ファイル(存在していない場合)と必要な実行構成を生成します。生成された 2 つの実行構成には、Kubernetes でプロジェクトを実行するための構成と、Kubernetes クラスタ上での開発用の構成が含まれています。
  • サポートが追加されたら、新しく追加された実行構成を使用して、Kubernetes でプロジェクトの実行およびデバッグをすぐに開始できます。

Cloud Code Skaffold 構成の手動作成

新しい skaffold.yaml ファイルを手動で作成するか、プロジェクトに既存のファイルを追加することができます。

Skaffold YAML を手動で作成するには、以下の手順に沿ってライブ テンプレートのサポートを利用します。

  • プロジェクトのルート ディレクトリに、skaffold.yaml という名前の新規ファイルを作成します(右クリック > [New]> [File])。
  • 新しいファイル内のカーソルで、Ctrl+Space を使用してライブ テンプレートの候補を表示し、使用する Skaffold テンプレートを選択します。

    Skaffold YAML テンプレートの使用

  • イメージ フィールドにプロジェクトのイメージ名を入力します。マニフェスト フィールドには、IDE からデプロイしようとする Kubernetes リソースのリストを入力します。

    Dockerfile ベースのビルドの例:

    build:
      artifacts:
        - image: image_name
    deploy:
      kubectl:
        manifests:
          - k8s/web.yaml
          - k8s/backend.yaml
    

    Jib プラグインを使用した、Java Maven / Gradle プロジェクトのビルド セクションの例(deploy セクションも同様):

    build:
    artifacts:
    - image: image_name
      jib: {}
    

    コンテキストごとに異なるビルド、テスト、デプロイの構成を定義する場合は、異なるプロファイルを設定できます。Cloud Build でイメージをビルドするように Cloud Code を構成する Cloud Build プロファイルの例:

    profiles:
    # use the cloudbuild profile to build images using Google Cloud Build
    - name: cloudbuild
      build:
        googleCloudBuild: {}
    
  • skaffold.yaml が有効になると、Kubernetes 実行ターゲットを自動作成するようプラグインから求められます。

    Kubernetes 実行ターゲット通知の作成

コンテナ イメージの保存場所の指定

コンテナ イメージ ストレージ

アプリケーションをデプロイする前に、プロジェクトで使用するデフォルトのイメージ リポジトリを定義する必要があります。

デフォルトでは、プロジェクトは Kubernetes マニフェストで指定されたイメージ名を使用するように構成されています。このイメージ指定をカスタマイズすることもできます。任意のリポジトリ(Google Container RegistryDockerHub、非公開リポジトリなど)の設定が完了したら、実行ターゲットを編集して、実行ターゲットの設定でデフォルトのイメージ リポジトリとして指定します。Google Container Registry イメージでは、このフィールドには Container Registry リポジトリをすばやく見つけるためのオートコンプリート機能があります。

これには、[Run/Debug configurations] ダイアログ上部のタスクバーから [構成の編集] をクリックします。次に、[Kubernetes で開発] > [コンテナ イメージの保存場所] の順にクリックします。

実行構成のデフォルトのイメージ リポジトリが「gcr.io/」形式で設定され、現在のプロジェクトとアクティブなクラスタに基づいてオートコンプリート オプションが表示される。

コンテナ イメージの設定を指定する方法については、コンテナ イメージの設定の構成ガイドをご覧ください。

ビルド設定

コンテナ イメージを設定したら、ビルド設定を構成できます。Cloud Code は、Docker、Jib、Buildpacks のアーティファクト タイプをサポートしています。

[Run configuration] 設定の [Build/Deploy] タブで、[Edit Configurations...] をクリックします。次に、[Develop on Kubernetes] または [Run on Kubernetes] を選択すると、デフォルト プロファイルのビルド設定を構成できます。

[Build/Deploy] タブに表示されるビルド設定

イメージのビルド設定の指定について詳しくは、コンテナ イメージのビルド設定の構成ガイドをご覧ください。

サポートの利用

フィードバックを送信するには、GitHub で問題を報告するか、Stack Overflow で質問します。