クイックスタート: Cloud Run for Anthos にデプロイする

Cloud Run for Anthos 対応のクラスタを作成し、ビルド済みサンプル コンテナをそのクラスタにデプロイする方法について説明します。

デモ用のアカウントをお持ちの場合は、Google Cloud Skills Boost のクイックスタートを使用できます。

始める前に

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

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

  3. Google Cloud プロジェクトで課金が有効になっていることを確認します

  4. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

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

  5. Google Cloud プロジェクトで課金が有効になっていることを確認します

  6. Google Cloud CLI の最新バージョンを使用するため、Google Cloud CLI をインストールまたは更新します。

コマンドライン環境を設定して必要な API を有効にする

次の手順を行い、Cloud Run for Anthos のコマンドライン環境を設定して必要な API を有効にします。

  1. デフォルトで Google Cloud プロジェクトの ID を使用するように Google Cloud CLI を構成します。

    gcloud config set project PROJECT-ID

    PROJECT-ID はプロジェクトの ID に置き換えます。

  2. 新しいクラスタをデプロイするゾーンを設定します。GKE がサポートされている任意のゾーンを使用できます。例:

    gcloud config set compute/zone ZONE

    ZONE は、目的のゾーンに置き換えます。

  3. gcloud services コマンドを実行して、Google Cloud プロジェクトで次の API を有効にします。

    • Google Kubernetes Engine API: GKE クラスタを作成します。
    • Cloud Build API: コンテナをビルドします。
    • Container Registry API: コンテナを Container Registry に公開します。
    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com

    完了までに数秒かかることがあります。API が有効になると、コマンドラインに次のようなメッセージが表示されます。

    Operation "operations/..." finished successfully.

Cloud Run for Anthos を有効にした GKE クラスタを作成する

次の手順でクラスタを作成し、Cloud Run for Anthos で有効にします。

  1. 次のコマンドで新しいクラスタを作成します。

    gcloud container clusters create CLUSTER_NAME \
      --addons=HttpLoadBalancing,CloudRun \
      --machine-type=e2-standard-4 \
      --num-nodes=4 \
      --enable-stackdriver-kubernetes

    CLUSTER_NAME は、クラスタに付ける名前で置き換えます。

  2. クラスタの作成が完了するまで待機します。作成プロセス中に、次のようなメッセージが表示されます。

    Creating cluster my-cluster...done.
    Created [https://container.googleapis.com/v1beta1/ \
    projects/my-project/zones/us-central1-b/clusters/my-cluster].
    

    ここで、my-project は Google Cloud プロジェクトの ID、my-cluster は作成したクラスタです。

  3. Cloud Run for Anthos リソースの gcloud デフォルトに新しいクラスタとそのロケーションを設定します。これらのデフォルト値を設定すると、Google Cloud CLI を使用するたびに値を指定する必要がなくなります。

    gcloud config set run/platform gke
    gcloud config set run/cluster CLUSTER_NAME
    gcloud config set run/cluster_location ZONE

    CLUSTER_NAMEZONE は、新しいクラスタの作成で使用した値に置き換えます。

サンプル コンテナをデプロイする

Google Cloud コンソールを使用してサンプル コンテナをデプロイし、クラスタにサービスを作成します。

  1. Google Cloud コンソールで、Cloud Run for Anthos のページに移動します。

    Cloud Run for Anthos に移動

  2. [サービスを作成] をクリックして、[サービスの作成] フォームを開きます。

  3. [使用可能なクラスタ] プルダウン メニューで、先ほど作成したクラスタを選択します。

  4. 名前空間の名前として「default」を入力します。

  5. サービス アカウント名を入力します(たとえば、hello)。

  6. [次へ] をクリックします。

  7. [既存のコンテナ イメージから 1 つのリビジョンをデプロイする] を選択し、デモコンテナのプルダウンから [hello] を選択します。

  8. [次へ] をクリックします。

  9. [接続] で [外部] を選択します。これにより、サービスを呼び出すことができます。

  10. [作成] をクリックしてイメージを Cloud Run for Anthos にデプロイし、デプロイの完了を待ちます。

これで、Cloud Run for Anthos を有効にしたクラスタにサービスがデプロイされました。

デプロイしたサービスにアクセスする

サービスが稼働中になったので、そのサービスにリクエストを送信できます。このセクションでは、cURL を使用してサービスにアクセスし、サービスが稼働していることを確認します。

  1. Google Cloud コンソールで、Cloud Run for Anthos のページに移動します。

    Cloud Run for Anthos に移動

  2. 新しい Cloud Run for Anthos サービスの名前をクリックして、[サービスの詳細] ページに移動します。

  3. サービスの URL の右にある [情報] をクリックします。

  4. [Cloud Shell で呼び出す] をクリックして、サービス用に生成された cURL コマンドを Cloud Shell で実行します。

cURL リクエストにより、サービスが実行されているサンプル コンテナのソースコードが返されます。これで、サービスがリクエストを処理していることを確認しました。

クリーンアップ

リソースの実行料金が発生しないように、Cloud Run for Anthos を無効にするか、クラスタと Cloud Run for Anthos サービスを削除します。

Cloud Run for Anthos を無効にする

Cloud Run for Anthos を無効にしてクラスタを維持するには:

  1. Google Cloud コンソールで、Google Kubernetes Engine ページ に移動します。

    Google Kubernetes Engine に移動

  2. Cloud Run for Anthos を無効にするクラスタをクリックします。

  3. [編集] をクリックします。

  4. [Anthos の機能] まで下にスクロールし、[Cloud Run for Anthos] プルダウンで [無効] を選択します。

  5. [保存] をクリックします。

Cloud Run for Anthos を削除する

GKE クラスタ(Cloud Run for Anthos サービスとそのすべてのリソースを含む)を完全に削除するには:

  1. Google Cloud コンソールで、Google Kubernetes Engine ページ に移動します。

    Google Kubernetes Engine に移動

  2. 削除するクラスタを選択します。

  3. [削除] をクリックし、ポップアップで [削除] をクリックします。

次のステップ

コードソースからコンテナをビルドし、Container Registry に push してデプロイする。以下をご覧ください。

Cloud Run for Anthos のアーキテクチャの概要で、Google Kubernetes Engine クラスタのアドオンとして Cloud Run for Anthos を使用する場合の変更点を確認する。以下をご覧ください。