このページでは、Cloud Code の使用を開始する方法について説明します。
サンプル アプリケーションを使用して Cloud Run で実行される Hello World サービスを設定し、サービスを Cloud Run にデプロイして、ライブサービスのリソースのステータスを表示します。
このクイックスタートを Apple M シリーズのシリコンで実行する場合、アプリケーションのビルドには Cloud Build が使用されるため、料金が発生する場合があります。詳細については、Apple M シリーズ シリコンに対する Cloud Code のサポートをご覧ください。
始める前に
- Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。
- Cloud Run API を有効にします。
Cloud Code のインストール
Cloud Code プラグインをインストールするには、以下の手順を行います。
JetBrains IDE バージョン 2020.2 以降（IntelliJ Ultimate/Community、PyCharm Professional/Community、WebStorm、GoLand など）がまだインストールされていない場合は、インストールします。
Apple M シリーズのシリコンで Cloud Code を実行している場合は、M1 Mac への Rosetta のインストールの手順に沿って Rosetta 2 をインストールします。これにより、Cloud Code で kubectl をマネージド依存関係としてインストールできます。Rosetta 2 をインストールしない場合は、マネージド依存関係を無効にし（[IntelliJ IDEA] > [設定] > [ツール] > [Cloud Code] > [依存関係]）、依存関係のカスタム バージョンで説明されている手順に沿って、kubectl の独自のバージョンの ARM をインストールします。
依存関係をインストールします。
- すべての Cloud Platform で、Docker クライアント（Docker レジストリで認証済み）がマシンの
PATHにインストールされていることを確認します。（それぞれのフォルダがPATH内のディレクトリの下に表示されます）。Docker がすでにインストールされているかどうかを確認するには、docker -vを実行します。 - Cloud Code は、他の必要な依存関係を自動的にインストールします。
- すべての Cloud Platform で、Docker クライアント（Docker レジストリで認証済み）がマシンの
IntelliJ IDEA（またはサポートされている JetBrains IDE）を開きます。
プラグイン マーケットプレイス（[ファイル] > [設定] > [Plugins]、または Mac OS X の場合は [IntelliJ IDEA] > [設定] > [Plugins]）から、Cloud Code プラグインを検索してインストールします。
このとき、プラグインを有効にするために IDE の再起動を求められることがあります。
サービスの作成
既存のサンプルを使用して新しいサービスを作成するには:
- IDE で [ファイル] > [新しいプロジェクト] の順に開き、[Cloud Code: Cloud Run] を選択します。
- サンプル アプリケーションのプログラミング言語を選択し、[Next] をクリックします。
プロジェクトに名前を付けて、[Finish] をクリックします。
Cloud Code によって、サンプル アプリケーションのクローンが作成され、新しく作成したプロジェクトが開かれて、必要な Cloud Run 実行構成が作成されます。
Java サンプル アプリケーションを選択した場合、プロンプトが表示されたら [Load Maven project] をクリックします。
![Maven ビルド スクリプトの検出通知 - [Load Maven Project]、[Skip]、[Help] を選択します](https://cloud.google.com/code/docs/intellij/images/mavensync.png?hl=ja)
これで、Hello World サービスを実行できるようになりました。Cloud Code がファイル システムの変更を監視するため、ほぼリアルタイムでサービスを編集して再実行できます。
Cloud Run へのサービスのデプロイ
サービスをデプロイするには、次の手順に沿って操作します。
ナビゲーション バーの [Run/Debug configurations] セレクタから、自動的に作成された実行構成の [Cloud Run: Deploy] を選択します。
このクイックスタートを Apple M シリーズのシリコンで実行する場合、アプリケーションのビルドには Cloud Build が使用されます。Cloud Build の料金については、料金をご覧ください。
[実行]
をクリックします。[設定を編集] ウィンドウが表示されます。Google Cloud プロジェクト ID を設定します。
デプロイ プラットフォームのリージョンを選択します。
このクイックスタートでは、デフォルトのプラットフォーム オプションである「Cloud Run（フルマネージド）」を「Deployment Platform」として使用します。
[実行] をクリックします。
出力ウィンドウに表示された URL を使用して、実行中のサービスを表示します。
出力ウィンドウに表示されるログ URL に沿って、サービスのステータス（指標、リビジョンの詳細など）を表示することもできます。
リソースのステータスの表示
実行中のサービス リソースのステータスを表示する方法は次のとおりです。
Cloud Run Explorer に移動します。右側のサイドパネルからアクセスできます。
サービスまたはリビジョンのプロパティを表示するには、エクスプローラでサービスまたはリビジョンをクリックします。
リビジョンのログを表示するには、リビジョンを右クリックして [View Cloud Logs] をクリックします。
クリーンアップ
このクイックスタート用にプロジェクトを作成した場合は、不要な請求が発生しないようにするために削除してください。
Cloud Console の [プロジェクト] ページに移動します。
このクイックスタート用に作成したプロジェクトを選択し、横にあるゴミ箱アイコンをクリックして削除します。
プロジェクトがシャットダウンし、プロジェクト削除のスケジュールが決定されます。
既存のプロジェクトを使用していて、このクイックスタート用に作成したリソースを削除する場合は、次の方法で削除できます。
- コンテナ イメージ: サービスが使用されていない場合、Cloud Run の料金は発生しませんが、コンテナ イメージを Container Registry に保存することで課金される場合があります。 イメージを削除するには、イメージの削除の手順に従います。
- Cloud Run サービス: Cloud Run サービスを削除するには、ナビゲーション メニューを使用して Console で Cloud Run に移動します。削除するサービスを選択して、ゴミ箱アイコン（削除）をクリックします。
次のステップ
- プロジェクトに Google Cloud APIs とクライアント ライブラリを追加する。
- 詳細設定で実行構成をカスタマイズする。
- Cloud Code を使用して Kubernetes アプリケーションを作成して実行してみる。