ソフトウェア デリバリーの未来を形作るために、2021 年の State of DevOps アンケートに参加して、あなたの声を聞かせてください。

クイックスタート: Cloud Code を使用した Cloud Run サービスのデプロイ

このページでは、Cloud Code の使用を開始する方法について説明します。

サンプル アプリケーションを使用して Cloud Run で実行される Hello World サービスを設定し、サービスを Cloud Run にデプロイして、ライブサービスのリソースのステータスを表示します。

Cloud Code を使用した新しい Cloud Run サービスの作成

このクイックスタートを Apple M シリーズのシリコンで実行する場合、アプリケーションのビルドには Cloud Build が使用されるため、料金が発生する場合があります。詳細については、Apple M シリーズ シリコンに対する Cloud Code のサポートをご覧ください。

始める前に

  1. Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  3. Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する

  4. Cloud Run API を有効にします。

    API を有効にする

Cloud Code のインストール

Cloud Code プラグインをインストールするには、以下の手順を行います。

  1. JetBrains IDE バージョン 2020.2 以降IntelliJ Ultimate/CommunityPyCharm Professional/CommunityWebStormGoLand など)がまだインストールされていない場合は、インストールします。

  2. Apple M シリーズのシリコンで Cloud Code を実行している場合は、M1 Mac への Rosetta のインストールの手順に沿って Rosetta 2 をインストールします。これにより、Cloud Code で kubectl をマネージド依存関係としてインストールできます。Rosetta 2 をインストールしない場合は、マネージド依存関係を無効にし([IntelliJ IDEA] > [設定] > [ツール] > [Cloud Code] > [依存関係])、依存関係のカスタム バージョンで説明されている手順に沿って、kubectl の独自のバージョンの ARM をインストールします。

  3. 依存関係をインストールします。

    • すべての Cloud Platform で、Docker クライアント(Docker レジストリで認証済み)がマシンの PATH にインストールされていることを確認します。(それぞれのフォルダが PATH 内のディレクトリの下に表示されます)。Docker がすでにインストールされているかどうかを確認するには、docker -v を実行します。
    • Cloud Code は、他の必要な依存関係を自動的にインストールします。
  4. IntelliJ IDEA(またはサポートされている JetBrains IDE)を開きます。

  5. プラグイン マーケットプレイス([ファイル] > [設定] > [Plugins]、または Mac OS X の場合は [IntelliJ IDEA] > [設定] > [Plugins])から、Cloud Code プラグインを検索してインストールします。

    このとき、プラグインを有効にするために IDE の再起動を求められることがあります。

サービスの作成

既存のサンプルを使用して新しいサービスを作成するには:

  1. IDE で [ファイル] > [新しいプロジェクト] の順に開き、[Cloud Code: Cloud Run] を選択します。
  2. サンプル アプリケーションのプログラミング言語を選択し、[Next] をクリックします。既存のサンプルアプリのリストからサービスを作成する
  3. プロジェクトに名前を付けて、[Finish] をクリックします。

    Cloud Code によって、サンプル アプリケーションのクローンが作成され、新しく作成したプロジェクトが開かれて、必要な Cloud Run 実行構成が作成されます。

  4. Java サンプル アプリケーションを選択した場合、プロンプトが表示されたら [Load Maven project] をクリックします。

    Maven ビルド スクリプトの検出通知 - [Load Maven Project]、[Skip]、[Help] を選択します

これで、Hello World サービスを実行できるようになりました。Cloud Code がファイル システムの変更を監視するため、ほぼリアルタイムでサービスを編集して再実行できます。

Cloud Run へのサービスのデプロイ

サービスをデプロイするには、次の手順に沿って操作します。

  1. ナビゲーション バーの [Run/Debug configurations] セレクタから、自動的に作成された実行構成の [Cloud Run: Deploy] を選択します。

    このクイックスタートを Apple M シリーズのシリコンで実行する場合、アプリケーションのビルドには Cloud Build が使用されます。Cloud Build の料金については、料金をご覧ください。

  2. [実行] アクションの実行アイコン をクリックします。[設定を編集] ウィンドウが表示されます。

  3. Google Cloud プロジェクト ID を設定します。

  4. デプロイ プラットフォームのリージョンを選択します。

    このクイックスタートでは、デフォルトのプラットフォーム オプションである「Cloud Run(フルマネージド)」を「Deployment Platform」として使用します。

  5. [実行] をクリックします。

  6. 出力ウィンドウに表示された URL を使用して、実行中のサービスを表示します。

  7. 出力ウィンドウに表示されるログ URL に沿って、サービスのステータス(指標、リビジョンの詳細など)を表示することもできます。

    Console でのサービスのステータスの表示

リソースのステータスの表示

実行中のサービス リソースのステータスを表示する方法は次のとおりです。

  1. Cloud Run Explorer に移動します。右側のサイドパネルからアクセスできます。

    右側のパネルでハイライト表示された Cloud Run Explorer タブ

  2. サービスまたはリビジョンのプロパティを表示するには、エクスプローラでサービスまたはリビジョンをクリックします。

    サービスが選択され、そのプロパティが下に表示されている Cloud Run Explorer

  3. リビジョンのログを表示するには、リビジョンを右クリックして [View Cloud Logs] をクリックします。

    リビジョンを右クリックしてログを表示する

クリーンアップ

このクイックスタート用にプロジェクトを作成した場合は、不要な請求が発生しないようにするために削除してください。

  1. Cloud Console の [プロジェクト] ページに移動します。

    プロジェクト ページに移動

  2. このクイックスタート用に作成したプロジェクトを選択し、横にあるゴミ箱アイコンをクリックして削除します。

    プロジェクトがシャットダウンし、プロジェクト削除のスケジュールが決定されます。

既存のプロジェクトを使用していて、このクイックスタート用に作成したリソースを削除する場合は、次の方法で削除できます。

  • コンテナ イメージ: サービスが使用されていない場合、Cloud Run の料金は発生しませんが、コンテナ イメージを Container Registry に保存することで課金される場合があります。 イメージを削除するには、イメージの削除の手順に従います。
  • Cloud Run サービス: Cloud Run サービスを削除するには、ナビゲーション メニューを使用して Console で Cloud Run に移動します。削除するサービスを選択して、ゴミ箱アイコン(削除)をクリックします。

次のステップ

サポートの利用

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